Argo CD and GitOps Tutorial
Learn Argo CD and GitOps step by step: 37 lessons in 9 chapters with examples, quizzes, diagrams and projects.
Start learning →
of lessons completed
Getting Started
- What Is Argo CD? Declarative GitOps for Kubernetes Learn what Argo CD is, what problem it solves, how it compares with push-based CI/CD deployments, and which words (Application, sync, drift) you will meet throughout this course.
- Argo CD Architecture: Components and How They Work Together Understand the Argo CD components: API server, repo server, application controller, Redis, Dex, ApplicationSet and notifications controllers, and what happens during one reconciliation.
- Installing Argo CD: kubectl, Helm and Local Clusters Install Argo CD on a local kind cluster or a real cluster with the official manifests or the Helm chart, log in the first time, and choose between standard, HA and core installs.
- The Argo CD UI and CLI: A Practical Tour Tour the Argo CD web interface and the argocd command line: applications list, resource tree, diff, sync, history and rollback, plus the most useful commands and flags.
- Your First Argo CD Application: Deploy from Git Create and sync your first Argo CD Application from a Git repository: the repo layout, the Application manifest, what happens on sync, and how to change and delete it safely.
GitOps Principles
- GitOps Principles: The Four Rules Behind Argo CD Learn the four GitOps principles (declarative, versioned and immutable, pulled automatically, continuously reconciled), what GitOps is not, and how to judge whether a setup is really GitOps.
- Git Repository Layouts for GitOps: Mono-repo, Poly-repo, Folders vs Branches Choose a Git repository layout for GitOps: app code versus config repos, mono-repo versus many repos, folders versus branches per environment, and a clean directory structure for Argo CD.
- Declarative vs Imperative: Why GitOps Needs Desired State Understand the difference between imperative commands and declarative desired state, how Kubernetes apply merges changes, and why declarative configuration is the foundation of GitOps and Argo CD.
- The Reconciliation Loop: Drift, Refresh and Self-Healing Learn how a control loop keeps a cluster matching Git: observe, diff, act. See how Argo CD detects drift, how refresh and hard refresh differ, and how to ignore fields owned by other controllers.
- Environments and Promotion in GitOps: Dev, Staging, Production Promote a release through dev, staging and production with GitOps: pull-request promotion, image tag updates from CI, per-environment overrides, approval gates and safe rollback.
Applications and Projects
- The Argo CD Application Manifest: Every Field Explained Read and write the Argo CD Application custom resource: metadata and finalizers, project, source, destination, syncPolicy, ignoreDifferences, info and revisionHistoryLimit, with a linter you can run.
- Argo CD Sources and Destinations: Git, Helm, OCI and Clusters Learn every kind of Argo CD source (plain directory, Helm, Kustomize, plugins, OCI) and destination (in-cluster, external cluster, namespace), how tool detection works and how revisions resolve.
- Argo CD AppProjects: Guardrails for Teams and Applications Use AppProjects to limit which repositories, clusters, namespaces and resource kinds an Argo CD Application may use, add project roles and sync windows, and replace the permissive default project.
- Argo CD Repositories and Credentials: HTTPS, SSH, Apps and Templates Connect private Git, Helm and OCI repositories to Argo CD with HTTPS tokens, SSH keys or a GitHub App, use credential templates for many repos, and manage repository secrets declaratively.
Sync and Health
- Argo CD Sync Policies: Automated Sync, Prune, Self-Heal and Retry Decide between manual and automated sync in Argo CD, and learn what prune, self-heal, allowEmpty and retry with backoff really do, with a simulator and guidance on safe defaults per environment.
- Argo CD Sync Options, Phases and Waves: Control the Order Control how and in what order Argo CD applies resources: sync options like CreateNamespace, ServerSideApply and Replace, sync phases, sync-wave annotations and the default ordering of resource kinds.
- Argo CD Health Checks and Diffing: Healthy, Degraded and Ignored Fields Learn how Argo CD computes resource and application health, what Healthy, Progressing, Degraded, Suspended and Missing mean, how to write custom Lua health checks and how to tame noisy diffs.
- Argo CD Sync Hooks and Rollbacks: Migrations, Smoke Tests, Recovery Run Jobs before, during and after a sync with Argo CD resource hooks (PreSync, PostSync, SyncFail), choose a delete policy, and roll back safely with Git reverts or argocd app rollback.
Helm, Kustomize and Config Management
- Helm Charts in Argo CD Deploy Helm charts with Argo CD: chart sources, valueFiles, inline values, parameters, hooks, OCI registries, and how Argo CD differs from helm install.
- Kustomize in Argo CD Use Kustomize with Argo CD: bases and overlays, in-Application overrides for images, prefixes and replicas, components, build options and common pitfalls.
- Directory Apps, Jsonnet and Config Management Plugins Learn the other Argo CD config tools: plain YAML directories with include and exclude, Jsonnet with external variables, and sidecar config management plugins.
- Multiple Sources and Value Files from Another Repo Combine a public Helm chart with your own values from Git using spec.sources and ref, plus rules for revisions, paths, rollback and common mistakes.
Multi-cluster and ApplicationSets
- Multi-cluster Management with Argo CD Manage many Kubernetes clusters from one Argo CD: register clusters with the CLI or declarative Secrets, target them by name or URL, and choose a topology.
- ApplicationSet Generators: List, Cluster and Git Generate many Applications from one template with ApplicationSet: list, cluster, Git directory and file generators, templating and a runnable model.
- ApplicationSet Matrix, Merge, Templates and Progressive Sync Combine generators with matrix and merge, template patches and conditionals, sync policy protections and the alpha rolling sync strategy for ApplicationSets.
- The App of Apps Pattern Bootstrap whole environments with one root Application that deploys other Applications: layout, finalizers, sync waves, comparison with ApplicationSets.
Security and RBAC
- RBAC Policies, Projects and Roles Control who can do what in Argo CD: policy.csv syntax, built-in roles, group mapping, AppProject roles and limits, plus a runnable policy evaluator model.
- SSO and Authentication: OIDC, Dex and the Admin Account Set up single sign-on for Argo CD with Dex or native OIDC, map groups to roles, retire the admin account and use API tokens safely for automation.
- Secrets in GitOps: Sealed Secrets, ESO, SOPS and Vault Keep secrets out of Git plaintext: compare Sealed Secrets, External Secrets Operator, SOPS and Vault plugin approaches for Argo CD, with a runnable scanner.
Operations and Patterns
- Notifications and Git Webhooks Send Slack, email and webhook alerts on sync and health events with Argo CD Notifications, and use Git webhooks for instant refresh instead of polling.
- High Availability and Performance Tuning Run Argo CD in HA mode and scale it: component roles, controller sharding, repo server limits, monorepo path annotations, Redis and resource sizing.
- Upgrades, Backup and Disaster Recovery Upgrade Argo CD safely, back up with argocd admin export and import, and rebuild from Git after a disaster, including what Git does not contain.
- Progressive Delivery with Argo Rollouts Add canary and blue-green releases to GitOps with Argo Rollouts: the Rollout resource, steps, analysis, how it cooperates with Argo CD, plus a canary simulator.
- Troubleshooting Sync Problems Diagnose common Argo CD problems: permanent OutOfSync, comparison errors, stuck operations, finalizers, hooks and ignoreDifferences, with commands to find the cause.
Projects and Practice
- Project: Multi-environment Promotion with Argo CD Build a promotion workflow: repository layout, one ApplicationSet for dev, staging and prod, image tag promotion by pull request, guardrails and rollbacks.
- Project: Bootstrap a Platform from One Repository Rebuild a whole cluster from Git: install Argo CD, apply a root Application, order platform add-ons with sync waves and onboard teams with ApplicationSets.
- Practice: Argo CD and GitOps Scenarios Test what you learned with realistic Argo CD scenarios on config tools, ApplicationSets, RBAC, secrets and operations, plus a runnable Application linter.