Kubernetes GitOps Workshop

Twee en een half tot vier uur hands-on cluster operations met ArgoCD, MetalLB, Ingress-Nginx en Tekton. Alles draait lokaal op een single-node k3s cluster in een VM.

---

Vóór je begint

Je hebt drie dingen nodig op je laptop. Installeer ze de dag van tevoren — niet op de dag zelf.

Tool	Download
VirtualBox 7.x	https://www.virtualbox.org/wiki/Downloads — op Windows: reboot alleen als installer/Windows daarom vraagt
Vagrant 2.4.x	https://developer.hashicorp.com/vagrant/downloads
Git	https://git-scm.com/downloads

Minimaal 12 GB vrij RAM en ~15 GB schijfruimte. Snelle check:

VBoxManage --version && vagrant --version && git --version

Als één van de drie niets teruggeeft: installeren en opnieuw proberen.

---

Aan de slag

Fork eerst de repo naar je eigen GitHub-account — ga naar https://github.com/paulharkink/ops-demo en klik Fork. Zo kun je zelf pushen zonder dat je toegang nodig hebt tot de originele repo.

1. Clone je fork op je host-machine.

git clone https://github.com/JOUW_USERNAME/ops-demo.git && cd ops-demo

2. Start de VM.

vagrant up

3. Run bootstrap vanaf je host (script voert bootstrap in de VM uit).

./scripts/host/bootstrap-from-host.sh

./scripts/host/bootstrap-from-host.ps1

4. Open ArgoCD UI via tunnel.

./scripts/host/argocd-ui-tunnel.sh

./scripts/host/argocd-ui-tunnel.ps1

5. Open in je browser:

http://localhost:8080

Volg daarna de oefeningen in volgorde. Zie docs/vm-setup.md als er iets misgaat bij de VM. Deze quickstart voert bootstrap al uit. In Oefening 01 kun je dan direct door naar verificatie en commit/push van apps/root.yaml.

Belangrijk:

• Je hoeft het VM-IP niet te weten om in te loggen of te tunnelen; gebruik vagrant ssh.
• Je hoeft de repo niet opnieuw in de VM te clonen: Vagrant mount je host-repo automatisch als /vagrant.

---

Oefeningen

#	Oefening	Gids	Type	Tijd
01	ArgoCD bootstrappen	docs/01-argocd-bootstrap.md	Kern	30 min
02	podinfo deployen via GitOps	docs/02-deploy-podinfo.md	Kern	30 min
03	MetalLB + Ingress-Nginx	docs/03-metallb-ingress.md	Kern	45 min
04	Tekton pipeline	docs/04-tekton-pipeline.md	Kern	45 min
05	App upgrade + reflectie	docs/05-app-upgrade.md	Kern	15 min
06	Prometheus + Grafana	docs/06-monitoring.md	Bonus	60 min

Beginners: focus op 01–03 (~1u45m). De rest: probeer 01–05 te halen.

---

Stack

Component	Rol	Versie
k3s	Kubernetes	v1.31.4
ArgoCD	GitOps engine	v2.13.x (chart 7.7.11)
MetalLB	Bare-metal LoadBalancer	v0.14.9
Ingress-Nginx	HTTP-routing	chart 4.12.0
Tekton	CI-pipeline	v0.65.1
podinfo	Demo-app	6.6.2 → 6.7.0
kube-prometheus-stack	Observability (bonus)	chart 68.4.4

---

Vastgelopen?

Elke solution branch is cumulatief — hij bevat alles t/m die oefening. Je kunt een PR openen van een solution branch naar jouw eigen branch om precies te zien wat er mist.

Branch	Bevat
solution/01-argocd-bootstrap	ArgoCD draait
solution/02-deploy-podinfo	podinfo gesynchroniseerd via ArgoCD
solution/03-metallb-ingress	LAN-toegang via MetalLB + Ingress
solution/04-tekton-pipeline	Volledige GitOps CI-loop
solution/05-app-upgrade	podinfo op v6.7.0
solution/06-monitoring	Prometheus + Grafana actief

---

Troubleshooting

Probleem	Oplossing
A VirtualBox machine with the name 'ops-demo' already exists	Je hebt waarschijnlijk twee repo-kopieen met dezelfde VM-naam. Check vagrant global-status --prune. Stop of destroy de andere omgeving, of geef een unieke VM-naam in een van de Vagrantfiles.
vagrant up faalt terwijl vagrant status zegt poweroff	Je zit mogelijk in een andere repo-map dan de VM die nu draait. Controleer de directory kolom in vagrant global-status --prune.
Ik weet het ArgoCD admin-wachtwoord niet (meer)	Lees het opnieuw uit: vagrant ssh -c "export KUBECONFIG=/home/vagrant/.kube/config; kubectl -n argocd get secret argocd-initial-admin-secret -o jsonpath='{.data.password}' | base64 -d"
Ik kan niet inloggen met vagrant ssh	Controleer eerst of je in de juiste repo-map staat (pwd) en run vagrant status. Als de VM niet draait: vagrant up. Helpt dat niet: vagrant global-status --prune en check de directory.
ArgoCD UI niet bereikbaar op http://localhost:8080	Start de tunnel opnieuw: ./scripts/host/argocd-ui-tunnel.sh (of .ps1 op Windows).
kubectl lijkt naar de verkeerde cluster te wijzen	Gebruik de host-scripts (./scripts/host/bootstrap-from-host.sh en ./scripts/host/argocd-ui-tunnel.sh) of log in met vagrant ssh en werk vanuit /vagrant. De bootstrap heeft cluster-checks en stopt bij mismatch.
root app blijft Unknown of OutOfSync	Controleer of apps/root.yaml naar jouw fork verwijst en of je die commit/push hebt gedaan. Daarna in ArgoCD op Refresh klikken.
Tekton pipeline kan niet pushen naar GitHub	Controleer credentials opnieuw met ./scripts/vm/set-git-credentials.sh <github-user> <github-pat> en gebruik een PAT met juiste repo-rechten.
MetalLB/Ingress hostnames werken niet	Wacht tot networking apps Healthy zijn in ArgoCD en controleer of het host-only netwerk 192.168.56.x actief is.

Handige debug-commando's:

vagrant global-status --prune
vagrant status
kubectl get applications -n argocd
kubectl get pods -A

---

Netwerk

Jouw laptop
    │  192.168.56.x (VirtualBox host-only)
    ▼
VM: 192.168.56.10
    └── MetalLB pool: 192.168.56.200–192.168.56.220
            └── 192.168.56.200  →  Ingress-Nginx
                    ├── podinfo.192.168.56.200.nip.io
                    ├── argocd.192.168.56.200.nip.io
                    └── grafana.192.168.56.200.nip.io  (bonus)