Enable maintenance mode on a cluster and machine using web UI

You can use the instructions below for any type of Container Cloud clusters. To enable maintenance mode using the Container Cloud CLI, refer to Enable maintenance mode on a cluster and machine using CLI.

Caution

  • To enable maintenance mode on a machine, first enable maintenance mode on the related cluster.

  • To disable maintenance mode on a cluster, first disable maintenance mode on all machines of the cluster.

Warning

During cluster and machine maintenance:

  • Cluster upgrades and configuration changes (except of the SSH keys setting) are unavailable. Make sure you disable maintenance mode on the cluster after maintenance is complete.

  • Data load balancing is disabled while Ceph is in maintenance mode.

  • Workloads are not affected.

Enable maintenance mode on a cluster and machine

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

  2. Enable maintenance mode on the cluster:

    1. In the Clusters tab, click the More action icon in the last column of the cluster you want to put into maintenance mode and select Enter maintenance. Confirm your selection.

    2. Wait until the Status of the cluster switches to Maintenance.

    Now, you can switch cluster machines to maintenance mode.

  3. In the Clusters tab, click the required cluster name to open the list of machines running on it.

  4. Select from the following options:

    • Before Container Cloud 2.18.0, click the More action icon in the last column of the machine you want to put into maintenance mode and select Start maintenance.

    • Starting Container Cloud 2.18.0, in the Maintenance column of the machine you want to put into maintenance mode, enable the toggle switch.

  5. Wait until the machine Status switches to Maintenance.

    Once done, the node of the selected machine is cordoned, drained, and prepared for maintenance operations.

    Important

    Proceed with the node maintenance only after the machine Status switches to Maintenance.

Disable maintenance mode on a cluster and machine

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

  2. In the Clusters tab, click the required cluster name to open its machines list.

  3. Select from the following options:

    • Before Container Cloud 2.18.0, click the More action icon in the last column of the machine where you want to disable maintenance mode and select Stop maintenance.

    • Starting Container Cloud 2.18.0, in the Maintenance column of the machine you want to disable maintenance mode, disable the toggle switch.

  4. Wait until the machine Status does not display Maintenance, Pending maintenance, or the progress indicator.

  5. Repeat the above steps for all machines that are in maintenance mode.

  6. Disable maintenance mode on the related cluster:

    1. In the Clusters tab, click the More action icon in the last column of the cluster where you want to disable maintenance mode and select Exit maintenance.

    2. Wait until the cluster Status does not display Maintenance, Pending maintenance, or the progress indicator.