Skip to main content

Connect a cluster to Calico Cloud

Before you begin

Connecting to Calico Cloud is easy, and is done in Manager UI, Managed Clusters using an installation wizard.

Although not required, it may save you troubleshooting if you verify your cluster meets system requirements.

Install options

Calico Cloud provides the following install options. Note that after initial installation, you cannot reinstall the cluster with a different option.

  • Default (kubectl)
  • Private image registry using Helm charts
  • Helm charts

Choose your install option and follow the steps.

Default

Required: kubectl access to the cluster

  1. On the Managed Clusters page, click Connect Cluster.
  2. Add the Cluster Name, and select the Cluster Type.
  3. (Optional) If you must install a specific older release, select the Calico Cloud version you want to install. We always recommend the latest version, which is installed by default.
  4. Click Connect and follow the wizard.
  5. Monitor the progress on the Managed Clusters page.

Private registry

Required:

  • Helm v3

  • Before you start the installation wizard, add Calico Cloud images to a private registry. You'll need the following values in the installation wizard:

    • Registry Secret Name

      note

      If your private registry requires credentials, create the calico-cloud namespace on your cluster. Then, create an image pull secret and use this name for the Registry Secret Name.

    • Image Registry

    • Image Path

  1. On the Managed Clusters page, click Connect Cluster.

  2. Add the Cluster Name, and select the Cluster Type.

  3. (Optional) If you must install a specific older release, select the Calico Cloud version you want to install. We always recommend the latest version, which is installed by default.

  4. Click Advanced Options, and select both Install via helm and Install private registry. (Private registry supports only Helm).

    private-registry

  5. Complete the fields, ensuring that your inputs match the values used when setting up your private registry.

  6. Click Connect and follow the wizard.

  7. Monitor the progress on the Managed Clusters page.

Helm

Required: Helm v3

  1. On the Managed Clusters page, click Connect Cluster.

  2. Add the Cluster Name, and select the Cluster Type.

  3. Select the version of Calico Cloud you want to install

  4. Click Advanced Options, and select Install via helm.

    helm

  5. Click Connect and follow the wizard.

  6. Monitor the progress on the Managed Clusters page.

Need help?

See Troubleshooting checklist and Tigera operator troubleshooting checklist.