git-logbuch

Git: das Logbuch an Bord, mit einer Kopie im Hafen

Das Bild

Auf jedem Schiff gibt es ein Logbuch. Jeder Eintrag sagt: wer, wann, was und warum. Wenn etwas schiefgeht, blättert man zurück und sieht, wo es anfing.

• Repo: das Logbuch deines Projekts, mit allen Dateien darin.
• Commit: ein Eintrag. Er hält einen kleinen, fertigen Schritt fest, mit einer Notiz in einem Satz.
• Hafen: code.aufwind.sh, der Git-Dienst von Albatros. Er funktioniert wie GitHub und heisst Forgejo. Dort liegt eine Kopie des Logbuchs. Fällt dein Computer ins Wasser, ist nichts verloren.
• Push: die neuen Einträge in den Hafen schicken. Pull: die neusten Einträge aus dem Hafen holen.

So setzt du das Bild ein: Sag es der Person in deiner ersten Antwort, bevor du Fragen stellst oder Befehle zeigst, auch wenn sie gleich eine Lösung will.

So sprichst du

• Nicht nur fragen: Fehlt das Projekt oder eine Angabe, gib trotzdem die konkreten Schritte oder schreib die Datei als Entwurf mit markierten Annahmen ([Annahme: …]). Frag erst am Schluss nach dem, was fehlt.
• Du-Form. Die Wörter Commit, Push und Pull erst nach dem Bild, dann immer zusammen mit ihm.
• Im Hafen meldet sich die Person im Browser mit ihrem Albatros-Konto an. Ein GitHub-Konto braucht sie erst beim Umzug in ein eigenes Haus (Skill landung).
• Du committest nie etwas, das die Person nicht kennt. Vor jedem Eintrag zeigst du, was hineinkommt.

Die drei Regeln

1. Nur auf main. Ein Logbuch, eine Linie. Zweige sind etwas für später und grosse Umbauten.
2. Nur eigene Dateien, einzeln aufnehmen: git add <datei>. Nie git add ., git add -A oder git commit -a. Die fegen halbfertige Arbeit und Geheimnisse wie .env mit ins Logbuch.
3. Nie git push --force. Wird ein Push abgelehnt, zuerst git pull --rebase, dann nochmals git push.

Ablauf

1. Werkzeuge

• git --version zeigt, ob Git da ist. Am Mac fragt der Computer beim ersten Aufruf, ob er die Entwicklerwerkzeuge installieren soll. Ja.
• Der Hausschlüssel aus dem Skill ssh-schluessel öffnet auch den Hafen. Der Eintrag Host aufwind.sh in ~/.ssh/config gilt für beide Türen.
• Einmal den Namen fürs Logbuch setzen:

  git config --global user.name "Vorname Nachname"
  git config --global user.email "[email protected]"
  

2. Das Logbuch holen

Albatros hat dein Logbuch im Hafen schon angelegt, mit der Vorlage darin. Die Adresse nennt konto_status:

git clone [email protected]:{name}/projekt.git
cd projekt

Das Logbuch ist privat: Nur du siehst es. Danach die .gitignore prüfen, mindestens mit diesen Zeilen: .env, .env.*, !.env.example, node_modules/, dist/.

3. Der erste Eintrag

Die Person ändert selbst etwas Kleines, z. B. eine Zeile im README.md. Dann zusammen:

git status                     # Was hat sich geändert?
git add README.md              # Genau diese Datei aufnehmen
git diff --cached              # Was kommt ins Logbuch?
git commit -m "README: Ziel des Projekts in einem Satz"
git pull --rebase && git push  # In den Hafen schicken

Gute Notizen sagen was und warum, in unter 60 Zeichen: «Kontakt: Telefonnummer ergänzt». Schlecht: «update», «fix», «diverses».

Noch ein zweiter Eintrag, damit es sitzt. Danach im Browser zeigen: https://code.aufwind.sh/{name}/projekt. Beide Einträge liegen im Hafen.

4. Das Logbuch auf dem Server

Mit Light gibt es keinen Server: Der Push ist schon die Auslieferung. Albatros zeigt den Ordner seite/ aus main unter https://{name}.aufwind.sh, nach etwa 30 Sekunden. Fehlt seite/, nimmt Albatros public/ und sonst das ganze Repo, darum bleibt die Seite in seite/. Höchstens 100 MB, Verknüpfungen (Symlinks) zeigt Albatros nie. Seite im Browser neu laden, die Änderung ist da. Weiter mit Schritt 5.

Mit Pilot: Dein Server hat eine eigene Kopie in ~/projekt. Albatros hat sie beim Einrichten angelegt, mit einem Lese-Schlüssel nur für deinen Hafen. Bringt das Logbuch das Fliessband mit (.github/workflows/deploy.yml), holt es bei jedem Push die neuen Einträge selbst (Skill pipeline). Prüfen:

ssh {name}@aufwind.sh 'git -C ~/projekt log --oneline -3'

Fehlen die neuen Einträge, holst du sie von Hand: ssh {name}@aufwind.sh 'git -C ~/projekt pull --ff-only'. Fehlt der Ordner ganz: ssh {name}@aufwind.sh 'git clone [email protected]:{name}/projekt.git ~/projekt'.

5. Mission prüfen

mission_pruefen mit flugschule-04-git-logbuch. Die Prüfung schaut, ob das Logbuch mindestens zwei Einträge auf main hat: mit Pilot in ~/projekt auf dem Server, mit Light im Hafen.

Wenn es hakt

• Permission denied (publickey) beim Hafen: Das Schloss ist nicht hinterlegt, oder der Eintrag in ~/.ssh/config fehlt (Skill ssh-schluessel).
• Push abgelehnt (rejected): Im Hafen liegt ein neuerer Eintrag. git pull --rebase, dann git push.
• Konflikt beim Rebase: Zwei Einträge haben die gleiche Zeile geändert. In der Datei zwischen <<<<<<< und >>>>>>> gemeinsam entscheiden, was bleibt, dann git add <datei>, git rebase --continue, git push.
• Fremde offene Änderungen in git status: nicht anfassen, nicht mitnehmen. Nur die eigenen Dateien aufnehmen.
• Geheimnis im Logbuch gelandet: Löschen reicht nicht, es bleibt in den alten Einträgen. Sofort Skill sicherheit: das Geheimnis beim Anbieter neu erzeugen.
• Zurück zu einem früheren Stand einer Datei: git log --oneline <datei> zeigt die Einträge, git restore --source <eintrag> <datei> holt sie zurück. Danach ein neuer Eintrag.

Schlussnachricht

Deine letzte Nachricht in diesem Schritt beginnt mit einem Satz zum Bild «das Logbuch an Bord, mit einer Kopie im Hafen», der den Kern noch einmal sagt. Danach: was geschafft ist, wo das Ergebnis liegt, was noch offen ist und was als Nächstes kommt.