Help Center> Cloud Container Engine> User Guide> User Guide for Standard and Turbo Clusters> Node Pools> Managing a Node Pool> Upgrading an OS
Updated on 2024-05-09 GMT+08:00
View PDF

Upgrading an OS

When CCE releases a new OS image, existing nodes cannot be automatically upgraded. You can manually upgrade them in batches.

This section describes how to upgrade an OS by resetting the target node. Workloads running on a node may be interrupted due to standalone deployment or insufficient schedulable resources. Evaluate the upgrade risks and perform the upgrade during off-peak hours. Alternatively, specify a disruption budget for your key applications to ensure the availability of these applications during the upgrade.

Constraints

  • Nodes running private images cannot be upgraded.
  • Compatibility issues may occur when the node OS of an early version is upgraded. In this case, manually reset the node for the OS upgrade.

Procedure for Default Node Pools

  1. Log in to the CCE console.
  2. Click the cluster name to access the cluster console. Choose Nodes in the navigation pane and click the Node Pools tab on the right.
  3. Click Upgrade next to the default node pool.
  4. In the displayed Operating System Upgrade window, configure parameters.

    • Target Operating System: shows the image of the target version. You do not need to configure this parameter.
    • Upgrade Policy: Node Reset is supported.
    • Max. Nodes for Batch Upgrade: maximum number of nodes that will be unavailable during node upgrade. Nodes will be unavailable during synchronization by resetting the nodes. Properly configure this parameter to prevent pod scheduling failures caused by too many unavailable nodes in the cluster.
    • View Node: Select the nodes to be upgraded.
    • Login Mode:
      • Password

        The default username is root. Enter the password for logging in to the node and confirm the password.

        Be sure to remember the password as you will need it when you log in to the node.

      • Key Pair

        Select the key pair used to log in to the node. You can select a shared key.

        A key pair is used for identity authentication when you remotely log in to a node. If no key pair is available, click Create Key Pair. For details about how to create a key pair, see Creating a Key Pair.

    • Pre-installation script:

      Pre-installation script command, in which Chinese characters are not allowed. The script command will be Base64-transcoded.

      The script will be executed before Kubernetes software is installed. Note that if the script is incorrect, Kubernetes software may fail to be installed.

    • Post-installation script:

      Pre-installation script command, in which Chinese characters are not allowed. The script command will be Base64-transcoded.

      The script will be executed after Kubernetes software is installed, which does not affect the installation.

  5. Click OK.

Procedure for Non-default Node Pools

  1. Log in to the CCE console.
  2. Click the cluster name to access the cluster console. Choose Nodes in the navigation pane and click the Node Pools tab on the right.
  3. Choose More > Synchronize in the Operation column of the target node pool.
  4. In the Batch synchronization window, configure parameters.

    • OS: shows the image of the target version. You do not need to configure this parameter.
    • Synchronization Policy: Node Reset is supported.
    • Max. Nodes for Batch Synchronize: maximum number of nodes that will be unavailable during node synchronization. Nodes will be unavailable during synchronization by resetting the nodes. Properly configure this parameter to prevent pod scheduling failures caused by too many unavailable nodes in the cluster.
    • Node List: Select the nodes requiring the synchronization of node pool configurations.

  5. Click OK.
Parent topic: Managing a Node Pool