Skip to main content
Calico Cloud documentation

Connect a cluster to Calico Cloud

You can quickly connect a cluster to Calico Cloud by generating a unique kubectl or Helm command in the Calico Cloud Manager UI and running it on your cluster.

Prerequisites​

  • You have an active Calico Cloud account. You can sign up for a 14-day free trial at calicocloud.io.
  • You are signed in to the Calico Cloud Manager UI as a user with the Owner, Admin, or DevOps role.
  • You have at least one cluster that meets our system requirements.
  • You have kubectl access to the cluster.
  • If you're using Helm, you installed Helm 3.0 or later on your workstation.

Connect a cluster to Calico Cloud with kubectl​

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

  2. In the Connect a Cluster dialog, enter a Cluster Name and select a 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 to generate a unique kubectl command. Copy the command.

    Example of generated kubectl installation command
    kubectl apply -f https://installer.calicocloud.io/manifests/cc-operator/latest/deploy.yaml && curl -H "Authorization: Bearer mprcnz04t:9dav6eoag:s8w7xjslez1x1xkf6ds0h23miz5b1fw6phh9897d0n76e4pjfdekijowjv5lw9dd" "https://www.calicocloud.io/api/managed-cluster/deploy.yaml?version=v19.1.0" | kubectl apply -f -

  5. From a terminal, paste and run the command.

  6. On the Managed Clusters page, you should immediately see your cluster in the list of managed clusters. Monitor the status under Connection Status. When the status changes to Connected, installation is complete and your cluster is connected to Calico Cloud.

Connect a cluster to Calico Cloud with Helm​

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

  2. In the Connect a Cluster dialog, enter a Cluster Name and select a 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 to generate a unique Helm installation command. Copy the command.

    Example of generated Helm installation command
    helm repo add calico-cloud https://installer.calicocloud.io/charts --force-update && helm upgrade --install calico-cloud-crds calico-cloud/calico-cloud-crds --namespace calico-cloud --create-namespace && helm upgrade --install calico-cloud calico-cloud/calico-cloud --namespace calico-cloud --set apiKey=ryl34elz8:9dav6eoag:ifk1uwruwlgp7vzn7ecijt5zjbf5p9p1il1ag8877ylwjo4muu19wzg2g8x5qa7x --set installer.clusterName=my-cluster --set installer.calicoCloudVersion=v19.1.0

  5. Optional: To make changes to what features are enabled during installation, paste the command to a text editor and append the --set option any of the following key-value pairs. You can change these options only by reinstalling or upgrading Calico Cloud and changing the values.

    FeatureKeyValues
    Image Assuranceinstaller.components.imageAssurance.stateEnabled (default), Disabled
    Container Threat Detectioninstaller.components.runtimeSecurity.stateEnabled, Disabled (default*)
    * The default for new clusters is Disabled. For upgrades for previously connected clusters, the default will retain the previous state.
    Security Posture Dashboardinstaller.components.securityPosture.stateEnabled (default), Disabled
    Packet Captureinstaller.components.packetCaptureAPI.stateEnabled, Disabled (default*)
    * The default for new clusters is Disabled. For upgrades for previously connected clusters, the default will retain the previous state.
    Compliance Reportsinstaller.components.compliance.enabledtrue (default), false
    Example of generated Helm command with user-added parameters
    helm repo add calico-cloud https://installer.calicocloud.io/charts --force-update && helm upgrade --install calico-cloud-crds calico-cloud/calico-cloud-crds --namespace calico-cloud --create-namespace && helm upgrade --install calico-cloud calico-cloud/calico-cloud --namespace calico-cloud --set apiKey=ryl34elz8:9dav6eoag:ifk1uwruwlgp7vzn7ecijt5zjbf5p9p1il1ag8877ylwjo4muu19wzg2g8x5qa7x --set installer.clusterName=my-cluster --set installer.calicoCloudVersion=v19.1.0 \
    --set installer.components.imageAssurance.state=Enabled \
    --set installer.components.runtimeSecurity.state=Enabled \
    --set installer.components.securityPosture.state=Enabled

    In this example, this command connects the cluster to Calico Cloud with Image Assurance, Runtime Security, and Security Posture Dashboard features enabled.

  6. From a terminal, paste and run the command.

  7. On the Managed Clusters page, you should immediately see your cluster in the list of managed clusters. Monitor the status under Connection Status. When the status changes to Connected, installation is complete and your cluster is connected to Calico Cloud.

Additional resources​