Utviklerportal — hvem eier egentlig den greia der?

Se for deg dette scenarioet, du har din første uke på en ny arbeidsplass og prøver å få oversikt over hvordan ting og tang henger sammen. Du sender først en melding til noen på teamet ditt og spør om de vet hvem som eier LegacyAuthService. Svaret du får:

“Nei.”

Du gir ikke opp og finner navnet på noen du vet har jobbet med systemet på et tidspunkt — du forsøker igjen:

“Hei, jeg hører du har jobbet med LegacyAuthService og kanskje kan hjelpe meg.”

“Hei, jeg er på ferie frem til 10. august!”

Dette er kanskje relaterbart for flere, spesielt om du har vært innom større organisasjoner med mye legacy kode og systemer.

Hvem eier tjenesten? Er den dokumentert noe sted? Er dokumentasjonen på en Confluence-side fra 2019? Har brukeren som sist oppdaterte dokumentasjonen sluttet i bedriften?

Problemer som dette er gjerne overkommelig i en mindre bedrift med 10 ansatte, men det blir fort et problem med 100.

Men hva om all denne informasjonen kunne vært samlet på ett sted?

Utviklerportal

En utviklerportal, også gjerne kalt applikasjonskatalog, er en portal som samler oversikt over alle interne tjenester, team og dokumentasjon — og informasjon om hvem som eier hva.

Ett eksempel på dette er Backstage!

Skjermbilde fra demovisning av Backstage

Spotify opplevde selv flere av problemene tidligere nevnt. De vokste i et høyt tempo, hadde hundrevis av tjenester og ansatte opp til 1000 nye utviklere i året. For å prøve å holde oversikt over systemene de hadde internt, brukte de spreadsheets, men de ble fort utdaterte og uoversiktlige.

Backstage ble originalt laget som et internt verktøy til å samle all denne informasjonen på en oversiktlig måte, men ble i 2020 gjort open source og donert til Cloud Native Computing Foundation. Det har i dag et rikt økosystem med plugins som dekker de fleste behov man har.

Backstage: From Spreadsheet to Standard | A CNCF Documentary

I tillegg til å vise oversikt over tjenester, team, dokumentasjon og relasjonene mellom dem, har Backstage også innebygget støtte for flere andre funksjonaliteter, blant annet:

• Software templates — lar deg definere prosjektmaler med riktig CI, mappestruktur, linting og annet. Alle prosjekter følger samme standard fra start.
• Tech Radar — gir oversikt over teknologier, metodikker og rammeverk organisasjonen bruker, vurderer eller faser ut.
• CI/CD-integrasjoner — integrasjoner mot GitHub actions, Jenkins og annet — viser byggstatus og deployments
• API-oversikt — hvilke APIer en tjeneste eksponerer og hvem som bruker dem

Jeg har selv sett på dette i praksis. Da jeg var på prosjekt hos Statens vegvesen, ble Backstage utforsket som en løsning, og jeg fikk se hvordan Kartverket brukte det internt — blant annet for teamoversikt og sikkerhetskanning via plugins.

Det er også verd å nevne at Backstage er et rammeverk, ikke et ferdig produkt. Det krever ressurser for å sette opp og vedlikeholde, og det er viktig å sørge for at noen tar eierskap til katalogen, samt skape en kultur for at team holder den oppdatert. Om man ikke tar stilling til disse problemene, risikerer man at man sitter med nok en “død” tjeneste i organisasjonen.

Backstage er mest utbredt, men det finnes også andre alternativer av utviklerportaler som Port, Atlassian Compass, Cortex og Roadie (som er bygget på Backstage).

Så kan man til slutt stille seg spørsmålet om dette er noe som kunne vært nyttig å ha på din arbeidsplass.