ArgoCD Tutorial

A hands-on tutorial for learning GitOps with ArgoCD on Kubernetes. Designed for instructor-led workshops using cloud VMs with single-node k3s clusters.

Getting Started

1. Review the GitHub Access Guide and choose how you'll push to GitHub

2. Fork this repository to your GitHub account

3. SSH into your assigned VM: ssh student@<your-vm-ip>

4. Clone your fork on the VM:

   git clone https://github.com/<your-username>/tutorial-argocd-tx2026.git
   cd tutorial-argocd-tx2026

5. Follow the tutorial parts in order, starting with Part I

Tutorial Parts

• Part I: Installing ArgoCD - Set up ArgoCD on a k3s cluster using Helm
• Part II: Core GitOps Exercises - Deploy apps, configure auto-sync, make changes via Git
• Part III: Advanced Topics - App of Apps, ApplicationSets, rollbacks, sync waves and hooks
• Part IV: Multi-Environment Deployments - Kustomize overlays for dev/staging/prod

Prerequisites

• A Kubernetes cluster. For the instructor-led tutorial, a cloud VM with k3s installed (provided by the instructor).
• However, a kind or minikube cluster may be used for self-instruction. Alternates include k3s.
• SSH access to the VM. You will need to have a ssh public-key for the instructor-led session.
• A GitHub account (for forking this repo).

License

This project is licensed under the Apache License 2.0. See LICENSE for details.