> ## Documentation Index
> Fetch the complete documentation index at: https://notes.kodekloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ArgoCD Basics

> Introduction to ArgoCD GitOps continuous delivery for Kubernetes, explaining reconciliation, sync policies, supported tools, and enterprise features.

Let's briefly introduce ArgoCD and its core concepts for Kubernetes GitOps workflows.

## What is ArgoCD?

ArgoCD is a declarative, GitOps continuous delivery tool for Kubernetes. It treats Git repositories as the single source of truth for application manifests and continuously ensures the cluster's live state matches the desired state stored in those repositories.

ArgoCD continuously:

* Monitors running applications
* Compares the cluster's live state with the desired state defined in Git
* Reports drift and differences
* Exposes visualizations and workflows for manual or automated synchronization

## Why use ArgoCD?

* Declarative Git-based management: Store cluster and application manifests in Git; ArgoCD reads and enforces them.
* Continuous operations: Detects drift, provides analytics, and enables remediation via manual or automated syncs.
* Enterprise readiness: Built-in audit trails, RBAC, SSO integration, and compliance features for production environments.

<Frame>
  <img src="https://mintcdn.com/kodekloud-c4ac6d9a/v7HW2PPNQOGxY8Ve/images/Prep-Course-Certified-Argo-Project-Associate-CAPA/ArgoCD/ArgoCD-Basics/argocd-octopus-declarative-git-continuous-enterprise.jpg?fit=max&auto=format&n=v7HW2PPNQOGxY8Ve&q=85&s=83649517c2d60c80d41091efab205508" alt="A presentation slide titled &#x22;Why Use ArgoCD?&#x22; showing a cartoon octopus mascot and three key points: declarative Git-based management, continuous operations with monitoring/remediation, and enterprise-ready features like security, RBAC, and SSO." width="1920" height="1080" data-path="images/Prep-Course-Certified-Argo-Project-Associate-CAPA/ArgoCD/ArgoCD-Basics/argocd-octopus-declarative-git-continuous-enterprise.jpg" />
</Frame>

## How ArgoCD works

ArgoCD operates with a clear GitOps reconciliation loop and supports multiple manifest formats and tools.

* Source of truth\
  Git repositories contain application manifests (YAML/JSON, Helm charts, Kustomize overlays, Jsonnet, etc.). ArgoCD treats these repositories as the authoritative desired state.

* Continuous reconciliation\
  ArgoCD continuously compares the desired state stored in Git against the cluster's live state and highlights any differences (drift).

* Synchronization\
  When drift is detected—or on demand—ArgoCD applies manifests to bring the live state back to the desired state. Sync strategies can be manual, automated, or follow custom policies (hooks, sync waves, retry/backoff).

* Tooling support\
  ArgoCD natively supports multiple templating and configuration tools:

| Tool / Format   | Use Case                                          | Reference                                                           |
| --------------- | ------------------------------------------------- | ------------------------------------------------------------------- |
| Kustomize       | Manage overlays and environment-specific patches  | [Kustomize](https://learn.kodekloud.com/user/courses/kustomize)     |
| Helm charts     | Template-driven package management for Kubernetes | [Helm](https://learn.kodekloud.com/user/courses/helm-for-beginners) |
| Jsonnet         | Programmatic, data-driven manifests               | [Jsonnet](https://jsonnet.org/)                                     |
| Plain YAML/JSON | Static manifests for simple workloads             | Kubernetes manifests                                                |

## Key ArgoCD concepts

| Concept             | Description                                                                                                     |
| ------------------- | --------------------------------------------------------------------------------------------------------------- |
| Application         | A mapping between a Git repo (or path) and a target cluster/namespace; ArgoCD monitors and syncs this resource. |
| Repository          | Git repository that stores manifests and acts as the single source of truth.                                    |
| Sync Policy         | Controls how and when ArgoCD applies changes (manual, automated, hooks, and custom policies).                   |
| Reconciliation Loop | The continuous process that compares Git vs cluster and applies changes to remove drift.                        |

<Callout icon="lightbulb" color="#1CB2FE">
  ArgoCD runs inside your Kubernetes cluster (typically as pods in a dedicated namespace) and needs appropriate RBAC and ServiceAccount permissions to apply manifests. A single ArgoCD instance can manage multiple target clusters using Kubernetes secrets or the ArgoCD cluster registration mechanism.
</Callout>

## Next steps and where to learn more

To deepen your understanding, explore topics such as ArgoCD architecture, installation options (Helm or manifests), defining Applications (AppProject, Application CR), sync hooks, and more advanced policies for production-grade deployments.

Links and resources:

* [ArgoCD Documentation](https://argo-cd.readthedocs.io/)
* [Kubernetes Documentation](https://kubernetes.io/docs/)
* [Helm](https://helm.sh/)
* [Kustomize](https://kustomize.io/)
* [Jsonnet](https://jsonnet.org/)

<CardGroup>
  <Card title="Watch Video" icon="video" cta="Learn more" href="https://learn.kodekloud.com/user/courses/certified-argo-project-associate-capa/module/9facbd04-7a3f-4200-9d6e-53936e93d875/lesson/1838906f-aa30-45b1-9134-13c8b6de185d" />
</CardGroup>
