Dienstbeschrijving en toetsing

In de eerste levering heeft de dienstbeschrijving deze velden, elk met de controle die de toetsing uitvoert.

Naast die velden legt de dienstbeschrijving de sjabloonversie vast, de gevraagde toestand (actief of beëindigen), bij een koppeling de verwijzing naar de instemming, en vanaf de vrijgave voor bedrijfskritische productie de keuze of de gegevens buiten eigen beheer mogen (FortKnox). Vaste waarden komen ongewijzigd uit de sjabloonversie.

Dienstbeschrijvingen staan in YAML; de API’s van catalogus en portaal volgen OpenAPI 3 en de REST-API Design Rules.

De opslagplaats Afnemers heeft per team een map teams/<team>/ met een teambestand (kostenplaatsen, quotum en de instemmingen van eigenaren van bronnen) en per dienst een map teams/<team>/<naam>/ met dienstbeschrijving en catalogusbestand. Het pad bepaalt het team. Het teambestand wijzigt alleen na beoordeling door platformbeheer, via het eigenaarsbestand.

Een koppeling met een bestaand systeem vraagt een geldige, vastgelegde instemming van de eigenaar van de bron. Die instemming staat vooraf in het teambestand, met identiteit, gegevens, doel en einddatum, zodat een levering zonder persoon in het pad kan verlopen; de eerste koppeling met een bron vraagt daarom vooraf een voorstel op het teambestand. De eigenaar van de bron beoordeelt haar jaarlijks opnieuw.

Een team kan zelf aanvragen, wijzigen binnen quotum en varianten, verbindingen binnen de zonematrix declareren, de einddatum in ontwikkelen en beproeven verlengen, beëindigen en werkruimten gebruiken. Een team kan niet zelf vaste waarden, sjablonen of de standaardinrichting wijzigen, een voorstel buiten de varianten goedkeuren, zijn quotum ophogen, voor een ander team aanvragen of iets laten uitvoeren zonder samengevoegd voorstel.

Beleidstoetsing, zonecontrole en geheimencontrole draaien als één toetspijplijn op ieder voorstel in Afnemers, dus voor iedere ingang: Forgejo Actions op de runner op het basisdienstencluster, met de werkstroomdefinitie van de hoofdtak. Zij controleert rol van de aanvrager, pad, schema, vaste waarden, velden, capaciteit, instemming en zones, en zet uitkomst en regelversie als statusvermelding bij het voorstel. Bij een afwijking gaat het voorstel met uitleg terug naar het team; een verbinding buiten de toegestane stromen gaat naar netwerkbeheer.

Ieder voorstel in Afnemers wordt getoetst aan de geldende regelversie, die met de vastlegging bij het voorstel wordt bewaard, en met de werkstroomdefinitie van de hoofdtak. Een voorstel dat buiten de eigen map van het team of aan die werkstroomdefinitie wijzigt, is geen standaardwijziging.

De toetsing leidt de rol van de aanvrager af uit de teams van het versiebeheer, die de groepen van teamleden en teameigenaren in de toegangsvoorziening volgen, en de zones uit de datacenterregistratie. De runner leest daarvoor de datacenterregistratie, alleen lezend.

De invoerregels staan als één schema per sjabloonversie in de opslagplaats Catalogus. Formulier en toetsing gebruiken hetzelfde schema, zodat een voorstel uit het formulier niet alsnog op de vorm wordt afgewezen.

De toetsing geeft binnen 15 minuten een uitkomst: afwijzing, beoordeling of door naar uitvoering. Duurt zij langer, dan volgt een melding, en bij herhaling een extra runner.

Iedere verbinding tussen zones doorloopt vooraf de zonecontrole; een goedkeuring buiten de zonematrix geldt alleen voor die ene verbinding.

Een aanvraag past binnen het teamquotum en de vrije capaciteit van de cel, en reserve wordt niet uitgegeven. De toetsing rekent met de grenzen per cel in de opslagplaats Platform en met de som van alle dienstbeschrijvingen in Afnemers, zodat twee gelijktijdige aanvragen samen niet boven een grens uitkomen.

De toetsing en platformbeheer bewaken deze capaciteitsgrenzen.

De omgevingen voor ontwikkelen en beproeven en reguliere productie van een team staan in aparte clusters, en een database staat in een cluster van hetzelfde team en profiel. In ontwikkelen en beproeven is een einddatum verplicht; in bedrijfskritische productie is de keuze voor FortKnox verplicht.