Troubleshoot a Workload Cluster Stuck in Provisioned
Use this guide when a workload cluster on Alauda OS has reached Cluster.status.phase = Provisioned and its control plane reports ready, but its nodes stay NotReady because the CNI is not deployed. It applies to every provider.
On Huawei Cloud Stack, if the KubeadmControlPlane does not become ready and a pool hostname contains a dot, this page does not apply; see Creation Stages.
TOC
SymptomsDiagnostic StepsStep 1 — Check the Cluster API ObjectsStep 2 — Check the Machine ConditionsStep 3 — Check the Provider LogsStep 4 — Check the Import of the ClusterSee AlsoSymptoms
Diagnostic Steps
In the commands, <namespace> is the namespace of the cluster objects; for a cluster created with ac, it is cpaas-system.
Step 1 — Check the Cluster API Objects
Step 2 — Check the Machine Conditions
Continue with Step 3 when a machine shows phase=Running with NodeHealthy=False; otherwise, this page does not apply.
Step 3 — Check the Provider Logs
Continue with Step 4 when the logs repeat ServiceAccount "sentry" not found. Otherwise, this page does not apply; on Huawei Cloud Stack, see Kube-OVN Is Not Installed.
Step 4 — Check the Import of the Cluster
Run each check. A healthy cluster passes all four.
-
The platform cluster record exists:
Expected: the record is listed, not
NotFound. -
The Cluster API
Clustercarries thecapi.cpaas.io/importedlabel:Expected:
present (value=""). -
Exactly one
ClusterCredentialis labelled for the cluster:Expected: one line.
-
The
sentryServiceAccount exists in the workload cluster:Expected: the ServiceAccount is listed.
If
ac config use-cluster <cluster-name>fails, read the ServiceAccount with the admin kubeconfig of the cluster instead. Keep the file private (chmod 600 <cluster-name>.kubeconfig); it holds administrator credentials of the cluster.
Do not delete and recreate the cluster on your own: deleting it deletes its virtual machines on the IaaS platform. Restarting the cluster-transformer Pod on the global cluster does not import the cluster again.