{"canonical_url":"https://engineer.company/nb/glossary/forge/","content_markdown":"# Forge\n\n## Hva det er\n\nEn forge, også kalt programvareforge, kodeforge eller git-forge, er den serveren et team har blitt\nenige om å regne som hjemmet til repoene sine, sammen med tjenestene den kjører rundt dem. Hver\nfullstendige klone av et git-repo bærer hele historikken, så i prinsippet står ingen kopi over en\nannen. I praksis trenger teamet likevel ett sted å pushe til, ett sted som bestemmer hvem som får\nlese og skrive, og ett sted der samtalen om koden foregår. Det stedet er forgen.\n\nUnder overflaten lagrer en forge nakne repoer, den formen som bare inneholder historikken og ingen\nutsjekkede filer, og den snakker én eller flere av gits overføringsprotokoller. Boka Pro Git lister\nopp fire: den lokale protokollen for en mappe på samme maskin, HTTP, SSH og gits egen protokoll, en\ndaemon på port 9418 helt uten autentisering. Alt annet bygges oppå, og hvor mye som bygges, varierer\nkraftig.\n\nDokumentasjonen til Forgejo beskriver den fulle enden av skalaen: saksoppfølging, pull requests, en\ninnebygd wiki, et pakkeregister for mange språkøkosystemer, Forgejo Actions for å kjøre jobber,\nspeiling av repoer, migrering fra andre tjenester, beskyttelse av grener og tagger, og webhooks.\nSoft Serve ligger i motsatt ende. Prosjektet beskriver seg selv som en git-server for kommandolinjen\nsom du kan drifte selv: én binærfil kalt `soft` som serverer repoer over SSH, HTTP eller\ngit-protokollen, styrer tilgang med offentlige SSH-nøkler og støtter samarbeidspartnere, private\nrepoer og webhooks. Begge er forger. Forskjellen ligger i hvor mye av teamets arbeid de prøver å\nromme.\n\nForgene har også begynt å snakke med hverandre. ForgeFed er en føderasjonsprotokoll for plattformer\nder programvareprosjekter ligger og utvikles i fellesskap, bygd som en utvidelse av ActivityPub. Den\nmodellerer repoer, sakssystemer, patch-sporere, prosjekter og team som aktører som sender\naktiviteter til hverandre. Målet er et felles språk på tvers av nettverk av forger og verktøy for\nprosjektstyring, slik at en person på én server kan opprette en sak mot et repo på en annen, og slik\nat et repo kan flytte mellom servere mens den gamle kopien arkiveres som skrivebeskyttet og peker\nvidere til det nye hjemmet.\n\n## Hvorfor det er viktig\n\nForgen er stedet der regler faktisk kan håndheves. En regel som bor på en utviklers maskin, gjelder\nbare så lenge den maskinen er satt opp riktig, mens en hook på serveren kjører ved hver eneste push.\nGits `pre-receive`-hook leser hver pushet ref som en gammel id, en ny id og et navn på standard\ninput. Avslutter den med en annen status enn null, blir ingen av refene oppdatert. Grenbeskyttelse,\npåkrevd kodegjennomgang og krav om signerte commits på de større forgene forfiner den samme ideen:\nden felles kopien avviser det teamet har blitt enige om ikke å ta imot.\n\nÅ velge forge er også å velge hvem som sitter på koden. En vertstjeneste tar driftskostnadene og\noppetiden, og til gjengjeld ligger koden, tilgangslisten og hver eneste diskusjon på noen andres\nmaskinvare og på noen andres vilkår. Selvhosting snur avveiningen. Begge valgene har en pris, og\nforskjellen betyr mest for en virksomhet som forteller kundene sine hvor dataene deres befinner seg.\n\nEn forge holder dessuten data som git selv ikke holder. Commits og tagger følger med hver klone,\nmens saker, gjennomgangstråder, tilgangslister og hooks på serversiden hører til forgen alene. Det\nskillet avgjør hva en sikkerhetskopi må dekke, og hva en flytting fra én forge til en annen må ta\nmed seg.\n\n## Slik ser det ut i praksis\n\nSelskapet drifter sin egen forge, og tre prosjekter på dette nettstedet viser hva det krevde.\n\nKildekoden lå tidligere hos en tredjeparts vertstjeneste, og prosjektet der\n[selskapets egen git-forge ble satt i drift](/nb/portfolio/your-code-on-your-own-hardware/)\ntar utgangspunkt i at å drive en forge betyr å drive en forge: autentisering, tilgangskontroll,\nlagring, sikkerhetskopier og et offentlig ansikt utad. Forgen er Soft Serve, én binærfil som styres\nav operativsystemet, valgt fordi den er SSH-først uten noe administrativt webgrensesnitt. Den er\nprivat som standard: anonym tilgang avvises, tilgang uten nøkkel avvises, og hvert deklarerte repo\ner merket som privat. SSH-lytteren binder seg bare til loopback-grensesnittet på port 23231 og nås\nutenfra via en jump host. En multiplekser som ville lagt HTTPS og git over SSH på én offentlig port,\ner skrevet og står avslått, fordi en lytter ingen bruker, er angrepsflate. Resultatet sies rett ut:\nselskapet hoster sin egen kode på sin egen maskinvare.\n\nRepoet til dette nettstedet bor der. Instruksjonene i det utpeker den selvhostede forgen, Soft Serve\nover SSH, som kanonisk remote, kaller den eldre kopien hos vertstjenesten et utdatert speil og slår\nfast at det ikke finnes noen hostet CI. Kvalitetsporten kjører lokalt og i git-hooks.\n\nEn hook på serversiden må testes i mottakermiljøet for en ekte Git-push, så\nhooken ble\n[prøvekjørt mot et ekte nakent repo og en ekte push](/nb/portfolio/rehearsed-the-forge-ci-hook-found-2-defects/)\nfør den fikk tillit. Prøvekjøringen oppretter et nakent repo, installerer hooken, kloner, committer,\npusher og kontrollerer både veien til godkjenning og veien til avvisning. Den fant to feil, og ingen\nav dem var synlige i selve filen. Den andre er den lærerike: git eksporterer en variabel som peker\npå repoets mappe når den kjører en hook, testsuiten hooken startet, arvet den, og nitten tester ble\nrøde på korrekt kode helt til miljøet ble tømt ved grensen. Siden nevner også sin egen grense:\ntvungne oppdateringer og sletting av grener er push-typer prøvekjøringen ikke bygger opp.\n\nAlt dette deler [én vert med én kjerne og 512 MB minne](/nb/portfolio/a-whole-company-on-one-small-server/) med alt annet selskapet gjør tilgjengelig offentlig, fra de sju TLS-domenene til onion-tjenesten, en Gemini-server, en Gopher-server og utestenging av inntrengere. Automatisering av sikkerhetskopiering er implementert separat; det er noe annet enn aktive sikkerhetskopier. En forge med webpanel ville ha vært enda en fast kjørende applikasjon innenfor dette budsjettet. Derfor ble plattformer med webpanel utelukket på designstadiet; på denne verten nådde tilgjengelig minne et lavpunkt på omtrent 310 MB av 464 i løpet av et dokumentert døgn med stikkprøvemålinger.\n\n## Hvor det går galt\n\nAnonyme besøkende får lesetilgang som standard på enkelte forger. Dokumentasjonen til Soft Serve\nsier at den fra start gir anonyme tilkoblinger skrivebeskyttet tilgang, styrt av to innstillinger,\n`anon-access` og `allow-keyless`. En privat forge setter den første til `no-access` og den andre til\n`false`, og resultatet er verdt å teste fra en maskin uten noen nøkkel lastet inn. Gits egen daemon\ner enda mer kontant: Pro Git påpeker at et repo den serverer, enten kan klones av alle eller ikke\nserveres i det hele tatt.\n\nEn hook som kaller git i en annen mappe, treffer feil repo. Under en push kjører git de mottakende\nhookene inne i det nakne repoet og eksporterer `GIT_DIR` og beslektede variabler, slik at\ngit-kommandoer i hooken finner det. Alt hooken starter, arver dem, også en testkjøring i en\nutsjekking et helt annet sted. Manualsiden githooks sier at disse variablene skal tømmes før du\narbeider i et fremmed repo. En minimal `pre-receive`-hook som tester hver pushet commit i en\nmidlertidig mappe, gjør det i et subshell:\n\n```sh\nwhile read -r _ newrev _; do\n  git cat-file -e \"$newrev^{commit}\" 2\u003e/dev/null || continue\n  tree=$(mktemp -d)\n  git archive \"$newrev\" | tar -x -C \"$tree\"\n  (\n    unset $(git rev-parse --local-env-vars)\n    cd \"$tree\" \u0026\u0026 ./run-tests\n  ) || exit 1\ndone\n```\n\nEn gjenopprettet forge kommer tilbake med koden og uten reglene sine. Hvilken som helst klone kan\nfylle repoene på en tapt server igjen, men Pro Git advarer om at hooks på serversiden og lignende\ninnstillinger blir igjen, og saker, gjennomganger, nøkler og tilgangslister var aldri med i klonene.\nÅ ta sikkerhetskopi av en forge betyr å kopiere både datamappen og konfigurasjonen, så gjenopprette\nbegge et annet sted og sjekke at en push hooken skal avvise, faktisk blir avvist.\n\nHver lytter en forge åpner, er noe som må forsvares. Eksempelkonfigurasjonen til Soft Serve har SSH\npå port 23231, HTTP på 23232, git-daemonen på 9418 og en statistikkserver på 23233. Et team som bare\npusher over SSH, kan slå av resten eller binde dem til loopback, slik at de åpne portene ikke blir\nflere enn det som faktisk brukes.\n\nEn flytting til en annen forge tar med koden og lar samtalen bli igjen. En speilpush kopierer hver\nref under `refs/`, grener og tagger inkludert, og det er alt den kopierer. Saker,\ngjennomgangstråder, etiketter og tilgangslister krever migreringsverktøyet til den nye forgen, eller\nen protokoll som ForgeFed, som kopierer commits, tagger, saker, merge requests og kommentarer og lar\ndet gamle repoet stå arkivert med en peker til det nye.\n\n## Les mer\n\n- [ForgeFed-spesifikasjonen](https://forgefed.org/spec/) — føderasjonsprotokollen for forger, med\n  aktørene, aktivitetene og flyttingen som arkiverer et gammelt repo.\n- [Soft Serve](https://github.com/charmbracelet/soft-serve) — prosjektets egen dokumentasjon for en\n  SSH-først git-server i én binærfil, med innstillingene `anon-access` og `allow-keyless`.\n- [Forgejo-dokumentasjonen](https://forgejo.org/docs/latest/) — veiledninger for administratorer og\n  brukere av en fullverdig selvhostet forge, fra installasjon og sikkerhetskopier til Actions og\n  speiling.\n- [githooks](https://git-scm.com/docs/githooks) — alle hookene git kjører, blant dem `pre-receive`,\n  og miljøet en push-hook arver.\n- [The Protocols](https://git-scm.com/book/en/v2/Git-on-the-Server-The-Protocols) — de fire måtene\n  git flytter data mellom maskiner på, og hva hver av dem koster i oppsett og sikkerhet.\n- [ActivityPub](https://www.w3.org/TR/activitypub/) — W3C-anbefalingen som ForgeFed utvider.\n\n\u003chttps://engineer.company/nb/glossary/forge/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Hva en forge legger til utover selve repoene, hvor liten den kan være, og hva som svikter når dere drifter teamets felles kodekopi selv.","formats":{"gemtext":"https://engineer.company/nb/glossary/forge/index.gmi","gopher":"https://engineer.company/nb/glossary/forge/gophermap","html":"https://engineer.company/nb/glossary/forge/","json":"https://engineer.company/nb/glossary/forge/index.json","markdown":"https://engineer.company/nb/glossary/forge/index.md","pdf":"https://engineer.company/nb/glossary/forge/index.pdf"},"kind":"page","language":"nb","title":"Hva er en forge?","url":"https://engineer.company/nb/glossary/forge/","version":1}