Cluster states
You can view the current cluster state by running the ibmcloud ks cluster ls
command and locating the State field.
Aborted
Review the following description of the Aborted
cluster state. To view the state of your cluster, run ibmcloud ks cluster get --cluster <cluster_name_or_ID>
.
You sent a delete request before the Kubernetes master deployment completed. After your cluster is deleted, it is removed from your dashboard. If your cluster is stuck in this state for a long time, open an IBM Cloud support case.
Critical
Review the following description of the Critical
cluster state. To view the state of your cluster, run ibmcloud ks cluster get --cluster <cluster_name_or_ID>
.
The Kubernetes master can't be reached or all worker nodes in the cluster are down. If you enabled IBM Key Protect in your cluster, the Key Protect container might fail to encrypt or decrypt your cluster secrets. If so, you can view an error
with more information when you run kubectl get secrets
.
Create failed
Review the following description of the Create failed
cluster state. To view the state of your cluster, run ibmcloud ks cluster get --cluster <cluster_name_or_ID>
.
The cluster cannot be created. Delete the failed cluster and try to create another one. If the issue persists when creating additional clusters, open an IBM Cloud support case.
Delete failed
Review the following description of the Delete failed
cluster state. To view the state of your cluster, run ibmcloud ks cluster get --cluster <cluster_name_or_ID>
.
The Kubernetes master or at least one worker node can't be deleted. List worker nodes by running ibmcloud ks worker ls --cluster <cluster_name_or_ID>
. If worker nodes are listed, see Unable to create or delete worker nodes.
If no workers are listed, open an IBM Cloud support case.
Deleted
Review the following description of the Deleted
cluster state. To view the state of your cluster, run ibmcloud ks cluster get --cluster <cluster_name_or_ID>
.
The cluster is deleted but not yet removed from your dashboard. If your cluster is stuck in this state for a long time, open an IBM Cloud support case.
Deleting
Review the following description of the Deleting
cluster state. To view the state of your cluster, run ibmcloud ks cluster get --cluster <cluster_name_or_ID>
.
The cluster is being deleted and cluster infrastructure is being dismantled. You can't access the cluster.
Deploy failed
Review the following description of the Deploy failed
cluster state. To view the state of your cluster, run ibmcloud ks cluster get --cluster <cluster_name_or_ID>
.
The deployment of the Kubernetes master can't be completed. You can't resolve this state. Contact IBM Cloud support by opening an IBM Cloud support case.
Deploying
Review the following description of the Deploying
cluster state. To view the state of your cluster, run ibmcloud ks cluster get --cluster <cluster_name_or_ID>
.
The Kubernetes master is not fully deployed yet. You can't access your cluster. Wait until your cluster is fully deployed to review the health of your cluster.
Normal
Review the following description of the Normal
cluster state. To view the state of your cluster, run ibmcloud ks cluster get --cluster <cluster_name_or_ID>
.
All worker nodes in a cluster are up and running. You can access the cluster and deploy apps to the cluster. This state is considered healthy and does not require an action from you.
Although the worker nodes might be normal, other infrastructure resources, such as networking and storage, might still need attention. If you just created the cluster, some parts of the cluster that are used by other services such as Ingress secrets or registry image pull secrets, might still be in process.
Pending
Review the following description of the Pending
cluster state. To view the state of your cluster, run ibmcloud ks cluster get --cluster <cluster_name_or_ID>
.
The Kubernetes master is deployed. The worker nodes are provisioning and aren't available in the cluster yet. You can access the cluster, but you can't deploy apps to the cluster.
Requested
Review the following description of the Requested
cluster state. To view the state of your cluster, run ibmcloud ks cluster get --cluster <cluster_name_or_ID>
.
A request to create the cluster and order the infrastructure for the Kubernetes master and worker nodes is sent. When the deployment of the cluster starts, the cluster state changes to Deploying
. If your cluster is stuck in the
Requested
state for a long time, open an IBM Cloud support case.
Updating
Review the following description of the Updating
cluster state. To view the state of your cluster, run ibmcloud ks cluster get --cluster <cluster_name_or_ID>
.
The Kubernetes API server that runs in your Kubernetes master is being updated to a new Kubernetes API version. During the update, you can still access and change the cluster. However, you cannot initiate concurrent master operations, such as enabling API server auditing. Worker nodes, apps, and resources that the user deployed aren't modified and continue to run. Wait for the update to complete to review the health of your cluster.
Unsupported
Review the following description of the Unsupported
cluster state. To view the state of your cluster, run ibmcloud ks cluster get --cluster <cluster_name_or_ID>
.
The Kubernetes version that the cluster runs is no longer supported. Your cluster's health is no longer actively monitored or reported. Additionally, you can't add or reload worker nodes. To continue receiving important security updates and support, you must update your cluster. Review the version update preparation actions, then update your cluster to a supported Kubernetes version.
Warning
Review the following description of the Warning
cluster state. To view the state of your cluster, run ibmcloud ks cluster get --cluster <cluster_name_or_ID>
.
At least one worker node in the cluster is not available, but other worker nodes are available and can take over the workload. Try to reload the unavailable
worker nodes. - Your cluster has zero worker nodes, such as if you created a cluster without any worker nodes or manually removed all the worker nodes from the cluster. Resize your worker pool to add worker nodes to recover from a Warning
state, and then update the Calico node entries for your worker nodes. - A control plane operation for your cluster failed. View the cluster in the console or run ibmcloud ks cluster get --cluster <cluster_name_or_ID>
to check the Master Status for further debugging.