Migrating Alauda DevOps to Alauda DevOps (Next-Gen)

This guide details the upgrade strategy and procedures for Alauda DevOps to Alauda DevOps (Next-Gen), Suitable for ACP upgrade scenarios:

  • v3.18 --> v4.0
  • v3.18 --> v4.1
  • v4.0 --> v4.1

TOC

Prerequisites

Upgrade Alauda DevOps to v3.20

Before migration, ensure that Alauda DevOps is upgraded to version v3.20. This step is required for compatibility and successful migration to Alauda DevOps (Next-Gen). Please refer to Upgrading Alauda DevOps to v3.20

Migrating Alauda DevOps

Starting from ACP v4.1, the following Alauda DevOps v3 operators will no longer be maintained. Therefore, migrating these operators is required.

OperatorStatus
Alauda DevOps Tekton v3End-of-life
Alauda DevOps GitLab v3End-of-life
Alauda DevOps Harbor v3End-of-life
Alauda DevOps SonarQube v3End-of-life
Alauda DevOps Nexus v3End-of-life

Download the Operator

  1. Download the following versions of the Operators separately or in bulk based on templates from the Alauda customer portal.
Alauda DevOps OperatorVersion
Alauda DevOps Pipelinesv4.0.z
Alauda Build of Gitlabv17.8.z
Alauda Build of Harborv2.12.z
Alauda Build of SonarQubev2025.1.z
Alauda Build of Nexusv3.76.z
INFO

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.

  1. Navigate to the CLI Tools section in the Alauda Customer Portal and download the violet tool to upload Operators toACP. For specific operation steps, refer to

Migrating Alauda DevOps

Please refer to the following documents for migrating each operator:

Next Steps

You have now completed the migration from Alauda DevOps to Alauda DevOps (Next-Gen). In Alauda DevOps (Next-Gen), if you want to use the updated version for each Operator, you can further learn how to upgrade to the updated version in each operator's documentation.

Warning

Important Restriction

If you need to continue using the Build and Release features from Alauda DevOps v3, you must maintain Alauda DevOps Pipelines at version v4.0.z.

Prohibited Actions

Do NOT upgrade Alauda DevOps Pipelines beyond v4.0.z under any circumstances. Upgrading to versions above v4.0.z will cause irreversible compatibility issues with katanomi, potentially breaking existing Build and Release pipelines.