Git

Get started using Git on WSL

- general guidelines on Git usage
$ git help

- shows details about the command
$ git help <command>

Git kommt mit den meisten WSL Distributionen mit, aber möglicherweise wollen wir es updaten. Außerdem müssen wir die .gitconfig Datei einrichten.
Zuerst mal prüfen, ob Git installiert ist: git --version. Wenn nicht, dann installieren.

Configure Git - GitLab Docs

Um Git zu verwenden, muss die sogenannte Git-Identität einmalig pro Gerät global konfiguriert werden. Diese Daten werden in pingubib/.gitconfig gespeichert:

$ git config --global user.name "User Name"
$ git config --global user.email "my-email@domain.tld"

master- main

Falls beim erstmaligen initialisieren eines git-Repos (git init) diese Meldung kommt, muss der branch ‘master’ in ‘main’ umbenannt werden:

hint: Using 'master' as the name for the initial branch. This default branch name
hint: is subject to change. To configure the initial branch name to use in all
hint: of your new repositories, which will suppress this warning, call:
hint:
hint:   git config --global init.defaultBranch <name>
hint:
hint: Names commonly chosen instead of 'master' are 'main', 'trunk' and
hint: 'development'. The just-created branch can be renamed via this command:
hint:
hint:   git branch -m <name>

D.h. also aktuellen Branch in main umbenennen und die .gitconfig anpassen.

// aktueller Branch:
$ git branch -m main

// global:
$ git config --global init.defaultBranch main

.gitconfig

Die .gitconfig sieht dann so aus:

[user]
  name = Birgit Riese
  email = office@riese-webdesign.at
[init]
  defaultBranch = main

Zugangsdaten abfragen:

p...@...:~$ git config user.name && git config user.email
User Name
my-email@domain.tld

SSH-Verbindung zu GitHub einrichten

Connecting to GitHub with SSH

SSH-Verbindung zu GitLab einrichten

Use SSH keys with GitLab - GitLab Docs
Über eine gesicherte SSH-Verbindung können wir uns bei GitLab authentifizieren und müssen nicht bei jedem Push/Pull Benutzername und Passwort eingeben. Um eine SSH-Verbindung einzurichten, brauchen wir SSH keys.

Profil > Einstellungen dann Benutzereinstellungen > Access > SSH Schlüssel
Für den Desktop-PC und den Laptop ist bereits jeweils ein Schlüsselpaar im Ordner pingubib/.ssh hinterlegt. (Der Schlüssel für den Desktop hat den Titel office@…). GitLab schickt vor Ablauf der Frist eine Erinnerung.

Desktop gültig bis 12.01.2027
Laptop gültig bis 29.03.2027

SSH Keys generieren und hinterlegen

Bei der ersten Verbindung über die Konsole muss eventuell die Authentizität des GitLab Hosts bestätigt werden. In der Konsole wird ein ECDSA key fingerprint angezeigt. Diesen müssen wir kontrollieren: bei unseren Schlüsseln ist ein Link zur aktuellen Konfiguration der Instanz hinterlegt. Dort stehen die SSH-Hostschlüssel-Fingerabdrücke für die aktuelle Instanz. Wenn dieser Fingerabdruck mit dem in der Konsole angezeigten übereinstimmt, können wir bestätigen und sehen dann eine Willkommensnachricht.

Diese manuelle Bestätigung kann auch übersprungen werden, wenn wir bei den SSH known_hosts entries einen Eintrag hinterlegen.

GitRepos in VS Code
Source Control in VS Code