Ga naar inhoud

Version Control System (VCS) Provider

ID: ADR-0006
Status: voorgesteld
Datum: 2026-07-14
Domein: Domeinoverschrijdend
Auteurs: Bas Meeuwissen

Context en Probleemstelling

Om de architectuurdocumentatie centraal, transparant en versiebeheerd vast te leggen, is besloten om gebruik te maken van Markdown-bestanden binnen een Git-omgeving. Deze documentatie moet via een CI/CD-pipeline automatisch gepubliceerd worden op een Azure Static Website. 

De uitdaging is het kiezen van een VCS-provider die voldoet aan de operationele behoeften, budgettaire kaders en de juridische context.

Beslissingsfactoren en constraints

  • Technische beperkingen: De gekozen oplossing moet naadloze integratie bieden met Azure-publieke webhosting via CI/CD (bijv. GitHub Actions).
  • Organisationele beperkingen: Er is beperkte capaciteit voor het beheer van eigen infrastructuur (self-hosting). De oplossing moet 'low maintenance' zijn.
  • Compliance & Soevereiniteit: Hoewel de documentatie openbaar is, moet de keuze rekening houden met toekomstige Europese regelgeving omtrent data-soevereiniteit.
  • Financiële beperkingen: De oplossing moet binnen een voorspelbaar budget vallen.

Overwogen Opties

  1. Optie 1: Github (SaaS) – De marktleider met uitgebreide CI/CD-mogelijkheden en uitstekende integraties.
  2. Optie 2: Codeberg (Europese SaaS) – Een privacy-vriendelijk Europees alternatief. Biedt meer soevereiniteit, maar de automatisering richting Azure vereist extra configuratie en onderhoud.
  3. Optie 3: Gitlab (SaaS) – Een robuust alternatief met sterke CI/CD, maar de kosten voor zakelijke features kunnen hoger uitvallen dan bij GitHub voor dit specifieke gebruik.
  4. optie 4: Code.overheid (Nederlandse SaaS) – Overheidsbrede opensource codeplatform. Gepositioneerd als Europees en soeverein alternatief voor GitHub en GitLab. Vooralsnog gaat het om een pilot en is er nog geen CI/CD noch de mogelijkheid voor private repositories.

Besluitvorming

Gekozen optie: Optie 1, de aard van de data en de operationele efficiëntie. Aangezien de te publiceren artefacten (ADRs, schema's) openbaar zijn en geen gevoelige of geclassificeerde informatie bevatten, is het risico van een Amerikaanse SaaS-provider beperkt. 

De doorslaggevende factor is de combinatie van minimale operationele overhead en de bestaande workflow. De integratie met Azure is bewezen en stabiel, wat zorgt voor een directe succesvolle implementatie zonder extra technische investeringen in kennis of beheer.

Consequenties

  • Positief, want: De bestaande configuratie kunnen handhaven.
  • Positief, want: De kosten zijn beperkt en de limieten zijn ruim voldoende onze werkzaamheden.
  • Positief, want: Stabiele en eenvoudige publicatie-pipeline naar Azure.
  • Negatief, want: We worden afhankelijk van de continuïteit en het beleid van Github.
  • Negatief, want: Bij toekomstige wijzigingen in soevereiniteitseisen zal een migratie naar een Europese provider noodzakelijk zijn.