Repository

Hvad det er

Et repository, i daglig tale som regel forkortet repo og på dansk også kaldt et lager, er det sted, hvor et versionsstyringssystem holder hele optegnelsen over et projekt: hver registreret tilstand af hver fil, hvem der lavede hver ændring og hvorfor, og de navne, der fører ind i historikken. Filerne, man redigerer, er én visning af det; repositoryet er alt det, der ligger bag visningen.

Git definerer ordet ret præcist i sin egen ordliste: en samling refs sammen med en objektdatabase, der indeholder alle de objekter, som kan nås fra de refs. Begge halvdele er værd at folde ud. Objektdatabasen rummer indholdet. Hver version af en fil, hver mappeoversigt og hvert commit lægges ind som et objekt og navngives efter en hash af indholdet, hvilket Git-bogen beskriver som et indholdsadresseret filsystem: et nøgle-værdi-lager, hvor nøglen beregnes ud fra værdien. To ens filer er ét objekt, og enhver ændring, hvor lille den end er, giver et nyt navn. Refs er den menneskelige side: grene og tags, korte navne, der hver peger på ét commit og giver folk en vej ind.

De fleste repositories, folk arbejder i, har et arbejdstræ knyttet til sig. Filerne, man åbner i en editor, ligger i projektmappen, og selve repositoryet bor ved siden af dem i en skjult .git-mappe. Et bart repository har slet intet arbejdstræ. Mappens navn ender efter konvention på .git, den rummer kun historikken, og det er den form, en server holder, fordi filerne dér aldrig redigeres; folk pusher til den og henter fra den. Gits ordliste siger det samme: dem, der udgiver offentlige repositories, stiller som regel bare repositories til rådighed. Git-bogen viser, hvordan man laver et ud fra et eksisterende projekt med git clone --bare my_project my_project.git.

Kloning er stedet, hvor Gits design viser sig. En klon modtager næsten alle de data, serveren har: som standard kommer hver version af hver fil i hele projektets historik med. Hver klon er derfor et komplet repository, der kan træde i serverens sted, hvis serveren går tabt. Undtagelserne er små, men de betyder noget, og Git-bogen nævner dem: hooks på serversiden og lignende indstillinger bliver tilbage.

To varianter dukker ofte op. Et shallow repository, lavet ved at klone med --depth, beholder kun de nyeste commits; ordlisten siger, at de ældre forældre er »cauterized away«, skåret bort, og historikken kan senere gøres dybere med en fetch. Et submodule er et repository inde i et andet, med sin egen historik, som det ydre repository låser fast til ét bestemt commit.

Hvorfor det betyder noget

Et repository er projektets hukommelse. Når en linje kode ser forkert ud, fortæller historikken, hvornår den kom, i hvilket commit og med hvilken forklaring. Det er kun så godt som de commits, folk skriver, og derfor sætter teams, der holder af deres historik, regler for commit-beskeder og håndhæver dem med hooks frem for god vilje.

Det er også den enhed, det meste værktøj arbejder på. Adgang tildeles pr. repository, hooks kører pr. repository, og kontinuerlig integration starter som regel fra ét. Når man trækker grænsen for et repository, har man trukket grænsen for, hvad én gennemgang, ét tjek og én tilladelse dækker.

Repositories beholder det, de får. Et commit, der sletter en fil, tilføjer en ny tilstand; alle tidligere tilstande bliver liggende, i hver klon, der allerede har dem. Den varighed er hele pointen med versionsstyring, og den skærer begge veje: en gammel version kan altid hentes frem igen, og det kan en adgangskode, som nogen har committet ved en fejl, også.

Endelig kan et repository rumme langt mere end applikationskode. Infrastrukturdefinitioner, dokumentation og konfiguration får det samme ud af det: en historik, et gennemgangstrin og en måde at genopbygge en kendt tilstand på. En server, hvis opsætning ligger i et repository, kan genopbygges af en, der aldrig har set den.

Sådan ser det ud i praksis

Fire repositories bygget over atten måneder af én person deler én commit-standard: et konventionelt præfiks, der navngiver ændringens art, et virkefelt, en emnelinje under en fast længde, ingen emojis og ingen tilskrivningslinjer. En hook på commit-beskeden afviser alt, der bryder den, i hvert repository, der bærer arbejde, og det gør standarden til en egenskab ved repositoryet frem for ved den, der committer. Historikken viser så, hvad arbejdet var. I det største repository står der 156 funktions-commits, 133 rettelser, 128 dokumentation, 81 husholdning, 26 omskrivninger, 20 stil, 5 ydeevne og 3 test. Siden nævner også grænsen: formatet tjekkes, og indholdet gør ikke.

Virksomhedens eget miljø, en webtilstedeværelse, en git-forge, en database, sikkerhedskopier, mailtransport og DNS, skulle beskrives i et repository frem for i et hoved. I repositoryet ligger 19 playbooks og 34 roller, i alt 12.065 linjer YAML. Hver tier-gruppe har sine egne variabler, og de erklærer, hvilke roller gruppens værter kører. En konvergeret vært rapporterer nul ændringer, og miljøet kan reproduceres fra repositoryet. Prisen står der også: hver ændring er langsommere at lave end at redigere en fil på serveren, og et preflight-play blev senere sat foran konvergeringen.

Et repository husker også det, der kom med, mens opmærksomheden var et andet sted. Arbejde for en anden virksomhed kørte med gennem en omstrukturering af repositoryet, blandt andet en kladdelog med levende legitimationsoplysninger i klartekst, som lå i træet forbi hver eneste vagtpost gennem det meste af repositoryets historie. Intet af det kørte, og det er præcis derfor, det overlevede. Svaret blev en omfangsregel øverst i repositoryets instruktionssæt, én virksomheds infrastruktur og kun den, plus en karantæne i stedet for en sletning, så historikken forbliver læselig, mens hemmelighedsskanneren, boksvagten og emoji-tjekket stadig læser de filer, der ligger i karantæne.

Hvor det går galt

• En hemmelighed, der er committet én gang, overlever sin sletning. Når filen fjernes i næste commit, ligger den stadig i det forrige og i hver klon, der er lavet siden. Behandl legitimationsoplysningen som offentlig: skift den først, og afgør derefter, om det er forstyrrelsen værd at omskrive historikken for alle, der har en kopi.
• Et push rammer en udtjekket gren. Et push til et repository med arbejdstræ, hvis aktuelle gren er den, der opdateres, ville bringe arbejdstræet ud af trit med historikken, så Git afviser som standard et sådant push via receive.denyCurrentBranch. Et repository, folk pusher til, bør være bart.
• En shallow klon besvarer spørgsmål om historikken ud fra en del af den. En klon lavet med --depth har kun de nyeste commits, så git log, git blame og ethvert script, der udleder en version fra det seneste tag, ser kun det udsnit. Bygge- og udgivelsesjob, der har brug for fortiden, bør hente hele historikken.
• En lokal hook standser ved næste klon. Hooks på klientsiden ligger i .git/hooks, og Git-bogen siger klart, at en klon lader dem blive tilbage. En politik, der kun håndhæves dér, ophører den dag, nogen kloner på ny. Hold hook-scripts under versionsstyring i repositoryet og peg core.hooksPath på dem, eller håndhæv reglen på serversiden med pre-receive.
• Store binære filer gør hver klon større for altid. Fordi en klon bærer hver version af hver fil, bliver hver udskiftet kopi af en stor binær fil liggende i historikken, og hver ny klon henter dem alle.
• Filer, som intet kører, slipper uden om gennemgang. En deaktiveret opgave, en forældet inventarliste eller en kladdelog ligger stadig i hver klon, mens test, bygning og udrulning går uden om den. Repositoryets indhold bør høre til det, projektet har ansvar for, og alt andet bør fjernes eller sættes til side, hvor vagtposterne stadig kan se det.

Læs mere

• gitglossary: repository — Gits egen definition, side om side med bare repository, worktree, shallow repository og submodule.
• Getting a Git Repository — de to måder at få et på, at starte forfra i en mappe eller at klone, og hvad en klon henter ned.
• Git Objects — hvordan objektdatabasen lægger indhold ind under en hash af selve indholdet.
• gitrepository-layout — hvad hver fil og mappe inde i et repository bruges til.
• Getting Git on a Server — sådan gøres et eksisterende repository til et bart og deles.
• Git Hooks — hooks på klient- og serversiden, og hvorfor en klon lader dem på klientsiden blive tilbage.