Skip to main content
ArgoCD simplifies managing multi-cluster deployments by allowing you to deploy applications either within its own cluster or across external clusters. In this guide, we’ll walk you through configuring an external Kubernetes cluster and deploying applications across clusters using ArgoCD.

​
Overview

Before deploying applications to multiple clusters, you need to have an external Kubernetes cluster. ArgoCD integrates external clusters by reading their credential details from the kubeconfig file. This allows ArgoCD to manage deployments outside its own cluster.

​
Configuring the External Cluster

Begin by updating your kubeconfig file to register your external cluster. Use the following commands to set the cluster and credential configurations:
After defining the external cluster in your kubeconfig, add it to ArgoCD by referencing the appropriate context name:
This command creates a service account on the external cluster with full cluster-level administrator access. Ensure you understand the security implications before proceeding.
Once you confirm, ArgoCD automatically creates the necessary service account, cluster role, and cluster role binding, thus validating the external cluster as a deployment target.

​
Detailed Example

Below is a comprehensive example that illustrates all the essential steps to add an external cluster:
You can verify the list of clusters available for deployment by executing the argocd cluster list command. Note that credentials for external clusters (or API servers) are securely stored as secrets within the ArgoCD namespace. For further information on configuring multi-cluster deployments and additional ArgoCD commands, please refer to the ArgoCD Documentation. Happy deploying!

Watch Video