All 29 Multi-cluster questions
More in Multi-cluster
How does ArgoCD manage multiple clusters? Can one ArgoCD instance deploy to the cluster it runs in and remote clusters simultaneously? What is a management (hub) cluster in ArgoCD? How do you list registered clusters in ArgoCD? Do workloads keep running if the ArgoCD hub goes down? How do you remove a cluster from ArgoCD? What is the difference between the in-cluster and external cluster destinations? What are the architectural models for multi-cluster ArgoCD (hub-spoke vs per-cluster)? How are cluster credentials secured in ArgoCD? How do you target a subset of clusters (e.g., only production)?
Advertisement
ArgoCD › Multi-cluster

How do you add (register) an external cluster to ArgoCD?

Beginner

Answer

Use `argocd cluster add <context>` (which creates a service account and stores credentials as a cluster Secret), or declaratively create a cluster Secret with the API URL, credentials, and the argocd.argoproj.io/secret-type: cluster label. ArgoCD then lists it as a deployment destination.
kind: Secret
metadata:
  labels:
    argocd.argoproj.io/secret-type: cluster
stringData:
  server: https://remote-api
  config: '{"bearerToken":"...","tlsClientConfig":{...}}'
Real-world example A new prod cluster is registered by applying a labeled cluster Secret, after which apps can target it.

Common follow-ups: What does argocd cluster add create? | How is a cluster defined declaratively?

RBAC Applications Multi-cluster
All 29 Multi-cluster questions