Git verstehen¶
Git speichert den Zustand eines Verzeichnisses als Folge von Schnappschüssen, den Commits. Jeder Commit hält fest, wer was wann und warum geändert hat, und du kannst zu jedem davon zurück. Für Admins heißt das: Skripte und Konfigurationsdateien mit vollständigem Verlauf, Änderungen, die sich rückgängig machen lassen, und dieselben Dateien auf mehreren Servern.
Die drei Bereiche¶
Arbeitsverzeichnis ──git add──► Staging-Bereich ──git commit──► Repository
▲ │
└────────────────── git restore / git switch ───────────────────┘
| Bereich | Was er ist |
|---|---|
| Arbeitsverzeichnis | Die Dateien, die du siehst und bearbeitest |
| Staging-Bereich (Index) | Die Änderungen, die du mit git add für den nächsten Commit vorgemerkt hast |
| Repository | Alle Commits, gespeichert im versteckten Verzeichnis .git |
Du entscheidest, was in einen Commit kommt: drei Dateien ändern, zwei davon hinzufügen, committen. Die dritte Änderung bleibt im Arbeitsverzeichnis für einen späteren Commit.
Git einmal einrichten¶
Jeder Commit trägt einen Namen und eine E-Mail-Adresse. Setze sie einmal pro Benutzer:
$ git config --global user.name "Nox"
$ git config --global user.email nox@example.com
$ git config --global init.defaultBranch main
Die Einstellungen landen in ~/.gitconfig, siehe git config.
Dateien ignorieren¶
Eine Datei .gitignore im Repository listet Dateien auf, die Git nie verfolgen soll:
Logs, temporäre Dateien und vor allem Geheimnisse.
# Logs and temporary files
*.log
*.swp
tmp/
# Secrets never belong in a repository
.env
*.key
git status zeigt ignorierte Dateien nicht an, und git add . lässt
sie aus. Nimm .gitignore selbst ins Repository auf, damit sie überall gilt.
SSH-Schlüssel für GitHub und GitLab¶
Git-Server wie GitHub, GitLab oder Gitea melden dich per SSH-Schlüssel an. Erzeuge einen
Schlüssel, siehe ssh-keygen, und hinterlege den öffentlichen
Schlüssel in deinem Konto: bei GitHub unter Settings › SSH and GPG keys, bei GitLab unter
Preferences › SSH Keys.
$ ssh-keygen -t ed25519 -C "nox@tuxdex-srv"
$ cat ~/.ssh/id_ed25519.pub
ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIK3vYf2mPqT8wZr5nB7dXc1hL0sQe9uJgN4aRtVy6oMp nox@tuxdex-srv
$ ssh -T git@github.com
Hi nox! You've successfully authenticated, but GitHub does not provide shell access.
Repository-Adressen sehen dann so aus: git@github.com:nox/scripts.git. Die Beispiele in
diesem Kapitel nutzen den Git-Server git.example.com.
Der tägliche Ablauf¶
$ git pull # get the latest state from the server
$ vim check-disk.sh # change something
$ git status # what has changed?
$ git diff # what exactly?
$ git add check-disk.sh # mark the change for the commit
$ git commit -m "Also check /var"
$ git push # send it to the server
Größere Änderungen machst du besser in einem eigenen Branch, siehe
git switch und git merge.
Gute Commit-Nachrichten¶
| Gut | Schlecht |
|---|---|
Raise PHP memory limit to 256M |
changes |
Fix backup path for /srv/data |
fix |
| Eine logische Änderung pro Commit | Eine Woche Arbeit in einem einzigen Commit |
Die erste Zeile ist eine kurze Zusammenfassung (etwa 50 Zeichen, im Imperativ: „Add“, „Fix“, „Remove“). Braucht es mehr Erklärung, folgt nach einer Leerzeile der Rest.
Unterschiede zwischen Distributionen¶
| Debian | Ubuntu | RHEL | Arch | |
|---|---|---|---|---|
| Vorinstalliert | nein | ja (Server-Installation) | nein | nein |
| Installation | sudo apt install git |
sudo apt install git |
sudo dnf install git |
sudo pacman -S git |
/etc versionieren
Das Paket etckeeper legt /etc in ein Git-Repository und committet automatisch vor
und nach jeder Paketinstallation. So siehst du genau, welche Konfigurationsdatei sich
wann geändert hat.
Keine Passwörter oder Schlüssel in ein Repository
Was du committest, bleibt im Verlauf, auch wenn du die Datei später löschst. Ein
Passwort, das einmal gepusht wurde, gilt als kompromittiert: Ändere es. Halte
Geheimnisse mit .gitignore von Anfang an heraus.