Skip to main content

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}}'