Inspect the history of a cluster and machine deployment or update

Available since 2.22.0

Using the ClusterDeploymentStatus, ClusterUpgradeStatus, MachineDeploymentStatus, and MachineUpgradeStatus objects, you can inspect historical data of cluster and machine deployment or update stages, their time stamps, statuses, and failure messages, if any.

Caution

The order of cluster and machine update stages may not always be sorted by a time stamp but have an approximate logical order due to several components running simultaneously.

View the history using the web UI

  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 on top of the main left-side navigation panel.

  3. In the Clusters tab, click the More action icon in the last column of the required cluster area and select History to display details of the ClusterDeploymentStatus or ClusterUpgradeStatus object, if any.

  4. In the window that opens, click the required object to display the object stages, their time stamps, and statuses.

    Object names match the initial and/or target Cluster release versions and MKE versions of the cluster at a specific date and time. For example, 11.6.0+3.5.5 (initial version) or 11.5.0+3.5.5 -> 11.6.0+3.5.5.

    If any stage fails, hover over the Failure status field to display the failure message.

  5. Optional. Inspect the deployment and update status of the cluster machines:

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

    2. Click More action icon in the last column of the required machine area and select History.

View the history using the CLI

  1. Log in to a local machine where your management cluster kubeconfig is located and where kubectl is installed.

  2. Select from the following options:

    • Inspect the cluster or machine deployment history using the ClusterDeploymentStatus or MachineDeploymentStatus object:

      ./bin/kubectl --kubeconfig <pathToClusterKubeconfig> get clusterdeploymentstatus
      
      ./bin/kubectl --kubeconfig <pathToClusterKubeconfig> get machinedeploymentstatus
      
    • Inspect the cluster or machine update history using the ClusterUpgradeStatus and MachineUpgradeStatus objects:

      ./bin/kubectl --kubeconfig <pathToClusterKubeconfig> get clusterupgradestatus
      
      ./bin/kubectl --kubeconfig <pathToClusterKubeconfig> get machineupgradestatus
      

    Object names match the initial and/or target Cluster release versions and MKE versions of the cluster. For example, 11.5.0+3.5.5 (initial version) or 11.5.0+3.5.5 -> 11.6.0+3.5.5. Each object displays the update stages, their time stamps, and statuses. If any stage fails, the success field contains a failure message.