Prioriteit geven aan technische schulden in je Jira-backlog en deze verminderen met Compass

Compass-componenten bieden teams een gecentraliseerde manier om hun software te catalogiseren en er inzicht in te krijgen. Componenten zijn alles wat zich in een repo bevindt: een service, bibliotheek, ML-model, enz. Je kunt deze standaard in Jira koppelen, zodat issues in je backlog aansluiten op de echte software die ze beïnvloeden. Dit helpt teams om inzicht te krijgen in de impact van hun werk en hoe dat zich verhoudt tot het grote geheel van hun software.

Het platformengineeringteam van Atlassian kan dankzij Compass informatie, normen en praktijken centraliseren die ons helpen een goede ontwikkelaarservaring en technische cultuur te behouden. Dit leidt tot autonome teams, duidelijke normen en praktijken, overzichtelijk beeld van de verantwoordelijken van een service en minder zoektijd.

Je kunt binnen enkele minuten aan de slag met Compass door een paar eenvoudige stappen te volgen: (1) je componenten importeren, (2) teams toewijzen als eigenaar van je componenten, (3) scorecards configureren.

Voor de meeste teams betekent dat dat je een SCM-tool (Source Code Management) moet koppelen, zoals Github of Bitbucket, of dat je repo's moet importeren die gekoppeld zijn aan je Jira-projecten. Je kunt ook componenten importeren uit een CSV-bestand of een combinatie van deze methoden om snel een uitgebreide catalogus samen te stellen van alles wat je ontwikkelaars bouwen en onderhouden.

Je kunt binnen enkele minuten aan de slag met Compass door je componenten te importeren vanuit hun huidige locatie. Voor de meeste teams betekent dat dat je een SCM-tool (Source Code Management) moet koppelen, zoals Github of Bitbucket, of dat je repo's moet importeren die gekoppeld zijn aan je Jira-projecten. Je kunt ook componenten importeren uit een CSV-bestand of een combinatie van deze methoden om snel een uitgebreide catalogus samen te stellen van alles wat je ontwikkelaars bouwen en onderhouden.

Over het algemeen moet aan elke component één team worden toegewezen dat primair verantwoordelijk is voor de werking ervan. Door aan elke component een eigenaarteam toe te voegen, wordt een cultuur van samenwerking versterkt, kunnen ontwikkelaars op de hoogte blijven van relevante informatie en kunnen ze elk onderdeel deskundig behandelen, zelfs als een persoon of lead niet beschikbaar is. Compass gebruikt Atlassian Directory voor teamdefinities, dus alle bestaande teams die je in Jira gebruikt, zijn al beschikbaar.

Met de componentencatalogus kunnen ontwikkelaars in je hele organisatie snel documentatie of recente CI/CD-activiteiten vinden die verband houden met een service of bibliotheek. Dit verhoogt de productiviteit van ontwikkelaars door minder tijd te besteden aan het zoeken naar informatie en de onderbrekingen hierdoor, doordat deze informatie nu op ieder moment voor iedereen beschikbaar is.

Wanneer een SCM is verbonden, detecteert Compass automatisch gebeurtenissen zoals implementaties en voegt deze samen in de activiteitsfeed. Op basis van de gebeurtenissen in je repo, berekent Compass automatisch verschillende belangrijke statistieken die klaar zijn voor gebruik, zoals de implementatiefrequentie en het succespercentage van de build. Je kunt DORA-statistieken instellen en zelfs aangepaste gegevens bijhouden, zoals het aantal openstaande beveiligingskwetsbaarheden voor een bepaalde component.

Nu je catalogus is gevuld en de statistieken binnenstromen, is het tijd om scorecards te gaan gebruiken. Scorecards worden gebruikt om normen op te stellen en deze toe te passen op componenten in je hele organisatie. Scorecards kunnen elk gewenst doel gebruiken voor statistieken van componenten en veldgegevens. Dit helpt je ervoor te zorgen dat je softwarecomponenten gezond zijn en dat teams de aanbevolen werkwijzen volgen. Compass wordt standaard geleverd met een aantal standaard scorecards die klaar zijn voor gebruik met statistieken die we je aanraden bij te houden, zoals componentgereedheid en DevOps-status. Je kunt je eigen aangepaste scorecards maken. Als je ziet welke scorecards niet werken voor je componenten, weet je welke technische schulden je moet aanpakken!

Laten we, om verder te gaan met het bovenstaande voorbeeld, de beveiliging aanpakken met een aangepaste scorecard die niet werkt als er meer dan één openstaande beveiligingskwetsbaarheid tegelijk is. Beveiligingskwetsbaarheden zijn een klassiek voorbeeld van technische schulden. Maak eerst een statistiek om beveiligingskwetsbaarheden op te sporen en configureer deze om je verschillende componenten uit de juiste bron te halen.

Ga vervolgens naar het tabblad Scorecards onder 'Status' in de navigatiebalk bovenaan. Klik op 'Scorecard aanmaken', vul de gegevens in en zorg ervoor dat je de statistiek over beveiligingskwetsbaarheden toevoegt die je zojuist hebt gemaakt als scorecardcriterium. Stel dat de scorecard niet werkt als er ooit op een bepaald moment meer dan één openstaande beveiligingskwetsbaarheid is. Dit is een goede keuze voor services van niveau 1 die cruciaal zijn voor de operationele status van je software. Stel de operator in op 'kleiner dan of gelijk aan' en stel de waarde in op één. Stel het gewicht in op 100% en klik op Aanmaken. Nu heb je een gecentraliseerde manier om beveiligingsgerelateerde risico's bij te houden en teams duidelijke acties te geven om de status van hun software te verbeteren.

In de praktijk configureer je meerdere scorecards om verschillende normen te meten om een uitgebreid beeld te krijgen van je technische schulden.

Nu Compass is geconfigureerd, hebben we alles wat we nodig hebben om te beginnen met het identificeren en aanpakken van technische schulden. Zorg er eerst voor dat je Jira-project is aangemeld voor Compass-componenten door in de linkernavigatiebalk op 'Componenten' te klikken en het vervolgkeuzeveld rechtsboven aan te vinken. Als je je hebt aangemeld, moet er 'Compass-componenten' staan.

Ga vervolgens terug naar Compass en bekijk je scorecards. Identificeer gebieden waar scorecards risico lopen of al niet werken, en bepaal op basis van de prioriteiten van je team welk probleem als eerste moet worden opgelost. Je kunt een specifieke scorecard bekijken in de gebruikersinterface van 'Status' en zien hoe alle toepasselijke componenten het doen. Je kunt verder filteren op eigenaarteam om precies te begrijpen hoe je eigen componenten scoren en om vast te stellen welke technische schulden je aandacht vereisen.

Laten we eens kijken naar een ander voorbeeld met de ingebouwde scorecard van DevOps-status. Je bekijkt de componenten van je team en je merkt dat verschillende componenten niet voldoen aan het criterium van de implementatiefrequentie. De scorecard is zo gedefinieerd dat als er minder dan vijf implementaties per week zijn, je merkt dat sommige van je componenten maar één of twee implementaties per week hebben. Dit is een mogelijke issue dat onderzocht moet worden. Misschien is er een issue in het bouwproces of de implementatie-pipelines, of misschien worstelt je team met de technische moeilijkheidsgraad van zijn taak. Hoe dan ook, het is een technische schuld die zeker moet worden aangepakt.

Ga terug naar je backlog en kijk of er bestaande issues zijn die dit probleem van trage implementaties aanpakken. Zo niet, dan kun je rechtstreeks vanaf de scorecardpagina in Compass een nieuw issue aanmaken. Zorg ervoor dat in die issues de juiste Compass-componenten zijn getagd, zodat je georganiseerd kunt blijven en direct de impact van je backlog kunt volgen.

Van daaruit kun je die issues met een gerust hart opnemen in je volgende sprint of ze aan je Kanban-bord toevoegen. Je weet dat deze issues technische schulden met hoge prioriteit hebben, en je weet dat het werk dat je hebt gedaan invloed gaat hebben op de prestaties van je softwarearchitectuur. Nadat je team het issue heeft opgelost, kun je teruggaan naar je scorecards van DevOps-status en de geschiedenis bekijken van hoe je de implementatiefrequentie in de loop van de tijd hebt verbeterd. Dit is een geweldig beeld waarmee je leiderschap kunt tonen en dat je je team kunt laten zien terwijl je de waarde van je werk bespreekt.

Technische schulden zijn onvermijdelijk bij de levering van moderne software, maar effectieve teams weten hoe ze prioriteit moeten geven aan technische schulden met een grote impact om een hoge mate van betrouwbaarheid te behouden en tegelijkertijd innovatieve nieuwe functies met constante snelheid te leveren. Door je Jira-issues te koppelen aan een gecentraliseerde componentcatalogus in Compass krijgen teams inzicht in de impact op het werk en kunnen ze met slechts een paar stappen een effectieve afweging maken tussen technische schulden en de levering van functies:

1. Stel snel je softwarecatalogus in Compass in door je SCM te koppelen, repo's te importeren uit Jira of ze te importeren uit een CSV-bestand
2. Begin met ingebouwde scorecards en stel vervolgens je eigen scorecards samen met statistieken en andere gegevensbronnen om de softwareprestaties te vergelijken met de normen en praktijken van je organisatie en om technische schulden met hoge prioriteit te identificeren
3. Maak Compass onderdeel van je wekelijkse routine je technische schuld te wijzigen van 'Backlog' in 'Gereed', waarbij je incidenten voorkomt en steeds nieuwe functies levert