♻️Migration guide

How to migrate your ZenML code to the newest version.

Migrations are necessary for ZenML releases that include breaking changes, which are currently all releases that increment the minor version of the release, e.g., 0.X -> 0.Y. Furthermore, all releases that increment the first non-zero digit of the version contain major breaking changes or paradigm shifts that are explained in separate migration guides below.

Release Type Examples

  • 0.40.2 to 0.40.3 contains no breaking changes and requires no migration whatsoever,

  • 0.40.3 to 0.41.0 contains minor breaking changes that need to be taken into account when upgrading ZenML,

  • 0.39.1 to 0.40.0 contains major breaking changes that introduce major shifts in how ZenML code is written or used.

Major Migration Guides

The following guides contain detailed instructions on how to migrate between ZenML versions that introduced major breaking changes or paradigm shifts. The migration guides are sequential, meaning if there is more than one migration guide between your current version and the latest release, follow each guide in order.

Release Notes

For releases with minor breaking changes, e.g., 0.40.3 to 0.41.0, check out the official ZenML Release Notes to see which breaking changes were introduced.

Last updated