Skip to main content
In this lesson we cover the foundational Argo CD concepts and terminology you need to use Argo CD effectively. This overview assumes familiarity with Git, Docker, and Kubernetes. If you need a refresher, see these courses:
Argo CD implements GitOps: the Git repository holds the desired (target) state, and Argo CD continuously reconciles the live cluster state to match that target state.
Core concepts at a glance Application (Argo CD Application)
  • An Argo CD Application is the main unit Argo CD manages. It is a Kubernetes CR named Application.
  • The Application CR includes:
    • source: repository URL and path to manifests or chart
    • destination: cluster and namespace where resources will be applied
    • rendering tool choice (Kustomize, Helm, plain YAML, or a plugin)
    • sync policies, credentials, and other options
Example: minimal Application manifest (YAML)
Source types and tooling
  • The Application source section defines how Argo CD should render and obtain manifests.
  • Common renderers:
    • Kustomize — overlay-driven configuration
    • Helm — templated charts and values.yaml
    • Plain Kubernetes manifests (YAML)
  • Argo CD can be extended with custom generators and plugins for advanced workflows.
Projects
  • Projects are a namespace-like control plane within Argo CD to group and govern Applications.
  • Use Projects to restrict which Git repos, clusters, and namespaces an Application can target and to enforce RBAC boundaries.
Application states Synchronization and reconciliation
  • Argo CD continuously compares the target state (Git) to the live state (cluster) and performs a reconciliation loop.
  • When differences are detected, Argo CD can perform a sync operation to apply changes so the live state matches the target state.
Sync status vs. operation status
  • Sync status (high-level): indicates whether the live resources match Git, for example:
    • Synced — cluster matches Git
    • OutOfSync — cluster diverges from Git
  • Operation status (task-level): describes the progress/outcome of the last sync action, for example:
    • Running, Succeeded, Failed
Common CLI operations
  • Sync an Application:
    • argocd app sync <app-name>
  • Refresh an Application (re-evaluate Git & cluster state):
    • argocd app refresh <app-name>
  • View Application status:
    • argocd app get <app-name>
Refresh
  • A refresh forces Argo CD to re-evaluate the repository and live cluster state. If differences are found, a new sync can be initiated (manually or automatically depending on sync policy).
Health status and checks
  • Argo CD provides built-in health checks for many Kubernetes resource kinds and reports per-resource and overall Application health.
  • Health checks make it easy to see whether individual resources (Pods, Deployments, Services, etc.) are healthy and whether the Application is overall healthy.
The image is a visual guide to ArgoCD concepts and terminology, featuring definitions for terms like "Application," "Target state," and "Sync status," along with relevant logos and icons.
You may not interact with Argo CD’s built-in health checks directly every day, but understanding them clarifies how Argo CD evaluates resources during reconciliation and sync. Further reading and references That covers the basic Argo CD concepts and terminology. Use this as a quick reference when designing GitOps workflows with Argo CD.

Watch Video