Configure the parallel update of worker nodes

Available since MCC 2.25.0 (17.0.0 and 16.0.0) as GA Available since MCC 2.24.0 (14.0.1 and 15.0.1) as TechPreview

Note

You can start using the below procedure during cluster update from 23.1 to 23.2. For details, see Parallelizing node update operations.

By default, worker machines are upgraded sequentially, which includes node draining, software upgrade, services restart, and so on. Though, MOSK enables you to parallelize node upgrade operations, significantly improving the efficiency of your deployment, especially on large clusters.

For upgrade workflow of the control plane, see Change the upgrade order of a machine or machine pool.

Configure the parallel update of worker nodes using web UI

Available since MCC 2.25.0 (17.0.0 and 16.0.0)

  1. Log in to the Container Cloud web UI with the m:kaas:namespace@operator or m:kaas:namespace@writer permissions.

  2. Switch to the required project using the Switch Project action icon located on top of the main left-side navigation panel.

  3. In the Clusters tab, click the required cluster name. The cluster page with the Machines list opens.

  4. On the Clusters page, click the More action icon in the last column of the required cluster and select Configure cluster.

  5. In General Settings of the Configure cluster window, define the following parameters:

    Parallel Upgrade Of Worker Machines

    You can configure this option after deployment before the cluster update.

    Parallel Preparation For Upgrade Of Worker Machines

Configure the parallel update of worker nodes using CLI

Available since MCC 2.24.0 (15.0.1 and 14.0.1)

  1. Open the Cluster object for editing.

  2. Adjust the following parameters as required:

    Configuration of the parallel node update

    Parameter

    Default

    Description

    spec.providerSpec.maxWorkerUpgradeCount

    1

    The maximum number of the worker nodes to update simultaneously. It serves as an upper limit on the number of machines that are drained at a given moment of time.

    Caution

    Since Container Cloud 2.27.0 (Cluster releases 17.2.0 and 16.2.0), maxWorkerUpgradeCount is deprecated and will be removed in one of the following releases. Use the concurrentUpdates parameter in the UpdateGroup object instead. For details, see Create update groups for worker machines.

    spec.providerSpec.maxWorkerPrepareCount

    50

    The maximum number of workers being prepared at a given moment of time, which includes downloading of new artifacts. It serves as a limit for the network load that can occur when downloading the files to the nodes.

  3. Save the Cluster object to apply the change.