Skip to main content
Calico Cloud documentation

Troubleshooting checklist

Check Calico Cloud installation​

Installing Calico Cloud on your Kubernetes cluster is managed by the Calico Cloud operator. The Calico Cloud operator is deployed as a Deployment in the calico-cloud namespace, and records status in a custom resource named installer.

Check the installer status using the following command.

kubectl get installer default --namespace calico-cloud -o jsonpath --template '{.status}'

Sample output

{"clusterName":"my-new-cluster","state":"installing"}

After state is complete, Calico Cloud is properly installed.

Check logs for fatal errors​

Check that the Calico Cloud operator is running and that logs do not have any fatal errors.

kubectl logs -n calico-cloud deployment/calico-cloud-controller-manager
2022-04-04T14:34:32.472Z INFO controller-runtime.metrics metrics server is starting to listen {"addr": "127.0.0.1:8080"}
2022-04-04T14:34:32.472Z INFO setup starting manager
2022-04-04T14:34:32.472Z INFO setup config {"ccBaseURL": "https://www.dev.calicocloud.io/api", "debug": false, "leader-elect": true}
I0404 14:34:32.472586 1 leaderelection.go:243] attempting to acquire leader lease calico-cloud/c2ad41ce.calicocloud.io...
2022-04-04T14:34:32.472Z INFO controller-runtime.manager starting metrics server {"path": "/metrics"}
I0404 14:34:32.480870 1 leaderelection.go:253] successfully acquired lease calico-cloud/c2ad41ce.calicocloud.io
<...>

Check custom resources​

Verify that you have the installer custom resource, and that the values are appropriate for your environment.

kubectl get installers.operator.calicocloud.io --namespace calico-cloud -o yaml
apiVersion: v1
items:
- apiVersion: operator.calicocloud.io/v1
kind: Installer
metadata:
annotations:
kubectl.kubernetes.io/last-applied-configuration: |
{"apiVersion":"operator.calicocloud.io/v1","kind":"Installer","metadata":{"annotations":{},"name":"my-new-cluster","namespace":"calico-cloud"}}
creationTimestamp: '2022-04-04T14:34:29Z'
generation: 1
name: my-new-cluster
namespace: calico-cloud
resourceVersion: '1102'
uid: eb1d1cd0-f01f-47b2-81fe-8eee46dbe712
status:
clusterName: my-new-cluster
message: ''
resourceVersion: ''
state: installing
kind: List
metadata:
resourceVersion: ''
selfLink: ''

Send failed installation diagnostics to Calico Cloud support​

To upload diagnostics about a failed installation to Calico Cloud support, run the following command:

kubectl patch installer -n calico-cloud default --type merge -p='{"spec":{"uploadDiags":true}}'