Upgrading¶
Upgrading the database¶
Changes between Palladium versions may require upgrading the model
database or similar. These upgrades are handled automatically by the
pld-upgrade script. Before running the script, make sure you’ve
set the PALLADIUM_CONFIG environment variable, then simply run:
pld-upgrade
In some rare situations, it may be necessary to run the upgrade steps
of specific versions only. pld-upgrade supports passing
--from and --to options for that purpose. As an example, if
you only want to run the upgrade steps between version 0.9 and
1.0, this is how you’d invoke pld-upgrade:
pld-upgrade --from=0.9.1 --to=1.0
Upgrading the Database persister from version 0.9.1 to 1.0¶
Users of palladium.persistence.Database that are upgrading
from version 0.9.1 to a more recent version (e.g. 1.0) are required
to invoke pld-upgrade with an explicit --from version like so:
pld-upgrade --from=0.9.1
Backward incompatibilities in code¶
The development team makes an effort to try and keep the API backward compatibility, and only gradually deprecate old code where necessary. However, some changes between major Palladium versions still introduce backward incompatibilities and potentially require you to update your Palladium plug-ins.
Breaking changes between 0.9.1. and 1.0¶
Backward incompatible changes between 0.9.1. and 1.0 are of concern
only to users who have implemented their own version of
palladium.server.PredictService.
palladium.server.PredictService.sample_from_request() has been
replaced by the very similar
sample_from_data(). The new
method now accepts a data argument instead of request.
data is the equivalent of the former request.args. Similarly,
palladium.server.PredictService.params_from_request() has been
replaced by params_from_data().
The latter now also accepts data instead of request, which
again is the equivalent of the former request.data.