Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Page Properties

Status

Status
colourGreen
titleopenCLOSED

Impact

Status
colourRed
titleHigh

Driver

ola.enebro (Unlicensed)

Approver

Per Persson

Contributors

Martin Hansson (Unlicensed)

Informed

Due date

Resources

Outcome

Vi går på Option 2, men ambition att nå option 1 över tid. Se nedan.

\uD83D\uDCD8 Bakgrund

I Confluence finns en övergripande beskrivning för hur vi kan hantera öppen källkod inom Sundsvalls kommun i allmänhet och Utvecklingsfabriken i synnerhet. Dock finns några viktiga beaktanden att göra när det kommer till hur vi delar källkoden (med tillbehör) öppet. Se uppställning nedan.

En annan viktig frågeställning vi behöver ta ställning till är för vilket syfte vi ska tillgängliggöra källkoden för våra tjänster.

  1. Att tillgängliggöra koden för att andra ska kunna bidra i utvecklingen enligt klassisk open source-modell.

  2. Att vi delar med oss av det färdiga resultatet av respektive tjänst vi vill dela med oss av. Dock på ett sånt sätt att vi kan begränsa vad som delas publikt för att säkerställa att känsliga uppgifter inte sprids.

🤝 Beroenden

Oavsett alternativ som väljs behöver Utvecklingsfabrikens SpringBoot-ramverk (a.k.a. Dept44) finnas publikt tillgängligt för den som vill bygga något utifrån den öppna källkoden. Bör inte vara några konstigheter.

...

Option 1

Option 2

Helt öppet Vi låter våra repositories i GitHub vara helt öppna och publika. Självklart att vi då lägger känsliga uppgifter, i den mån det går, som lösenord etc i separat konfigurationsrepo i GitLab. Och vi låter naturligtvis inte vem som helst att committa in saker till ett publikt repository.

Gliffy
imageAttachmentIdatt1093959721
macroId5b7f66be-0cab-489d-a3c7-411fb1f12b63
baseUrlhttps://sundsvall.atlassian.net/wiki
nameOption 1 - public repository
diagramAttachmentIdatt1093468230
containerId1090682881
timestamp1662461406698

Privat & publikt Vi skiljer på publikt och privat genom att ha separata repositories där kod från det privata på lämpligt sätt kan speglas till det publika. O-öppet alltså. Vi jobbar i privata repositoryn, varifrån vi även bygger och deployar. Det är ett aktivt val att “publicera” kod från ett privat till publikt repository.

Känsliga uppgifter återfinns i GitLab och de som inte kan finnas där ska kunna filtreras bort i samband med publicering till publikt repository.

Kan merge från main till en branch som heter “public” i det privata repositoryt vara det som något ett jobb i Jenkins ska gå på för att kunna skyffla rätt saker (mha shallow clone etc) till det publika repositoryt?

Gliffy
imageAttachmentIdatt1093894178
macroId31f4acd1-f52a-4bf2-a9a3-452aba1af0bc
baseUrlhttps://sundsvall.atlassian.net/wiki
displayNameOption 2 - private repository
nameOption 2
diagramAttachmentIdatt1093959713
containerId1090682881
timestamp1662460962007

Pros/cons

(plus) Enkelt. Det vi pushar in till GitHub blir tillgängligt för alla.

(minus) Varje enskild utvecklare behöver vara noggrann och se till att oönskad information inte kommer med då det är begränsat med kontrollfunktioner innan något de facto hamnar i repot. Mänskliga faktorn kan spela in.

(minus) Risk att personuppgifter (framförallt i testdata) slinker med och blir publika.

(minus) Risk att keystores med certifikat slinker med och blir publika.

⚠️ Potentiellt hög säkerhetsrisk om känslig information slinker med.

(plus) Möjlighet att begränsa vilka delar av det privata repositoryt som speglas ut till det publika. Se exempelvis https://github.com/open-condo-software/gitexporter

(plus) Möjlighet att förhindra att oönskad historik slipper kommer med med hjälp av “shallow clone” då det enbart är skillnaden mellan respektive “publicering” som är önskvärd i det publika repositoryt. Minskar risk för att “fulkod” kommer med (även om vi naturligtvis aldrig fulkodar något, någonsin…).

(plus) Möjlighet att automatisera (förslagsvis via Jenkins) publicering till publikt repository, även om det bör vara ett aktivt val att faktiskt publicera ut något till ett publikt repositorygöra det. Det här steget möjliggör också att införa kontroller för att förhindra att oönskad information slinker med.

(minus) Mer komplex uppsättning.

(minus) Kräver dubbla repositoryn.

(minus) Oklart hur arbetsflödet bäst sätts upp för att åstadkomma detta.

⚠️ Kräver ändå att det privata repositoryt sätts upp på rätt sätt (katalogstrukturer etc) så att känslig information ska kunna filtreras bort på ett vettigt sätt.

✅ Action items

  •  Vad blir följden av att personnummer eller personuppgifter “läckt”? Viten?
  •  För varje certifikat vi har måste vi ha färdiga rutiner för att invalidera och beställa nya certifikat.

\uD83C\uDF1F Outcome

Ja, vad blev det?Beslutet är att interimistiskt gå på Option 2, med ambitionen att nå enkelheten (helautomatiserat) i Option 1 över tid. Men det kräver att vi vet mer om möjligheterna i kommande OpenShift-uppsättning etc. Med OpenShift finns till exempel möjligheter att separera kod från certifikat och (förhoppningsvis) keystores.

Beslutet är också att tillhandahålla Dept44 publikt i form av en nedladdningsbar JAR-fil.