Upgrading Alauda DevOps to Alauda DevOps (Next-Gen)
This guide details the upgrade strategy and procedures for Alauda DevOps to Alauda DevOps (Next-Gen) when upgrading from Alauda Container Platform v3.18 to v4.0 or v4.1.
TOC
Version Compatibility Matrix
The following table shows the version requirements for Alauda DevOps Operators when upgrading from ACP v3 to v4.
| Alauda DevOps Operator | Version |
|---|---|
| Alauda DevOps v3 | v3.20.z |
| Alauda DevOps Eventing v3 | v3.20.z |
| Alauda DevOps Jenkins v3 | v3.20.z |
| Alauda DevOps Pipelines | v4.0.z |
| Alauda Build of Gitlab | v17.8.z |
| Alauda Build of Harbor | v2.12.z |
| Alauda Build of SonarQube | v2025.1.z |
| Alauda Build of Nexus | v3.76.z |
The .z in version numbers indicates the latest available patch version for that minor release. During upgrade, you should always use the latest patch version to benefit from the most recent security updates and bug fixes.
Special Note: In the scenario where ACP v3.18 is upgraded to v4.0 or v4.1, Alauda DevOps Pipelines only supports version v4.0.
Prerequisites
Upgrade ACP Platform
First, upgrade the ACP platform to version v4. For detailed instructions, refer to .
Prepare Extension Packages
After completing the ACP platform upgrade, you need to separately prepare the Alauda DevOps Operators and upload them. For specific operation steps, refer to .
When downloading the DevOps extension package, you can download it in batches or individually based on the Alauda DevOps V3 Upgrade template in the Customer Portal. The relevant version of the corresponding operator needs to be consistent with the version of Version Compatibility Matrix.
Upgrading Alauda DevOps
Upgrade Operators via Migration
After completing the prerequisites, upgrade the following Operators as documented:
- Migrating Alauda DevOps Pipelines
- Migrating Alauda Build of Gitlab
- Migrating Alauda Build of Harbor
- Migrating Alauda Build of SonarQube
- Migrating Alauda Build of Nexus
Upgrading Operators via UI
For Alauda DevOps v3, Alauda DevOps Eventing v3, and Alauda DevOps Jenkins v3, complete the upgrade through the UI after the ACP upgrade:
Navigate to Administrator -> Marketplace -> Operator Hub, switch to the target cluster and enter the corresponding Operator details page. Click the instance name you want to upgrade to enter the instance details page, then follow the instructions to complete the upgrade.
Next Steps
You have now completed the upgrade of Alauda DevOps in the ACP v3 to v4 upgrade scenario. However, the Operators upgraded via Upgrade via Migration may not be the latest available versions. You can contact technical support to obtain the latest Operators and continue upgrading to the latest version using the Upgrading Instances via UI method.