Installeren

Git installeren

git is een command-line programma maar kan ook worden bediend met een grafische interface. De command-line versie van git is beschikbaar voor Windows, Mac en Linux.

Waarschuwing

Als er hieronder voor de commando’s een $ staat, dan moet je die niet overnemen. We gebruiken dat karakter om de ‘prompt’ aan te geven. Zo kan je makkelijk zien wat is ingevoerd door de gebruiker, en welke informatie het systeem als reactie geeft.

WindowsMacLinux

Download de laatste versie van git van de git website. Start de installer en volg de instructies op het scherm.

Open een terminal en voer het volgende commando uit:

git --version

Als git al is geïnstalleerd, dan wordt de versie van git getoond. Als git nog niet is geïnstalleerd, dan wordt je gevraagd om git te installeren.

git is beschikbaar in de meeste Linux distributies. Installeer git met de package manager van je distributie. Bijvoorbeeld:

sudo apt install git

Git configureren

Om git te gebruiken moet je eerst je naam en e-mailadres configureren. Dit doe je met de volgende commando’s:

git config --global user.name "Jouw voornaam en achterNaam"
git config --global user.email "Jouw HvA emailadres"

Git koppelen aan GitLab

Om met git op GitLab te kunnen werken, moet je git installatie worden gekoppeld aan je GitLab account. Omdat je niet elke keer je gebruikersnaam en wachtwoord wilt invoeren, moet je git vertellen dat je je SSH sleutel wilt gebruiken om je te identificeren. Dit doe je door een SSH sleutel aan te maken op jouw computer en deze toe te voegen aan je GitLab account.

WindowsMac en Linux

Bij de git installatie op Windows wordt ook een programma geïnstalleerd dat git bash heet. Dit is een command-line programma dat je kunt gebruiken om git commando’s uit te voeren. Open git bash en voer de volgende commando’s uit:

ssh-keygen -t ed25519

Open een terminal en voer de volgende commando’s uit:

ssh-keygen -t ed25519

Na het uitvoeren van ssh-keygen wordt je gevraagd om een bestandsnaam voor je sleutel in te voeren. Gebruik de standaard bestandsnaam door op Enter te drukken. Je wordt ook gevraagd om een wachtwoord in te voeren. Je kunt een wachtwoord invoeren, maar je kunt ook op enter drukken om geen wachtwoord in te stellen. Als je geen wachtwoord instelt, dan wordt je niet gevraagd om een wachtwoord als je de sleutel gebruikt.

Er is nu een SSH sleutel aangemaakt. De sleutel bestaat uit twee bestanden: een publieke sleutel en een privé sleutel. De publieke sleutel heeft de extensie .pub. De privé sleutel heeft geen extensie. De sleutels staan in de map .ssh in je home directory. Je kunt de sleutels vinden met het volgende commando:

cat ~/.ssh/id_ed25519.pub

Kopieer de output van dit commando naar het klembord. Bijvoorbeeld:

cat ~/.ssh/id_ed25519.pub
ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIDX72kD/gXeYQXPQXxGBPhVcF0wbNqZT7rIy8Tnus2Bd username@re-byodm-145-109-212-148.wireless.hva.nl

Het eerste deel van de output is het type sleutel (ed25519), het tweede deel de daadwerkelijke publieke sleutel, het laatste deel is een comment om de sleutel te herkennen.

In GitLab kun je de sleutel toevoegen aan je account. Ga naar je profiel en klik op Settings. Klik op SSH Keys en plak de sleutel in het invoerveld. Klik op Add key om de sleutel toe te voegen. Je kan de “expiration date” leeg laten zodat de sleutel niet verloopt.

SSH sleutel toevoegen aan GitLab

Clonen van je project

Als laatste zal je één keer handmatig je project moeten clonen.

Kopieer de SSH URL van je project op GitLab.

Ga in gitbash naar de map waar je je project wilt opslaan en voer het volgende commando uit:

git clone <SSH URL>

Je krijgt nu de volgende vraag:

git
Cloning into 'Projectnaam'...
The authenticity of host 'gitlab.fdmci.hva.nl (145.92.228.21)' can't be established.
ED25519 key fingerprint is SHA256:dsfhjgcsjdgjksdhgjsgkjhgsejdkhvgsdkjhvgjskdhg.
This key is not known by any other names
Are you sure you want to continue connecting (yes/no/[fingerprint])?

Typ nu het gehele woord yes en druk op enter. Je krijgt nu de volgende melding:

Cloning into 'projectnaam'...
remote: Enumerating objects: 28, done.
remote: Counting objects: 100% (28/28), done.
remote: Compressing objects: 100% (16/16), done.
remote: Total 28 (delta 6), reused 28 (delta 6), pack-reused 0
Receiving objects: 100% (28/28), done.
Resolving deltas: 100% (6/6), done.

Note

De stappen voor clonen van je project zal je eenmalig moeten uitvoeren voor iedere computer die je met GitLab wil synchroniseren.