Wat is een Developer Portal?



Crowd of passengers having fun in a bustling city on a vibrant floor

Published on 5 August 2022 by Arjan Franzen

Wanneer uw agile organisatie software bouwt met een microservices-architectuur, loopt u vroeg of laat tegen vragen aan zoals:

  • Welke services draaien we?
  • Hoe integreer ik met deze microservice?
  • Draaien alle services conform de SLA?
  • Wie werkt eraan, of wie kan ik aanspreken voor een specifieke microservice?
  • Waar staat de meest recente documentatie van deze microservice?
  • Hoe voeg ik een service toe zonder het wiel opnieuw uit te vinden?

Voor development management is de uitdaging: teamautonomie behouden, terwijl u bepaalde processen centraliseert en één "single pane of glass" creëert voor zowel management als teams. Behoud de performance door onnodige rompslomp en toil zoveel mogelijk te schrappen of te automatiseren.

Een Developer Portal?

Een manier om deze uitdagingen aan te gaan en "het goede" te behouden, is een platform dat:

  1. Eén toegangspunt biedt voor developmentteams
  2. Een gecentraliseerde servicecatalogus levert
  3. Betere vindbaarheid van mensen, services en documentatie mogelijk maakt
  4. Templates en best practices biedt om snel nieuwe microservices op te zetten
  5. Technische documentatie centraliseert en een Technology Radar biedt
  6. DevOps Metrics toont voor alle services en teams

Door deze functies te bundelen in één oplossing krijgt uw organisatie een Developer Portal. Developer portals zijn plekken waar bedrijven technische outreach en educatie organiseren. Zij bieden softwaredocumentatie, voorbeeldcode, tools en kennisbanken om communicatie en functionele samenwerking te verbeteren. Voor developers vereenvoudigt een developer portal bovendien het beheer van API’s.

Meestal zijn Developer Portals intern ontwikkelde software. Gelukkig is er een manier om Developer Portal-initiatieven te kickstarten (of te optimaliseren) met Spotify’s open source developer-portalproject genaamd ‘backstage’.

Wat is Backstage?

3463cc1e-1277-4c94-9e6e-86763d13a50d.webp

Backstage is een open platform voor het bouwen van developer portals. Backstage biedt een gecentraliseerde catalogus van uw microservices en infrastructuur. Het stelt uw productteams in staat sneller te leveren zonder in te leveren op autonomie. Backstage kan al uw infrastructuurtooling, services en (technische) documentatie verenigen tot een end-to-end gestroomlijnde ontwikkelomgeving.

Dit klinkt als een sterk verkoopverhaal, maar wat bevat Backstage concreet:

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

Misschien wel het meest aantrekkelijke aan het Backstage-aanbod is het grote ecosysteem van open source plugins dat de aanpasbaarheid en functionaliteit van Backstage verder vergroot. Backstage is momenteel de populairste developer-portaltool. Er is zelfs een handleiding van Backstage over hoe u de adoptie tot een succes maakt.

718a17f2-1d6b-4c81-9e16-ca0a9847d4a1.webp

a backstage.io example from Spotify

Alternatieven voor Backstage?

Met al dat moois van Backstage, zijn er serieuze alternatieven?

  • Cortex biedt een commerciële developer-portaloplossing, maar is een veel 'kleinere' propositie en heeft niet de hoge kwaliteit en kwantiteit aan plugins.
  • Opslevel biedt een commerciële monitoringsoplossing die een deel van de Backstage-functionaliteit mogelijk maakt.

Uit dit overzicht Developer Experience (DX):

FAANG- en startupbedrijven bouwen in toenemende mate DX-teams die samenwerken met platformteams om de productiviteit van de organisatie en de ontwikkelsnelheid te verhogen. Spotify’s Backstage, het open source platform voor het bouwen van developer platforms wint snel aan tractie omdat organisaties willen dat developers meer tijd besteden aan coderen en minder aan nadenken over en werken aan infrastructuur.

Wij hebben onze opties geëvalueerd en geconcludeerd dat Backstage de developer experience het meest verbetert. Daarom implementeren wij een ZEN Backstage Developer Portal.

Wij kunnen helpen

Of u nu al een backstage.io-omgeving hebt of overweegt een backstage-portal op te zetten, ZEN Software heeft ruime ervaring met het opzetten en begeleiden van Developer Portal-projecten. Mis vooral Agile Analytics van ZEN Software en de integratie met backstage.io niet. Zet DORA DevOps Metrics, SRE error budgets en ML-inzichten in voor uw sprints! Agile Analytics integreert uitstekend met Backstage.

ab5e8051-32ec-4c28-879f-299e331f6fd8.webp

Supercharge your Software Delivery!

Become a High-Performing Agile Team with Agile Analytics

  • Implement DevOps with Agile Analytics

  • Implement Site Reliability with Agile Analytics

  • Implement Service Level Objectives with Agile Analytics

  • Implement DORA Metrics with Agile Analytics