All Products
Search
Document Center

Container Service for Kubernetes:Unified add-on management for multi-cluster fleets

Last Updated:Mar 26, 2026

Container Service for Kubernetes (ACK) only supports single-cluster component management, which requires you to manually maintain component versions in each cluster. Distributed Cloud Container Platform for Kubernetes (ACK One) Fleet lets cluster administrators define a component baseline — a versioned set of add-ons — and deploy it consistently across multiple clusters. You get unified version control, automated batch deployment, and one-click rollback, without manually updating each cluster.

With ACK One Fleet multi-cluster add-on management, you can:

  • Define a single baseline that pins each add-on to a specific version

  • Deploy the baseline to all target clusters in one operation, in batches or all at once

  • Roll back a deployment if a component update causes issues

Prerequisites

Before you begin, ensure that you have:

Create a component baseline

A baseline defines which add-ons and versions to enforce across clusters. Create one before scheduling any deployments.

  1. Log on to the ACK One console. In the left navigation pane, choose Fleet > Multi-cluster Add-ons.

  2. Click the Add-on Baselines tab, then click Create Add-on Baseline.

  3. Complete the following parameters, then click OK.

    Parameter Description Modifiable after creation
    Cluster Type Select based on the cluster types associated with your Fleet instance. Different cluster types may require different add-ons. <img>
    Baseline Name A name for this baseline. <img>
    Add-on Tags Select add-ons and their versions based on the component types. <img>
  4. On the Add-on Baselines page, click the baseline name to view the deployment status of each add-on across all clusters in the Fleet.

    Note

    When a baseline is deployed to a cluster, all add-ons will be installed with the baseline version, except for add-ons that already have higher versions installed.

Create a deployment task

A deployment task applies a baseline to one or more clusters. Use batched deployment to validate changes in a test environment before rolling out to production.

  1. Log on to the ACK One console. In the left navigation pane, choose Fleet > Multi-cluster Add-ons.

  2. Click the Deployment Tasks tab, then click Create Deployment Task.

  3. Complete the following parameters.

    Warning

    If you select clusters or modify the number of batches, the selected deployment clusters below will be cleared. Proceed with caution.

    Parameter Description
    Select Baseline Choose a baseline from your created baselines.
    Select Cluster Choose the clusters to deploy the baseline to.
    Deployment Settings Choose how to sequence the deployment across clusters:
    Non-batched: Deploys clusters one by one, from smallest to largest.
    Custom Batch > Batches: Groups clusters into batches you define — for example, deploy to test clusters first, then to production clusters in a second batch.




    Auto Execute If disabled, manually click Start in the Deployment Details panel after the task is created. If enabled, configure Batch Interval and the task starts automatically after creation.
    Select batch 1 for deployment Assign clusters to the first deployment batch.
  4. Click Next to review the deployment details. Customize per-cluster component parameters if needed, then click Confirm.

View deployment results and roll back

  1. Log on to the ACK One console. In the left navigation pane, choose Fleet > Multi-cluster Add-ons.

  2. Click the Deployment Tasks tab, find the task, and click Details in the Actions column.

  3. (Optional) If the deployed add-ons do not meet your expectations, click Roll Back, then click Confirm Rollback.