Sjabloon stroomdiagram CI/CD-pipeline

Een pipeline werkt het best als beslisflow, omdat het interessante deel is wat een commit tegenhoudt, niet de reeks jobs die hem uitvoert. Wij raden deze aanpak aan:

1. Zet alle uitkomsten op een rij die een commit kan bereiken: productie, geblokkeerde merge, rollback.
2. Schrijf de poorten op die ze van elkaar scheiden, en geef aan welke geautomatiseerd zijn en welke een persoon nodig hebben.
3. Maak van elke poort een beslispunt met beide uitgangen getekend, inclusief de faalpaden.
4. Controleer of elk pad eindigt. Een pipelinediagram met een losse tak is de plek waar een mislukte deploy onopgemerkt blijft.
5. Teken het diagram in de tool die uw publiek al gebruikt. Een gratis sjabloon neemt het meeste opmaakwerk uit handen.

Continuous delivery betekent dat elke geslaagde build klaar is voor release, maar dat een persoon beslist wanneer. Continuous deployment betekent dat elke geslaagde build automatisch naar productie gaat, zonder mens in het pad.

De goedkeuringspoort in dit diagram is het hele verschil. Haal hem weg en dezelfde pipeline wordt continuous deployment. Daar loont het om bewust mee om te gaan: teams zeggen vaak dat ze aan deployment doen terwijl ze delivery draaien, en ontdekken het verschil pas tijdens een audit.

Continuous integration is alles tot en met de testpoort: code vaak samenvoegen en automatisch aantonen dat die bouwt en slaagt. Continuous delivery of deployment is alles daarna: die geverifieerde build naar staging en vervolgens naar productie brengen.

In dit diagram eindigt CI bij de beslissing of de tests slagen, en begint CD bij de deploy naar staging. Die splitsing is niet theoretisch: ze falen meestal om verschillende redenen en hebben vaak verschillende eigenaren.

Elke poort houdt een commit om een andere reden tegen:

• Tests geslaagd: geautomatiseerd, objectief en snel. Bij nee krijgt de auteur een melding en wordt de merge geblokkeerd.
• Goedkeuringspoort: menselijk, gebaseerd op beoordeling en trager. Bij nee volgt een rollback en stopt de pipeline, in plaats van een nieuwe poging.

Voeg een extra poort toe voor security scanning, performancebudgetten of een beoordeling door een change advisory board; de vertakkingen blijven verbonden terwijl het diagram zich aanpast.

De stap voor bouwen en tests uitvoeren gebruikt de vorm voor een vooraf gedefinieerd proces in plaats van een gewone rechthoek. In de notatie van stroomdiagrammen markeert die een stap die elders in detail is vastgelegd, in dit geval de jobconfiguratie in uw CI-systeem.

Op een dia is dat een nuttig signaal. Het vertelt de lezer dat het vak een samenvatting is van een pipeline die hij elders kan nalezen, en geen losse handeling, zonder het diagram vol te zetten met elke testfase.

De commit gaat naar melden en merge blokkeren. Beide helften zijn belangrijk: melden zonder blokkeren betekent dat de fout wordt genegeerd, en blokkeren zonder melden betekent dat de auteur het van iemand anders hoort.

Dat dit als eindpunt is getekend en niet als lus terug, is een bewuste keuze. Een mislukte build wordt niet door de pipeline opnieuw geprobeerd; hij gaat terug naar degene die de code heeft geschreven, zodat de oplossing ligt bij de persoon die de context heeft.

Dat hangt af van waartegen u zich wilt beschermen. Een handmatige poort vangt op wat automatisering niet kan beoordelen: een riskante release vlak voor een lang feestweekend, een wijziging waarover eerst een klant moet worden geïnformeerd, een compliance-eis voor functiescheiding. Hij kost u ook snelheid en wordt een stempelmachine als niemand ooit nee zegt.

Een redelijke toets: heeft uw goedkeurder in zes maanden niets afgewezen, dan is de poort toneel. Automatiseer hem dan, of voeg de criteria toe die een afwijzing mogelijk maken.

Elke poort moet een benoemde eigenaar hebben, en dat is zelden hetzelfde team:

• Developers: de commit, en het oplossen van alles wat de testpoort blokkeert.
• Platform of DevOps: de buildconfiguratie, de stagingomgeving en het rollbackmechanisme.
• Releasemanager of tech lead: de goedkeuringsbeslissing zelf.
• Security of compliance: de criteria waartegen de poort toetst, voor zover van toepassing.

Schrijft dezelfde persoon de code en keurt hij ook de release goed, dan biedt de poort niet de scheiding die hij lijkt te bieden.

PowerPoint kan het met SmartArt en de Shapes gallery, maar dat is handwerk: u plaatst elke ruit zelf, labelt beide uitgangen en koppelt de verbindingslijnen opnieuw zodra er iets verschuift. Bij een pipeline met twee poorten en drie eindpunten is dat precies de reden waarom het diagram niet meer wordt bijgewerkt.

Sneller gaat het met het tabblad Lucen Flowchart: dat klikt verbindingslijnen vast aan de ankerpunten van vormen en herschikt het diagram met Auto Layout wanneer u een poort toevoegt. Hoe u het ook doet, het resultaat blijft een set native PowerPoint-objecten op uw dia.

De download is een gratis .pptx die volledig uit native PowerPoint-vormen bestaat. Iedereen kan het bestand dus openen, lezen en bewerken, en u deelt het net als elke andere presentatie. Ontvangers hoeven niets te installeren.

De slimme verbindingslijnen, Auto Layout en Lucen AI komen uit de invoegtoepassing Lucen Flowchart, die het tabblad Lucen Flowchart aan het lint toevoegt. Die werkt op Windows met PowerPoint 2016 of later en met PowerPoint voor Microsoft 365. PowerPoint voor het web, Mac en mobiel worden niet ondersteund. Stappen voor installatie en probleemoplossing vindt u bij Lucen Support.