{"canonical_url":"https://engineer.company/sv/glossary/forge/","content_markdown":"# Forge\n\n## Vad det är\n\nEn forge, på engelska även software forge eller code forge och i vardagligt tal ofta git-forge, är\nden server ett team utser till hemvist för sina repon, tillsammans med tjänsterna som körs runt\ndem. Git kräver ingen sådan server. Varje fullständig klon bär hela historiken, och tekniskt sett är\ningen kopia förmer än någon annan. Ett team behöver ändå ett ställe att pusha till, ett ställe som\navgör vem som får läsa och skriva och ett ställe där samtalet om koden förs. Det stället är forgen.\n\nUnder ytan lagrar en forge bare-repon, alltså repon som bara innehåller historiken och inga\nutcheckade filer, och den talar ett eller flera av gits överföringsprotokoll. Git-projektets bok\nräknar upp fyra: det lokala protokollet mot en katalog på samma maskin, HTTP, SSH och gits eget\nprotokoll, en daemon på port 9418 helt utan autentisering. Allt annat byggs ovanpå, och hur mycket\nsom byggs skiljer sig kraftigt.\n\nForgejos dokumentation visar den fullt utbyggda änden av skalan: ärendehantering, pull requests, en\ninbyggd wiki, ett paketregister för många språks ekosystem, Forgejo Actions för att köra jobb,\nspegling av repon, migrering från andra tjänster, skydd av grenar och taggar samt webhookar. Soft\nServe står i den andra änden. Projektet kallar sig en git-server för kommandoraden som man hostar\nsjälv: en enda binärfil, `soft`, som servar repon över SSH, HTTP eller git-protokollet, styr\nåtkomsten med publika SSH-nycklar och har stöd för medverkande, privata repon och webhookar. Båda\nräknas som forge. Det som skiljer dem är hur stor del av teamets arbete de försöker rymma.\n\nServrarna har också börjat tala med varandra. ForgeFed är ett federationsprotokoll för plattformar\nsom hostar och samordnar mjukvaruprojekt, byggt som en utvidgning av ActivityPub. Det beskriver\nrepon, ärendehanterare, patchhanterare, projekt och team som aktörer som skickar aktiviteter till\nvarandra. Målet är ett gemensamt språk i ett nätverk av forgar och projektverktyg: en person på en\nserver ska kunna öppna ett ärende mot ett repo på en annan, och ett repo ska kunna flytta mellan\nservrar medan den gamla kopian arkiveras som skrivskyddad och pekar vidare till sitt nya hem.\n\n## Varför det spelar roll\n\nDet är på forgen som en regel går att genomdriva. En regel som bor på en utvecklares dator gäller\nbara så länge den datorn är rätt uppsatt, medan en hook på servern körs vid varje push. Gits\n`pre-receive`-hook läser varje pushad referens som ett gammalt id, ett nytt id och ett\nreferensnamn på standard in. Avslutar den med en annan status än noll uppdateras ingen referens\nalls. Grenskydd, obligatorisk kodgranskning och krav på signerade commits hos de större forgarna är\nförfiningar av samma idé: den gemensamma kopian säger nej till det som teamet har bestämt att inte\nta emot.\n\nAtt välja forge är också att välja vem som håller koden. En hostad tjänst tar på sig driften och\nupptiden, och i gengäld ligger koden, åtkomstlistan och varje diskussion på någon annans hårdvara\noch på någon annans villkor. Att hosta själv vänder på den avvägningen. Båda vägarna kostar något,\noch skillnaden väger tyngst för ett företag som berättar för sina kunder var deras data finns.\n\nEn forge håller dessutom data som git inte håller. Commits och taggar följer med i varje klon, medan\närenden, granskningstrådar, åtkomstlistor och hookar på serversidan bara finns på forgen. Den\ngränsen bestämmer vad en säkerhetskopia måste omfatta och vad en flytt mellan två forgar måste få\nmed sig.\n\n## Så ser det ut i praktiken\n\nDen här webbplatsens kod ligger på en forge som företaget driver själv, och tre projekt visar vad\ndet krävde.\n\nKällkoden låg tidigare hos en extern värdtjänst. Projektet där\n[företaget driftsatte sin egen git-forge](/sv/portfolio/your-code-on-your-own-hardware/)\nutgår från att den som kör en forge också kör allt som hör till: autentisering, åtkomstkontroll,\nlagring, säkerhetskopior och ett ansikte utåt. Valet föll på Soft Serve, en enda binärfil som hålls\nigång av operativsystemet, eftersom den är byggd för SSH först och saknar administrativt\nwebbgränssnitt. Den är privat som standard. Anonym åtkomst nekas, åtkomst utan nyckel nekas och\nvarje deklarerat repo är markerat som privat. SSH-lyssnaren binder bara till loopback-gränssnittet\npå port 23231 och nås utifrån via en hoppserver. En multiplexer som skulle lägga HTTPS och git över\nSSH på en och samma publika port är skriven men avstängd, eftersom en lyssnare som ingen använder är\nattackyta. Resultatet sägs rakt ut: företaget hostar sin egen kod på sin egen hårdvara.\n\nWebbplatsens eget repo bor där. Repots instruktioner pekar ut den egenhostade forgen, Soft Serve\növer SSH, som kanonisk remote, kallar den äldre hostade kopian en kvarlämnad spegel och konstaterar\natt det inte finns någon hostad CI. Kvalitetsgrinden körs lokalt och i git-hookar.\n\nEn hook på serversidan behöver testas i den mottagande miljön för en riktig\nGit-push. Därför\n[provkördes hooken mot ett riktigt bare-repo och en riktig push](/sv/portfolio/rehearsed-the-forge-ci-hook-found-2-defects/)\ninnan den fick förtroende. Provkörningen skapar ett bare-repo, installerar hooken, klonar,\ncommittar, pushar och verifierar både vägen där pushen godtas och vägen där den avvisas. Den hittade\ntvå fel, och inget av dem syntes i filen. Det andra är det lärorika. När git kör en hook exporterar\ndet en variabel som pekar ut repots katalog, testsviten som hooken startade ärvde den, och nitton\ntester blev röda på korrekt kod tills miljön rensades vid gränsen. Sidan anger också sin egen\nbegränsning: tvingade uppdateringar och borttagna grenar är pushar som provkörningen inte\nkonstruerar.\n\nAllt detta delar [en enda värddator med en kärna och 512 MB\nminne](/sv/portfolio/a-whole-company-on-one-small-server/) med allt annat som\nföretaget tillhandahåller publikt, från de sju TLS-domänerna till\nonion-tjänsten, en Gemini- och en Gopher-server och spärrning av intrångsförsök.\nAutomatisering av säkerhetskopiering har implementerats separat; det är något\nannat än aktiva säkerhetskopior. En forge med webbpanel skulle ha varit\nytterligare en ständigt körande applikation inom den budgeten, vilket är skälet\ntill att plattformar med webbpanel valdes bort redan i designskedet; på den\nvärddatorn var den lägsta nivån för tillgängligt minne ungefär 310 MB av 464\nunder ett dokumenterat dygns stickprov.\n\n## Var det går fel\n\nAnonyma besökare får läsrätt som standard på vissa forgar. Soft Serves dokumentation anger att den\nfrån start ger anonyma anslutningar skrivskyddad åtkomst, styrd av två inställningar, `anon-access`\noch `allow-keyless`. En privat forge sätter den första till `no-access` och den andra till false,\noch resultatet är värt att testa från en maskin där ingen nyckel är laddad. Gits egen daemon känner\nbara till allt eller inget: enligt Git-projektets bok kan ett repo som den servar antingen klonas av\nalla eller inte servas alls.\n\nEn hook som anropar git i en annan katalog träffar fel repo. Under en push kör git de mottagande\nhookarna inne i bare-repot och exporterar `GIT_DIR` och närliggande variabler, så att git-kommandon\ni hooken hittar rätt. Allt som hooken startar ärver dem, även en testkörning i en utcheckning\nnågon annanstans. Manualen för githooks säger att variablerna ska rensas innan man arbetar i ett\nfrämmande repo. En minimal `pre-receive`-hook som testar varje pushad commit i en tillfällig katalog\ngör det i ett 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 återställd forge kommer tillbaka med sin kod men utan sina regler. Vilken klon som helst kan\nfylla en förlorad servers repon igen, men Git-projektets bok varnar för att hookar på serversidan\noch liknande inställningar stannar på den gamla maskinen, och ärenden, granskningar, nycklar och\nåtkomstlistor fanns aldrig i klonerna. Att säkerhetskopiera en forge betyder att säkerhetskopiera\ndess datakatalog och dess konfiguration, att återställa båda på en annan maskin och att kontrollera\natt en push som hooken ska avvisa faktiskt avvisas.\n\nVarje lyssnare som en forge öppnar måste försvaras. Soft Serves exempelkonfiguration har SSH på\nport 23231, HTTP på 23232, git-daemonen på 9418 och en statistikserver på 23233. Ett team som bara\npushar över SSH kan stänga av resten eller binda dem till loopback, så att de öppna portarna\nmotsvarar det som faktiskt används.\n\nEn flytt till en annan forge tar med koden och lämnar samtalet kvar. En spegelpush kopierar varje\nreferens under `refs/`, grenar och taggar inräknade, och mer än så kopierar den inte. Ärenden,\ngranskningstrådar, etiketter och åtkomstlistor kräver den nya forgens migreringsverktyg eller ett\nprotokoll som ForgeFed, som kopierar commits, taggar, ärenden, merge requests och kommentarer och\nlämnar det gamla repot arkiverat med en hänvisning till det nya.\n\n## Läs mer\n\n- [ForgeFed-specifikationen](https://forgefed.org/spec/) — federationsprotokollet för forgar, med\n  aktörerna, aktiviteterna och flytten som arkiverar ett gammalt repo.\n- [Soft Serve](https://github.com/charmbracelet/soft-serve) — projektets egen dokumentation för en\n  git-server i en enda binärfil med SSH först, inklusive `anon-access` och `allow-keyless`.\n- [Forgejo-dokumentationen](https://forgejo.org/docs/latest/) — handledningar för administratörer\n  och användare av en fullt utbyggd forge som man hostar själv, från installation och\n  säkerhetskopiering till Actions och speglar.\n- [githooks](https://git-scm.com/docs/githooks) — alla hookar som git kör, bl.a. `pre-receive`, och\n  miljön som en push-hook ärver.\n- [The Protocols](https://git-scm.com/book/en/v2/Git-on-the-Server-The-Protocols) — de fyra sätt\n  som git flyttar data mellan maskiner på, och vad vart och ett kostar i uppsättning och säkerhet.\n- [ActivityPub](https://www.w3.org/TR/activitypub/) — W3C-rekommendationen som ForgeFed bygger\n  ut.\n\n\u003chttps://engineer.company/sv/glossary/forge/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Vad en forge håller utöver koden, vad valet mellan hostad och egen avgör, och vilka inställningar som gör en privat forge publik.","formats":{"gemtext":"https://engineer.company/sv/glossary/forge/index.gmi","gopher":"https://engineer.company/sv/glossary/forge/gophermap","html":"https://engineer.company/sv/glossary/forge/","json":"https://engineer.company/sv/glossary/forge/index.json","markdown":"https://engineer.company/sv/glossary/forge/index.md","pdf":"https://engineer.company/sv/glossary/forge/index.pdf"},"kind":"page","language":"sv","title":"Vad är en forge?","url":"https://engineer.company/sv/glossary/forge/","version":1}