Git og Github

Git og GitHub er meget brugt i moderne softwareudvikling, uanset hvilket programmeringssprog der bruges. I C#-udvikling kan de være yderst effektive til at håndtere versionskontrol, samarbejde, og kode deling.

Git

Hvad er Git?

Git er et essentielt værktøj i moderne softwareudvikling, der fungerer som et avanceret versionskontrolsystem. Forestil dig at arbejde på et komplekst projekt, hvor du konstant tilføjer, ændrer og fjerner kode. Hvordan holder du styr på alle disse ændringer, og hvordan sikrer du, at du kan vende tilbage til en tidligere, velfungerende tilstand, hvis noget går galt?

Det er præcis det problem, Git løser. Git er et versionskontrolsystem, der systematisk sporer alle ændringer i dit projekt. Hver gang du gemmer en ny version af dit arbejde med en ‘commit’, opretter Git et ‘øjebliksbillede’ (snapshot) af hele dit projekt. Dette giver dig en række afgørende fordele:

• Historik og Gendannelse: Du får en komplet historik over alle ændringer, hvilket gør det muligt at gå tilbage til enhver tidligere version af din kode.
• Eksperimentering og Stabilitet: Du kan arbejde på nye funktioner eller rettelser i isolerede ‘grene’ (branches), uden at risikere stabiliteten i din hovedkodebase. Når arbejdet er færdigt og testet, kan det sikkert flettes ind i hovedprojektet.
• Effektivt Samarbejde: Git er designet til at gøre det nemt for flere udviklere at arbejde på det samme projekt samtidigt. Systemet hjælper med at håndtere og flette ændringer fra forskellige teammedlemmer.

Kort sagt er Git et fundamentalt værktøj, der sikrer kodens integritet, muliggør parallel udvikling og forenkler samarbejde. Selvom der er en indlæringskurve, er de grundlæggende funktioner i Git en kernekompetence for enhver udvikler.

Installation af Git

For at bruge Git skal du installere det på din computer. Git er tilgængelig for Windows, Mac og Linux. Du kan downloade den seneste version af Git fra Git’s officielle hjemmeside. Det er typisk allerede installeret på en Linux og Mac maskine, ligesom en Windows maskine brugt i undervisningslokaler også vil have det installeret. Alternativt kan downloade og installere det fra her til Windows. En installation til Windows vil typisk også installere Git Bash, som er en terminal til Windows, der giver en emulering af en Bash-oplevelse i en Windows-miljø.

Første gang du benytter git

Hvis det er første gang du benytter git på en maskine skal du tilføje et user name og email. I princippet er det underordnet hvad du skriver her hvis det kun er dig der bruger det pågældende repository, men du kan angive dine personlige oplysninger hvis du vil.

• Åbn en terminal
• Skriv følgende kommandoer:

git config --global user.name "Dit navn"
git config --global user.email "Din email"

Prøv det selv

Nu hvor du har en grundlæggende forståelse af, hvad Git er, er det tid til at prøve det i praksis. Følgende trin guider dig igennem oprettelsen af dit første lokale Git-repository. Alt, hvad vi gør her, foregår udelukkende på din egen computer.

1. Opret en projektmappe

Start med at oprette en ny, tom mappe til dit projekt. Du kan gøre dette via din stifinder eller i en terminal.

mkdir MitFoersteProjekt
cd MitFoersteProjekt

2. Initialiser Git

Nu skal vi fortælle Git, at denne mappe skal være et repository. Det gør du med kommandoen git init.

git init

Denne kommando opretter en skjult undermappe ved navn .git. Det er her, Git gemmer al sin magi: hele historikken og alle versioner af dit projekt. Du skal normalt aldrig røre ved filerne i denne mappe direkte.

3. Opret en .gitignore fil

Ofte har projekter filer, som vi ikke vil have med i versionsstyringen. Det kan være midlertidige filer, logfiler eller filer med personlige indstillinger (som obj og bin mapper i .NET). Til dette formål bruger vi en .gitignore fil.

Opret en fil ved navn .gitignore og tilføj navne på filer eller mapper, der skal ignoreres.

# Ignorer bygge-mapper fra .NET
/bin
/obj

4. Tilføj filer til ‘staging’ og lav et commit

Lad os nu oprette en fil og fortælle Git, at den skal spores.

Først, opret en fil:

echo "Hello, Git!" > readme.md

Nu har vi to nye filer: readme.md og .gitignore. Før vi går videre, er det en god idé at tjekke, hvad Git ser.

Tjek status:

git status

Du vil se output lignende dette:

On branch main

No commits yet

Untracked files:
  (use "git add <file>..." to include in what will be committed)
        .gitignore
        readme.md

nothing added to commit but untracked files present (use "git add" to track)

Git fortæller os, at der er to “untracked” filer - filer som Git endnu ikke holder øje med. For at inkludere dem i vores næste version (commit), skal vi først tilføje dem til et midlertidigt “staging area”. Det kan ses som en indkøbskurv, hvor du samler de ændringer, du vil gemme.

git add .

Lad os tjekke status igen:

git status

Nu vil du se:

On branch main

No commits yet

Changes to be committed:
  (use "git rm --cached <file>..." to unstage)
        new file:   .gitignore
        new file:   readme.md

Filerne er nu “staged” og klar til at blive committet. Bemærk at Git også fortæller dig, hvordan du kan fjerne filer fra staging hvis du fortryder.

Se præcis hvad der ændres:

Før du committer er det ofte nyttigt at se nøjagtigt hvad der er ændret. Det gør du med git diff:

git diff --staged

--staged flaget viser forskelle for filer, der er tilføjet til staging area. Du vil se noget lignende:

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..cbbd0b5
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,2 @@
+/bin
+/obj

diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..8d0e412
--- /dev/null
+++ b/readme.md
@@ -0,0 +1 @@
+Hello, Git!

Linjer der starter med + er nye linjer. Senere, når du ændrer eksisterende filer, vil du også se - for slettede linjer. Dette giver dig fuld kontrol over, hvad der er ved at blive committet.

Nu er vi klar til at gemme vores første version med git commit.

git commit -m "Første commit: Tilføjet readme og gitignore"

Tjek status en sidste gang:

git status

Du vil nu se:

On branch main
nothing to commit, working tree clean

Dette betyder, at alle dine ændringer er gemt i et commit, og der er ingen nye ændringer i din working directory.

Tillykke! Du har nu oprettet dit første lokale Git-repository og lavet dit første commit.

5. Lav en ændring og se historikken

En af de største styrker ved Git er at kunne spore ændringer over tid. Lad os prøve at ændre readme.md filen.

echo "En ekstra linje til readme." >> readme.md

Nu har vi en ændring. Vi følger samme procedure som før for at gemme den:

git add readme.md
git commit -m "Opdateret readme med en ekstra linje"

Nu har vi to commits i vores historik. For at se historikken kan du bruge kommandoen git log:

git log

Du vil nu se en liste over alle de commits, du har lavet, med den seneste øverst. Hver log-entry viser commit-ID (en lang hash-streng), forfatter, dato og commit-beskeden. Dette er dit projekts historie, og du kan altid vende tilbage til et af disse punkter.

Alt dit arbejde er stadig gemt sikkert på din egen computer. Senere kan du vælge at koble dette lokale repository til en fjern server som GitHub for at dele dit arbejde og samarbejde med andre.

Hvad er GitHub?

GitHub er en webbaseret platform for versionskontrol og samarbejde, der gør det muligt for udviklere at arbejde sammen om projekter. Mens Git er et kommandolinjeværktøj, leverer GitHub et webbaseret grafisk interface. Det giver også adgang til flere samarbejdsfunktioner, såsom opgavestyring, fejlsporing og projektstyring, samt funktioner, der bygger videre på Git. GitHub er ejet af Microsoft.

Arbejdsmåder i GitHub

GitHub tilbyder flere måder at arbejde med projekter på:

1. Eget repository: Når du opretter dit eget repository (projekt) på GitHub, har du fuld kontrol over det. Du kan tilføje filer, lave ændringer og push’e (overføre) dem direkte til hovedgrenen (eller en anden gren) i dit repository. Andre udviklere kan bidrage til dit projekt ved at oprette pull requests eller issues (fejlrapporter eller forslag).

2. Fork og Pull Requests: Hvis du vil bidrage til et projekt, som du ikke ejer, kan du “forke” (kopiere) det. Når du har forket projektet til din egen GitHub-konto, kan du lave ændringer lokalt og derefter sende en “pull request” (PR) til det originale repository. Repository-ejeren kan herefter gennemgå dine ændringer og vælge, om de skal flettes ind i hovedprojektet. Dette er en central arbejdsgang i open source-projekter.

3. Collaborator-modellen: I nogle projekter kan repository-ejeren give andre udviklere rettigheder til direkte at push’e ændringer til et repository. Dette er almindeligt i teams, hvor flere medlemmer arbejder sammen på lige fod uden behov for PR’er for hver eneste ændring.

Da vi i forbindelse med undervisning ofte arbejder med små projekter, vil vi ofte benytte den første model, hvor du har fuld kontrol over dit eget repository, og andre kan bidrage ved at oprette pull requests. Da undervisningen typisk foregår på en fremmed maskine, vil vi også benytte SSH-nøgler til at logge ind på GitHub. På den måde kan du arbejde med dit repository uden at risikere at efterlade login-informationer på en fremmed maskine fordi du har brugt et browser token. Det kan være noget rod at rydde op i bagefter.

Brug et SSH token

Her er en trin-for-trin guide til at oprette et SSH token på en fremmed maskine:

Generer en ny SSH-nøgle

Åbn Git Bash og indtast følgende kommando (erstat ‘din_email@example.com’ med din egen e-mailadresse):

ssh-keygen -t ed25519 -C "din_email@example.com"

Når du bliver bedt om at “Enter a file in which to save the key,” kan du trykke Enter. Dette accepterer den standardfilplacering. Indtast derefter en sikker adgangskode, når du bliver bedt om det.

Start ssh-agent

I Git Bash, start ssh-agent i baggrunden ved at indtaste:

eval "$(ssh-agent -s)"

Tilføj SSH nøgle

Tilføj derefter din SSH private nøgle til ssh-agenten ved at indtaste:

ssh-add ~/.ssh/id_ed25519

Tilføj den nye SSH-nøgle til din GitHub-konto

Kopier indholdet af SSH-nøglen (id_ed25519.pub filen) til din udklipsholder ved at indtaste:

clip < ~/.ssh/id_ed25519.pub

Det vil kopiere indholdet af din offentlige nøgle til udklipsholderen.

Login på GitHub i din webbrowser (brug Incognito hvis du er på en ekstern maskine) og klik på Settings (under dit navn i øveste højre hjørne) -> SSH og GPG nøgler -> Ny SSH nøgle. Giv nøglen en titel og indsæt den offentlige nøgle i “Key” feltet. Tryk “Add SSH key” for at tilføje nøglen.

Nu kan du bruge SSH til at interagere med GitHub.

Opret et nyt repository på GitHub

Det nemmeeste er at oprette et repository på GitHub og derefter clone det til din lokale maskine. Her er trinene:

• Gå til GitHub (Incognito) og log ind
• Vælg “New repository”.
• Giv dit repository et navn, en beskrivelse og vælg om det skal være offentligt eller privat. Du bør vælge at initialisere dit repository med en README-fil og en .gitignore-fil (vælg Visual Studio på listen).

Klon dit repository til en fremmed maskine

Når du har oprettet dit repository kan du klikke på den store grønne knap på forsiden til repositoriet. Her skal du vælge at klone via SSH og kopiere URL’en til udklipsholderen.

Åbn ny en terminal og naviger til den mappe, hvor du vil klone dit repository. Indtast følgende kommando:

git clone din_repository_ssh_url

Din Windows-maskine har nu adgang til dit private GitHub-repository, og du kan både push og pull. Husk at fjerne SSH-nøglen fra din GitHub-konto, når du er færdig med at bruge den fremmede maskine.

Ressourcer om Git

GitHub’s Learning Lab er en god måde at lære Git og GitHub på. Det er en samling af kurser, der er designet til at hjælpe dig med at lære Git og GitHub ved at bruge GitHub. Du kan tage kurserne i dit eget tempo, og de er gratis at bruge.

Han viser det faktisk også meget godt:

Microsoft har også lavet en rigtig god Youtube serie omkring Git og brug i VS:

• Using source control (1 of 5)
• Committing code changes (2 of 5)
• Working with branches (3 of 5)
• Resolving merge conflicts (4 of 5)
• More on merge conflicts (5 of 5)

Spørgsmål til AI

For at få mest muligt ud af AI-værktøjer som ChatGPT, er det vigtigt at stille klare og præcise spørgsmål (og skabe det rigtige kontekst - se her). Her er nogle spørgsmål til denne side:

Grundlæggende spørgsmål til AI

• Hvad er Git og hvorfor skal jeg bruge versionsstyring?
• Hvad er forskellen mellem Git og GitHub?
• Hvordan opretter jeg et nyt Git repository?
• Hvad betyder kommandoerne git add, git commit og git push?
• Hvad er en pull request og hvordan bruger jeg det?
• Hvordan kloner jeg et eksisterende repository?
• Hvad er en branch i Git og hvornår skal jeg bruge det?
• Hvordan håndterer jeg merge konflikter?
• Hvad er .gitignore filen til?
• Hvad er SSH-nøgler og hvorfor bruger jeg dem med GitHub?

Reference: Git-terminologi

Som nybegynder i Git er her en oversigt over de mest almindelige begreber.