Leermodule schrijven — Wat is Haven (en Haven+), met kind-instructies

[MWest2020]

Achtergrond

Common Ground heeft een duidelijke mening over Kubernetes-hosting: gemeentelijke applicaties horen op een Haven-compliant cluster te draaien. Haven is een door VNG vastgestelde standaard (status "pas toe of leg uit") die een specifieke Kubernetes-configuratie voorschrijft, met Haven+ als doorontwikkeling met strengere eisen (multi-AZ, master/worker scheiding, private networking).

Voor ontwikkelaars die voor het eerst met Common Ground in aanraking komen is dit een ontbrekend hoofdstuk. We willen een leermodule die uitlegt wat Haven is, waarom het bestaat en hoe je er lokaal mee oefent via kind (Kubernetes-in-Docker).

Doel

Nederlandstalige leermodule op de website die:

• Haven en Haven+ uitlegt op niveau "ontwikkelaar die Kubernetes kent maar Haven nog niet"
• de Haven Compliancy Checker introduceert
• praktische instructies geeft om een Haven-achtige omgeving lokaal op te zetten met kind
• aansluit op andere hostingtutorials (Nextcloud, Common Ground apps)

Doelgroep

Common Ground- en Conduction-ontwikkelaars, leveranciers van gemeenten, inkopers die de term tegenkomen.

Scope

Leermodule moet minimaal dekken:

• Wat is Haven, waarom bestaat het (Common Ground, vendor lock-in voorkomen, herbruikbaarheid tussen 344 gemeenten)
• Status "pas toe of leg uit" en wat dat betekent
• Verschil Haven vs. Haven+ (multi-AZ, 3 master + 3 worker nodes, private networking, etc.)
• Wat de standaard wél en niet voorschrijft (geen security baseline, geen all-inclusive cloud)
• Eisen aan applicaties om op een Haven-cluster te kunnen draaien (containerized, K8s manifests/Helm, metrics endpoint, schaalbaar naar meerdere replica's)
• Haven Compliancy Checker — wat doet het, hoe gebruik je het
• Referentie-implementaties (Azure, GCP, VMware, Red Hat, Nederlandse providers)
• Praktijk: lokaal Haven-achtig cluster opzetten met kind
  • kind installeren
  • multi-node cluster config
  • ingress controller, storage class, metrics server
  • Compliancy Checker tegen je lokale cluster draaien
  • bekende beperkingen (geen echte multi-AZ op één laptop)
• Vervolgstappen: hoe verder naar een echte Haven-omgeving

Te verwijzen naar (officieel)

• Haven homepage: https://haven.commonground.nl/
• Wat is Haven: https://haven.commonground.nl/techniek
• Aan de slag (referentie-implementaties): https://haven.commonground.nl/techniek/aan-de-slag
• Haven GitLab repository: https://gitlab.com/commonground/haven
• developer.overheid.nl over Haven: https://developer.overheid.nl/kennisbank/devops/standaarden/haven
• Interview Haven+ team: https://developer.overheid.nl/blog/2025/06/25/interview-haven
• Bright Cubes blog over Haven+ (Gemeente Utrecht): https://blog.brightcubes.nl/nieuws/project-haven-plus
• VNG projectpagina: https://vng.nl/projecten/haven
• kind documentatie: https://kind.sigs.k8s.io/

Op te leveren

• Leermodule in Markdown op de website
• Werkende kind-config.yaml met multi-node setup
• Commando's getest op Linux + macOS
• Compliancy Checker run gedemonstreerd
• Linkcheck
• Peer review (bij voorkeur door iemand met productie-Haven ervaring)

Schatting

~1.5 dag schrijven + 0.5 dag testen kind-setup + review.

[MWest2020]

ConductionNL/conduction-website#35

[rubenvdlinde]

Status as of 2026-05-19: still in backlog. Haven (en Haven+) leermodule not started; will batch with the appstore tutorial (#47) in the next docs sprint.