{"canonical_url":"https://engineer.company/da/glossary/forge/","content_markdown":"# Forge\n\n## Hvad det er\n\nEn forge, også kaldet en softwareforge, en kodeforge eller en git-forge, er den\nserver, et team aftaler at behandle som hjemsted for sine repositories, sammen\nmed de tjenester, den kører omkring dem. Enhver fuld klon af et Git-repository\nbærer hele historikken, så i princippet står ingen kopi over en anden. I praksis\nhar et team brug for ét sted at pushe til, ét sted, der afgør, hvem der må læse\nog skrive, og ét sted, hvor samtalen om koden foregår. Det sted er forgen.\n\nNedenunder opbevarer en forge bare repositories, den form, der kun rummer\nhistorikken og ingen udtjekkede filer, og den taler en eller flere af Gits\noverførselsprotokoller. Git-bogen nævner fire: den lokale protokol til en mappe\npå samme maskine, HTTP, SSH og Gits egen protokol, en dæmon på port 9418 helt\nuden autentificering. Alt andet bygges ovenpå, og mængden varierer betydeligt.\n\nForgejos dokumentation beskriver den fulde ende af skalaen: issue-sporing, pull\nrequests, en indbygget wiki, et pakkeregister til mange sprogøkosystemer,\nForgejo Actions til at køre jobs, spejling af repositories, migrering fra andre\ntjenester, beskyttelse af grene og tags samt webhooks. Soft Serve ligger i den\nanden ende. Projektet beskriver sig selv som en Git-server til kommandolinjen,\nsom man kan hoste selv: en enkelt binærfil ved navn `soft`, der serverer\nrepositories over SSH, HTTP eller Git-protokollen, styrer adgang med offentlige\nSSH-nøgler og understøtter samarbejdspartnere, private repositories og webhooks.\nBegge er forges; forskellen er, hvor meget af teamets arbejde de forsøger at\nrumme.\n\nForges er også begyndt at tale sammen. ForgeFed, en føderationsprotokol for\nplatforme til hosting af og samarbejde om softwareprojekter, bygget som en\nudvidelse af ActivityPub, modellerer repositories, ticket-trackere,\npatch-trackere, projekter og teams som aktører, der sender aktiviteter til\nhinanden. Målet er et fælles sprog på tværs af netværk af forges og værktøjer\ntil projektstyring, så en person på én server kan oprette en ticket mod et\nrepository på en anden, og så et repository kan flytte mellem servere, mens den\ngamle kopi arkiveres som skrivebeskyttet og peger på sit nye hjem.\n\n## Hvorfor det betyder noget\n\nForgen er stedet, hvor regler kan håndhæves. En regel, der bor på en udviklers\nmaskine, gælder kun, så længe den maskine er sat korrekt op, men en hook på\nserveren kører ved hvert push. Gits `pre-receive`-hook læser hver pushet ref som\net gammelt id, et nyt id og et navn på standard input, og afslutter den med en\nstatus forskellig fra nul, bliver ingen refs opdateret. Grenbeskyttelse, krævede\nreviews og krav om signerede commits på større forges forfiner samme idé: den\nfælles kopi afviser det, teamet har aftalt ikke at tage imod.\n\nAt vælge en forge er også at vælge, hvem der har koden. En hostet tjeneste\npåtager sig driftsomkostningerne og oppetiden, og til gengæld ligger koden,\nadgangslisten og hver eneste diskussion på en andens hardware og på en andens\nvilkår. Selvhosting vender byttehandlen om. Begge valg har en pris, og\nforskellen betyder mest for en virksomhed, der fortæller sine kunder, hvor deres\ndata befinder sig.\n\nEn forge rummer også data, som Git ikke rummer. Commits og tags følger med hver\nklon, mens issues, review-tråde, adgangslister og hooks på serversiden alene\ntilhører forgen. Den opdeling afgør, hvad en backup skal dække, og hvad en\nflytning mellem forges skal have med.\n\n## Sådan ser det ud i praksis\n\nVirksomheden kører sin egen forge, og tre projekter på dette site viser, hvad\ndet krævede.\n\nVirksomhedens kildekode lå tidligere hos en tredjeparts hostingtjeneste, og\nprojektet, hvor\n[virksomhedens egen git-forge blev sat i drift](/da/portfolio/your-code-on-your-own-hardware/),\ntager udgangspunkt i, at det at køre en forge betyder at køre en forge:\nautentificering, adgangskontrol, lagring, backups og et offentligt ansigt\nudadtil. Forgen er Soft Serve, en enkelt binærfil overvåget af styresystemet og\nvalgt, fordi den er SSH-først uden administrativ webgrænseflade. Den er privat\nsom standard: anonym adgang afvises, adgang uden nøgle afvises, og hvert\nerklæret repository er markeret som privat. SSH-lytteren binder kun til\nloopback-grænsefladen på port 23231 og nås udefra gennem en jump host. En\nmultiplexer, der ville lægge HTTPS og git over SSH på én offentlig port, er\nskrevet og står slået fra, fordi en lytter, som ingen bruger, er angrebsflade.\nResultatet siges ligeud: virksomheden hoster sin egen kode på sin egen hardware.\n\nDette sites eget repository bor der: dets instruktioner udpeger den selvhostede\nforge, Soft Serve over SSH, som det kanoniske remote, kalder den ældre hostede\nkopi et forældet spejl og siger, at der ikke findes hostet CI. Kvalitetsporten\nkører lokalt og i git-hooks.\n\nEn hook på serversiden skal testes i modtagermiljøet for et rigtigt\nGit-push, så hooken blev\n[øvet mod et rigtigt bare repository og et rigtigt push](/da/portfolio/rehearsed-the-forge-ci-hook-found-2-defects/),\nfør den fik tillid. Øvelsen opretter et bare repository, installerer hooken,\nkloner, committer, pusher og kontrollerer både vejen til accept og vejen til\nafvisning. Den fandt to fejl, og begge var usynlige i filen. Den anden er den\nlærerige: Git eksporterer en variabel med repositoryets mappe, når den kører en\nhook, testsuiten, som hooken startede, arvede den, og nitten test gik røde på\nkorrekt kode, indtil miljøet blev ryddet ved grænsen. Siden nævner også sin\ngrænse: tvungne opdateringer og sletning af grene er push, som øvelsen ikke\nkonstruerer.\n\nAlt dette deler\n[én værtsmaskine med én kerne og 512 MB hukommelse](/da/portfolio/a-whole-company-on-one-small-server/)\nmed alt det andet, virksomheden stiller til rådighed offentligt,\nfra de syv TLS-domæner til onion-tjenesten, en Gemini- og en\nGopher-server og blokering af indtrængningsforsøg. Automatisering af\nsikkerhedskopiering er implementeret separat; det er noget andet\nend aktive sikkerhedskopier. En forge med et webpanel ville have\nværet endnu en fast kørende applikation på det budget, og derfor\nblev platforme med webpanel fravalgt allerede på designstadiet;\npå den vært nåede den tilgængelige hukommelse sit lavpunkt på omkring\n310 MB af 464 over et registreret døgns stikprøver.\n\n## Hvor det går galt\n\nAnonyme besøgende får læseadgang som standard på nogle forges. Soft Serves\ndokumentation siger, at den fra start giver anonyme forbindelser skrivebeskyttet\nadgang, styret af to indstillinger, `anon-access` og `allow-keyless`. En privat\nforge sætter den første til `no-access` og den anden til false, og resultatet er\nværd at teste fra en maskine uden indlæst nøgle. Gits egen dæmon er mere\nkontant: Git-bogen bemærker, at et repository, den serverer, enten kan klones af\nalle eller slet ikke serveres.\n\nEn hook, der kalder Git i en anden mappe, rammer det forkerte repository. Under\net push kører Git de modtagende hooks inde i det bare repository og eksporterer\n`GIT_DIR` og beslægtede variabler, så Git-kommandoer i hooken finder det. Alt,\nhvad hooken starter, arver dem, også en testkørsel i en udtjekning et andet\nsted. Manualen til githooks siger, at variablerne skal ryddes, før man arbejder\ni et fremmed repository. En minimal `pre-receive`-hook, der tester hvert pushet\ncommit i en midlertidig mappe, gør det i en 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 gendannet forge kommer tilbage med sin kode og uden sine regler. Enhver klon\nkan genbefolke en tabt servers repositories, men Git-bogen advarer om, at hooks\npå serversiden og lignende indstillinger bliver tilbage, og issues, reviews,\nnøgler og adgangslister var aldrig i klonerne. Backup af en forge betyder backup\naf dens datamappe og dens konfiguration, derefter en gendannelse af begge et\nandet sted og en kontrol af, at et push, som hooken skal afvise, faktisk bliver\nafvist.\n\nHver lytter, en forge åbner, skal forsvares. Soft Serves eksempelkonfiguration\nhar SSH på port 23231, HTTP på 23232, Git-dæmonen på 9418 og en statistikserver\npå 23233. Et team, der kun pusher over SSH, kan slå resten fra eller binde dem\ntil loopback, så de åbne porte svarer til det, der faktisk bruges.\n\nEn flytning til en anden forge tager koden med og efterlader samtalen. Et\nspejl-push kopierer hver ref under `refs/`, grene og tags medregnet, og det er\nalt, det kopierer. Issues, review-tråde, labels og adgangslister kræver den nye\nforges migreringsværktøj eller en protokol som ForgeFeds, der kopierer commits,\ntags, tickets, merge requests og kommentarer og efterlader det gamle repository\narkiveret med en henvisning til det nye.\n\n## Læs mere\n\n- [ForgeFed-specifikationen](https://forgefed.org/spec/) —\n  føderationsprotokollen for forges med dens aktører, dens aktiviteter og den\n  flytning, der arkiverer et gammelt repository.\n- [Soft Serve](https://github.com/charmbracelet/soft-serve) — projektets egen\n  dokumentation for en SSH-først Git-server i én binærfil, herunder\n  indstillingerne `anon-access` og `allow-keyless`.\n- [Forgejo-dokumentationen](https://forgejo.org/docs/latest/) — vejledninger til\n  administratorer og brugere af en selvhostet forge med alle funktioner, fra\n  installation og backups til Actions og spejle.\n- [githooks](https://git-scm.com/docs/githooks) — alle de hooks, Git kører,\n  herunder `pre-receive` og det miljø, en push-hook arver.\n- [The Protocols](https://git-scm.com/book/en/v2/Git-on-the-Server-The-Protocols)\n  — de fire måder, Git flytter data mellem maskiner på, og hvad hver af dem\n  koster i opsætning og sikkerhed.\n- [ActivityPub](https://www.w3.org/TR/activitypub/) — W3C-anbefalingen, som\n  ForgeFed udvider.\n\n\u003chttps://engineer.company/da/glossary/forge/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Hvad en forge lægger oven på de repositories, den serverer, hvor lille den kan være, og hvor det bider at hoste den fælles kopi af koden selv.","formats":{"gemtext":"https://engineer.company/da/glossary/forge/index.gmi","gopher":"https://engineer.company/da/glossary/forge/gophermap","html":"https://engineer.company/da/glossary/forge/","json":"https://engineer.company/da/glossary/forge/index.json","markdown":"https://engineer.company/da/glossary/forge/index.md","pdf":"https://engineer.company/da/glossary/forge/index.pdf"},"kind":"page","language":"da","title":"Hvad er en forge?","url":"https://engineer.company/da/glossary/forge/","version":1}