Wat is een developerportal?

Zodra je agile organisatie software bouwt met een microservice-architectuur, loop je op enig moment tegen vragen aan als:

• Welke services draaien we eigenlijk?
• Hoe koppel ik aan deze microservice?
• Halen alle services hun SLA?
• Wie werkt er aan een bepaalde microservice, of wie kan ik erover benaderen?
• Waar staat de meest actuele documentatie van deze microservice?
• Hoe voeg ik een service toe zonder het wiel opnieuw uit te vinden?

De uitdaging voor een ontwikkelmanagementteam is om de autonomie van teams overeind te houden en tegelijk een aantal processen te centraliseren en één overzichtsplek te maken — voor management én teams. En om de prestaties op peil te houden door bureaucratie en handwerk zo veel mogelijk weg te nemen of te automatiseren.

Een oplossing die deze problemen aanpakt en 'het goede' behoudt, is een platform dat:

1. Eén ingang biedt voor ontwikkelteams
2. Een centrale servicecatalogus biedt
3. Mensen, services en documentatie beter vindbaar maakt
4. Templates en best practices biedt om nieuwe microservices op te zetten
5. (Technische) documentatie centraliseert en een technologieradar biedt
6. DevOps-metrics toont voor alle services en teams

Breng je die functies samen in één oplossing, dan heeft de organisatie een developerportal. Developerportals zijn plekken waar bedrijven technische voorlichting en kennisdeling doen. Ze bieden softwaredocumentatie, voorbeeldcode, tools en kennisbanken om de communicatie en de samenwerking te verbeteren. En vanuit de developer bekeken maakt een developerportal het beheren van API's eenvoudiger.

Meestal zijn developerportals zelfgebouwde stukken software. Gelukkig is er een manier om zo'n initiatief een vliegende start te geven (of te verbeteren): het opensource-developerportalproject van Spotify, ‘Backstage’.

Dat klinkt als een uitstekend verkooppraatje, dus: wat zit er in het product Backstage?

• Een Software Catalog om al je software-assets te beheren (microservices, libraries, datapijplijnen, websites, ML-modellen en meer)
• Software Templates om snel nieuwe projecten op te zetten en je tooling te standaardiseren volgens de best practices van je organisatie
• Backstage TechDocs, waarmee technische documentatie eenvoudig te maken, te onderhouden, te vinden en te gebruiken is, volgens een 'docs like code'-aanpak

Misschien wel het aantrekkelijkste deel van Backstage is het grote ecosysteem van opensource-plug-ins, dat de aanpasbaarheid en functionaliteit verder uitbreidt. Backstage is op dit moment de populairste tool voor developerportals. Er is zelfs een handleiding van Backstage over hoe je de invoering tot een succes maakt.

Met al dat moois van Backstage: zijn er nog concurrenten of alternatieven?

• Cortex biedt een commerciële developerportal, maar het aanbod is een stuk 'kleiner' en heeft niet de kwaliteit en hoeveelheid plug-ins.
• Opslevel biedt een commerciële monitoringoplossing die een deel van de Backstage-functies mogelijk maakt.

Uit dit overzicht rond Developer Experience (DX):

FAANG- en startupbedrijven bouwen steeds vaker DX-teams die samen met platformteams de productiviteit en ontwikkelsnelheid van de hele organisatie verbeteren. Backstage van Spotify, het opensourceplatform om developerplatformen mee te bouwen, wint terrein omdat organisaties willen dat developers meer tijd aan code besteden en minder aan nadenken over en werken aan infrastructuur.

We hebben onze opties afgewogen en geconcludeerd dat Backstage de ontwikkelervaring het meest zou verbeteren. Daarom bouwen we een ZEN Backstage Developer Portal.

Heb je een backstage.io-omgeving, of overweeg je een Backstage-portal op te zetten? ZEN Software heeft ervaring met het opzetten van developerportals en met het begeleiden van organisaties in zulke projecten. Mis daarbij het Agile Analytics-product van ZEN Software en de integratie met backstage.io niet. Benut DORA-DevOps-metrics, SRE Error Budgets en ML-inzichten in je sprints! Agile Analytics integreert uitstekend met Backstage.