Help improve this page
To contribute to this user guide, choose the Edit this page on GitHub link that is located in the right pane of every page.
Working with Argo CD
With Argo CD, you define applications in Git repositories and Argo CD automatically syncs them to your Kubernetes clusters. This enables declarative, version-controlled application deployment with automated drift detection.
Prerequisites
Before working with Argo CD, you need:
-
An EKS cluster with the Argo CD capability created (see Create an Argo CD capability)
-
A Git repository containing Kubernetes manifests
-
kubectlconfigured to communicate with your cluster
Common tasks
The following topics guide you through common Argo CD tasks:
Configure repository access - Configure Argo CD to access your Git repositories using AWS Secrets Manager, AWS CodeConnections, or Kubernetes Secrets.
Register target clusters - Register target clusters where Argo CD will deploy applications.
Working with Argo CD Projects - Organize applications and enforce security boundaries using Projects for multi-tenant environments.
Create Applications - Create Applications that deploy from Git repositories with automated or manual sync policies.
Use ApplicationSets - Use ApplicationSets to deploy applications across multiple environments or clusters using templates and generators.
Access the Argo CD UI
Access the Argo CD UI through the EKS console:
-
Open the Amazon EKS console
-
Select your cluster
-
Choose the Capabilities tab
-
Choose Argo CD
-
Choose Open Argo CD UI
The UI provides visual application topology, sync status and history, resource health and events, manual sync controls, and application management.
Upstream documentation
For detailed information about Argo CD features:
-
Argo CD Documentation
- Complete user guide -
Application Spec
- Full Application API reference -
ApplicationSet Guide
- ApplicationSet patterns and examples -
Argo CD GitHub
- Source code and examples