From 11dc68ee1762fe9293a5f6684eaa7b34ef104f6f Mon Sep 17 00:00:00 2001 From: Paul Harkink Date: Sun, 1 Mar 2026 19:14:56 +0100 Subject: [PATCH] docs(assignments): add beginner-context callouts and skip-friendly leeswijzer --- docs/01-argocd-bootstrap.md | 12 ++++++++++++ docs/02-deploy-podinfo.md | 12 ++++++++++++ docs/03-metallb-ingress.md | 12 ++++++++++++ docs/04-tekton-pipeline.md | 9 +++++++++ docs/05-app-upgrade.md | 9 +++++++++ docs/06-monitoring.md | 13 +++++++++++++ 6 files changed, 67 insertions(+) diff --git a/docs/01-argocd-bootstrap.md b/docs/01-argocd-bootstrap.md index 24b91e2..833a939 100644 --- a/docs/01-argocd-bootstrap.md +++ b/docs/01-argocd-bootstrap.md @@ -14,6 +14,14 @@ --- +## Leeswijzer + +> **Voor beginners (optioneel):** +> De extra uitlegblokken in deze oefening leggen uit *waarom* je iets doet. +> Als je al ervaring hebt met ArgoCD/GitOps, kun je die blokken gerust overslaan en alleen de stappen/snippets uitvoeren. + +--- + ## Vereisten De VM draait en je bent ingelogd: @@ -84,6 +92,10 @@ Login: `admin` / het wachtwoord uit de output van het script. Het bootstrap-script installeert ArgoCD, maar registreert jouw Git-repo niet in ArgoCD. Daarom moet je in deze stap expliciet je repo toevoegen, anders blijft `root` op `Unknown`/`authentication required`. +> **Voor beginners (optioneel):** +> ArgoCD weet pas *welke* Git-repo het moet lezen als je die repo registreert. +> Deze stap gaat dus niet alleen over toegang/rechten, maar ook over het "bekend maken" van de repo zelf. + Kies een van deze twee paden: **Pad A — via ArgoCD UI** diff --git a/docs/02-deploy-podinfo.md b/docs/02-deploy-podinfo.md index 61478e2..322d9d5 100644 --- a/docs/02-deploy-podinfo.md +++ b/docs/02-deploy-podinfo.md @@ -14,6 +14,14 @@ --- +## Leeswijzer + +> **Voor beginners (optioneel):** +> In deze oefening doe je bewust geen `kubectl apply` voor podinfo. +> Dat voelt in het begin onnatuurlijk, maar is precies het GitOps-principe: Git verandert, ArgoCD voert uit. + +--- + ## Vereisten Oefening 01 afgerond. ArgoCD draait en de root app is Synced. @@ -106,6 +114,10 @@ spec: **`apps/apps/podinfo.yaml`** +> **Voor beginners (optioneel):** +> Zie deze `Application` als een "pointer": +> hij zegt tegen ArgoCD *waar* de echte Kubernetes YAML staat (`manifests/apps/podinfo`) en *waar* die toegepast moet worden (namespace `podinfo`). + ```yaml apiVersion: argoproj.io/v1alpha1 kind: Application diff --git a/docs/03-metallb-ingress.md b/docs/03-metallb-ingress.md index f5cf9b4..ec707e1 100644 --- a/docs/03-metallb-ingress.md +++ b/docs/03-metallb-ingress.md @@ -16,6 +16,14 @@ port-forward. --- +## Leeswijzer + +> **Voor beginners (optioneel):** +> In deze oefening komen netwerkconcepten samen (LoadBalancer IP, Ingress, DNS-hostname). +> Lees de "Wat dit doet" blokken eerst rustig door; plak pas daarna de YAML. + +--- + ## Achtergrond In cloud-Kubernetes (EKS, GKE, AKS) regelt `type: LoadBalancer` automatisch een load balancer met een extern IP. Op bare @@ -254,6 +262,10 @@ Vanuit je laptop: > # 404 van Nginx — klopt, nog geen Ingress-regel > ``` +> **Voor beginners (optioneel):** +> Deze `404` is hier juist positief: +> je bereikt de ingress-controller wel, maar er is nog geen Ingress-regel voor jouw app. + --- ### 4. Ingress voor podinfo toevoegen diff --git a/docs/04-tekton-pipeline.md b/docs/04-tekton-pipeline.md index 02b4e14..70f7b3c 100644 --- a/docs/04-tekton-pipeline.md +++ b/docs/04-tekton-pipeline.md @@ -14,6 +14,15 @@ volledige GitOps CI/CD-loop. --- +## Leeswijzer + +> **Voor beginners (optioneel):** +> Oefening 04 heeft de meeste moving parts. +> Alle alinea's met "Waarom dit" kun je zien als mini-achtergrond. +> Gevorderden kunnen die overslaan en direct de snippets volgen. + +--- + ## De loop ``` diff --git a/docs/05-app-upgrade.md b/docs/05-app-upgrade.md index a24ea3a..80723bb 100644 --- a/docs/05-app-upgrade.md +++ b/docs/05-app-upgrade.md @@ -50,6 +50,15 @@ Tekton PipelineRun --- +## Leeswijzer + +> **Voor beginners (optioneel):** +> Zie oefening 05 als "begrijpen wat je net gebouwd hebt". +> Het doel is minder nieuwe YAML, en meer leren herkennen van gedrag: +> wie doet wat (Tekton commit, Argo sync, Kubernetes rollout). + +--- + ## Probeer het: handmatige downgrade Als de pipeline podinfo al naar `6.7.0` heeft gebracht, probeer dan een handmatige downgrade: diff --git a/docs/06-monitoring.md b/docs/06-monitoring.md index 1dd56e0..37fba1d 100644 --- a/docs/06-monitoring.md +++ b/docs/06-monitoring.md @@ -14,6 +14,15 @@ --- +## Leeswijzer + +> **Voor beginners (optioneel):** +> Deze bonusoefening is vooral "leren observeren". +> Focus eerst op: stack komt up, Grafana opent, dashboards tonen data. +> Daarna pas op fine-tuning van values. + +--- + ## Vereisten Oefeningen 01–03 afgerond. Ingress-Nginx draait en nip.io-URLs zijn bereikbaar vanaf je laptop. @@ -119,6 +128,10 @@ spec: De initiële sync duurt 5–8 minuten — de chart is groot en installeert veel CRDs. +> **Voor beginners (optioneel):** +> Dit duurt merkbaar langer dan eerdere oefeningen en dat is normaal. +> Je installeert hier geen losse app, maar een complete monitoring-stack met veel onderdelen. + --- ### 2. Wachten tot de stack klaar is