Is your control plane ready for Crossplane v2?
Crossplane has released a new command-line interface (CLI) tool, `crossplane beta upgrade check`, designed to streamline the migration path for users transitioning their control planes from Crossplane v1.x to the recently launched Crossplane v2. This new utility is a crucial addition for platform engineers and developers looking to leverage the enhancements in Crossplane v2 while ensuring a smooth upgrade process.
The core purpose of the `upgrade check` command is to provide a comprehensive, read-only scan of a live Crossplane v1.x control plane. Historically, upgrading to a new major version of Crossplane involved a meticulous manual review of backward compatibility notes and an exhaustive search through compositions, packages, and resources within the cluster to identify potential breaking changes. This process was often tedious, prone to errors, and a significant barrier for many organizations considering the upgrade.
With the introduction of `crossplane beta upgrade check`, this complexity is largely mitigated. The command exhaustively scans the control plane for any v1 features that have been removed or altered in a breaking way in v2. It then generates a detailed report, pinpointing the exact resources responsible for any potential issues and providing clear instructions on how to rectify them. This proactive approach allows users to address compatibility concerns before initiating the upgrade, thereby preventing unexpected disruptions.
The developers behind Crossplane v2 prioritized backward compatibility, ensuring that the vast majority of v1.x control planes, including claims, composite resources (XRs), compositions, and cluster-scoped managed resources, will function without modification in v2. However, for the minority of users who might be utilizing deprecated or changed features, this tool offers invaluable guidance.
The `crossplane beta upgrade check` command is bundled with the v1.20 Crossplane CLI, specifically in the v1.20.9 patch release. Users are advised to install the latest v1.20 CLI and run this command against their cluster prior to attempting a v2 upgrade. This ensures that they have a definitive answer regarding their control plane's readiness and a clear roadmap for any necessary adjustments, ultimately fostering a more confident and efficient transition to Crossplane v2.
Read original source