Spoke aanmaken

Runbook voor operators voor de standaardwijziging Nieuwe workload / spoke / application landing zone (spoke canvas). Het geeft de volgorde van het werk, van de aanvraag tot een pull request die klaar is voor review. De velden, de JSON, wat er wordt aangemaakt en hoe je het verifieert staan in Nieuwe spoke en de Spoke JSON-referentie. De review staat in Spoke pull request review, de deployment in Spoke-deployment.

1. Controleer de aanvraag

Heeft de aanvrager een pull request met het spoke-bestand toegevoegd, review die dan zorgvuldig op syntax en volledigheid, en ga naar Spoke pull request review. Controleer anders het aanvraagformulier. Begin niet voordat het compleet is.

Veld	Verplicht	Voorbeeld / opmerking
Naam	ja	De workload. Geeft workloadShortName (maximaal 6 tekens, kan later niet meer veranderen).
Onderbouwing	ja
Omgeving	ja	dev, tst, acc, prd, shared. Eén spoke per omgeving.
Gebruikstype (productiedata ja of nee)	ja	Bepaalt de management group, en de tag pii wanneer er persoonsgegevens bij betrokken zijn.
IP-bereik	ja	Bijvoorbeeld een /24. Toegewezen uit het IP-plan, nooit verzonnen.
Subnetnaam, -grootte, delegations, service endpoints	nee	Delegation-namen komen uit de schemalijst.
Welk team toegang nodig heeft	ja	De naam van een bestaande groep in Entra ID.

Ontbreekt er iets of is iets onduidelijk, vraag het dan aan de aanvrager of de eigenaar van het platformontwerp.

2. Voorbereiden

1. Controleer de randvoorwaarden van Nieuwe spoke → Voordat je begint: de subscription bestaat, de management group bestaat in de foundation-configuratie, de teamgroepen bestaan, de goedkeuringen zijn geregeld, het adresbereik is gereserveerd in het IP-plan.
2. Maak een branch vanaf main in de configuratierepository met het ticketnummer in de naam, bijvoorbeeld change/<ticket-id>-spoke-<workload>.

3. Maak het spoke-bestand

1. Begin met een sjabloon. Neem altijd het nieuwste spoke-sjabloon of een recente werkende spoke van hetzelfde soort, en kopieer die. Bewerk het sjabloon zelf niet.
2. Geef het bestand een naam volgens de naamgevingsconventie van je platform en maak die uniek over alle submappen van de map spokes/, bijvoorbeeld canvas_<workload>_<environment>.json. Sommige platformen gebruiken een patroon dat ook productie of niet-productie laat zien. Het bestand moet in een submap staan.
3. Vul alle velden in met de waarden van de aanvraag: er mogen geen placeholders overblijven.
   • workloadShortName, environment, azureSubscriptionId, azureSubscriptionName, managementGroupId
   • tags met owner, department, workload, pii, costcentre en environment
   • adInfo met de teamgroepen en de PIM-modi
   • targetRegions, en de network-items in resourceconfiguration
   • optionele blokken (storageaccount, keyvault, loganalytics, azdo) zoals afgesproken
4. Gebruik de placeholders ##wlshortname##, ##environment## en ##region## in resourcenamen, zoals in de voorbeelden van de referentie.

4. Valideer

1. Valideer het bestand tegen het spoke-schema (Bewerk de JSON-bestanden met schema-ondersteuning). Los elke fout en waarschuwing op.
2. Controleer de bestandsnaam tegen de naamgevingsconventie.
3. Controleer elke waarde kruislings met de aanvraag en met de bronsystemen (IP-plan, subscription, groepen).
4. Controleer dat alle verplichte velden zijn ingevuld en dat de optionele bewust zijn behandeld.
5. Draai de config tests lokaal als dat kan (De tests lokaal draaien).
6. Vraag een collega om een peer review vóór de pull request, op structuur, volledigheid en juistheid.

5. Commit, push en open de pull request

1. Commit met een bericht dat zegt welke spoke en voor wie, en push de branch.
2. Open de pull request naar main, met een titel en beschrijving die zeggen waar de spoke voor is. Link het ticket.
3. De validatiepipeline draait op de pull request. Herstel wat hij meldt en push opnieuw: de checks starten opnieuw.
4. Als de checks groen zijn, vraag een tweede engineer om de review (Spoke pull request review).

6. Deployen

Deploy de spoke na goedkeuring en merge met de spoke-pipeline: Spoke-deployment. De spoke is klaar als de pull request is gemerged en de pipeline-run is afgerond en geverifieerd.

7. Afronden

• Vertel de aanvrager wat er is aangemaakt: de naam van de subscription, het bereik van het virtual network, de groepsnamen en hoe je de rol activeert als PIM van toepassing is (Wat er daarna gebeurt).
• Leg complexe configuratie vast voor later gebruik.
• Krijgt de spoke managed VM's, voeg dan zijn map toe aan de lijst met spokes van de modulepipeline (Managed VM-module).
• Firewallregels voor het verkeer van de spoke zijn aparte wijzigingen (Firewallregels).

Subscription aanmaken

De spoke-pipeline heeft een bestaande subscription ID nodig. Hoe de subscription wordt aangemaakt, hangt af van het proces van de organisatie (en op sommige platformen van een aparte pipeline van het platformteam): zie Nieuwe spoke → Voordat je begint.