LogoLogo
ProductResourcesGitHubStart free
  • Documentation
  • Learn
  • ZenML Pro
  • Stacks
  • API Reference
  • SDK Reference
  • Getting Started
    • Welcome to ZenML
    • Installation
    • Hello World
    • Core Concepts
    • System Architecture
  • Deploying ZenML
    • Deploy
      • Deploy with Docker
      • Deploy with Helm
      • Deploy using HuggingFace Spaces
      • Deploy with custom images
      • Secret management
      • Custom secret stores
    • Connect
      • with your User (interactive)
      • with an API Token
      • with a Service Account
    • Manage
      • Best practices for upgrading
      • Using ZenML server in production
      • Troubleshoot your ZenML server
      • Migration guide
        • Migration guide 0.13.2 → 0.20.0
        • Migration guide 0.23.0 → 0.30.0
        • Migration guide 0.39.1 → 0.41.0
        • Migration guide 0.58.2 → 0.60.0
  • Concepts
    • Steps & Pipelines
      • Configuration
      • Scheduling
      • Logging
      • Advanced Features
      • YAML Configuration
    • Artifacts
      • Materializers
      • Visualizations
    • Stack & Components
    • Service Connectors
    • Containerization
    • Code Repositories
    • Secrets
    • Tags
    • Metadata
    • Models
    • Templates
    • Dashboard
  • Reference
    • Community & content
    • Environment Variables
    • llms.txt
    • FAQ
    • Global settings
    • Legacy docs
Powered by GitBook
On this page
  • Release Type Examples
  • Major Migration Guides
  • Release Notes

Was this helpful?

Edit on GitHub
  1. Deploying ZenML
  2. Manage

Migration guide

How to migrate your ZenML code to the newest version.

PreviousTroubleshoot your ZenML serverNextMigration guide 0.13.2 → 0.20.0

Last updated 1 month ago

Was this helpful?

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.

  • Migration guide 0.13.2 → 0.20.0

Release Notes

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

Migration guide 0.23.0 → 0.30.0
Migration guide 0.39.1 → 0.41.0
Migration guide 0.58.2 → 0.60.0
ZenML Release Notes
ZenML Scarf