Dokumentversionierung mit zwei Remotes

Einleitung

Im Frühherbst 2025 ging das Dokumentationsteam dazu über, von einer einzigen Dokumentationsversion, die alle Versionen abdeckte, zu jeder Version einen eigenen Dokumentationszweig zu entwickeln. Dadurch können die Anweisungen der einzelnen Versionen leichter unterschieden werden. Allerdings erschwert dies den Prozess des Schreibens oder Korrigierens von Dokumentationen, insbesondere wenn es sich um ältere Versionen handelt (Rocky Linux 8 oder 9). Dieses Dokument beschreibt eine Strategie zur Bewältigung des Workflows mithilfe eines doppelten Remote-Ansatzes.

Rocky Linux Versionen

Zum heutigen Datum, Oktober 2025, lauten die Versionen wie folgt:

Branch	Version
main	Rocky Linux 10
rocky-9	Rocky Linux 9
rocky-8	Rocky Linux 8

Voraussetzungen

• Ein persönliches GitHub-Konto mit bereits verwendeten SSH-Schlüsseln
• Ein bestehender Fork der Rocky Linux-Dokumentation
• Ein wenig Wissen über die Verwendung von git auf der Kommandozeile oder die Bereitschaft, dies kennen zu lernen
• Das Dienstprogramm git bereits installiert

Repository klonen

Durch das Klonen des Rocky Linux-Repository wird eine Kopie der Rocky Linux-Dokumentation in ein Verzeichnis /documentation auf Ihrer Workstation aufgesetzt. Möglicherweise haben Sie irgendwann oder bei anderen GitHub-Projekten gelesen, dass Sie immer von Ihrem persönlichen Fork des Projekts klonen sollen. In diesem Dokumentations-Projekt ist dies nicht der Fall, damit Ihr Klon die vorhandenen RL-Versionen der Dokumentation verwalten kann. Sie werden vom Rocky Linux-Git-Projekt klonen. In diesem Artikel erfahren Sie, warum das so ist. Darüber hinaus müssen Sie Ihre Git-Remotes umbenennen, damit sie logisch Sinn ergeben (Rocky Linux upstream und Ihr GitHub origin).

1. Klonen Sie die Rocky Linux-Dokumentation:

   git clone git@github.com:rocky-linux/documentation.git
   

2. Wechseln Sie in das Verzeichnis /documentation:

   cd documentation
   

3. Überprüfen Sie den Remote-Namen:

   git remote -v
   

Dies wird folgendes Ergebnis liefern:

```bash
origin git@github.com:rocky-linux/documentation.git (fetch)
origin git@github.com:rocky-linux/documentation.git (push)
```

Sie werden diese Ressource auf upstream und nicht origin setzen.

1. Ändern des Remote-Namens

   git remote rename origin upstream
   

Wenn Sie git remote -v erneut ausführen, wird nun Folgendes angezeigt:

```bash
upstream git@github.com:rocky-linux/documentation.git (fetch)
upstream git@github.com:rocky-linux/documentation.git (push)

```

Ihr fork als Remote hinzufügen

Nachdem das Rocky Linux-Remote hinzugefügt und korrekt benannt wurde, müssen Sie Ihren persönlichen GitHub-Fork als Ursprungs-Remote festlegen.

1. Für diesen Schritt müssen Sie Ihren GitHub-Benutzernamen kennen, den Sie bereits besitzen sollten. Ersetzen Sie das Feld [username] durch den richtigen Namen. Fügen Sie Ihr remote hinzu:

   git remote add origin git@github.com:[username]/documentation.git
   

2. Überprüfen Sie Ihre Git-Remotes:

   git remote -v
   

Dies wird folgendes Ergebnis liefern:

```bash
origin git@github.com:[username]/documentation.git (fetch)
origin git@github.com:[username]/documentation.git (push)
upstream git@github.com:rocky-linux/documentation.git (fetch)
upstream git@github.com:rocky-linux/documentation.git (push)
```

Suchen Sie nach Updates und fügen Sie die Versionszweige zu Ihrem Fork hinzu

1. Nachdem Sie die Remotes hinzugefügt haben, beginnen Sie damit, alle Updates vom Upstream abzurufen und sie zum Ursprung zu übertragen. Wenn Sie gerade Ihren Fork und Ihre Remotes erstellt haben, müssen keine Updates gepusht werden. Es ist jedoch eine gute Idee, mit Folgendem zu beginnen:

   git pull upstream main && git push origin main
   

2. Machen Sie Ihren lokalen Klon mit folgendem Befehl auf die im Upstream vorhandenen Branches aufmerksam:

   git fetch upstream
   

3. Schauen Sie sich einen der beiden älteren Versionszweige an:

   git checkout rocky-8
   

   !!! warning "Dies funktioniert nicht, wenn Ihr Klon von Ihrem Fork stammt."

   ```
    Deshalb erfolgt der Klonvorgang von Rocky Linux aus und nicht von Ihrem Fork. Ihr Fork kennt die älteren Branches nicht. Um die folgende Meldung zu erhalten, müssen Sie Ihr lokales Dokumentations-Repository von Rocky Linux klonen. 
   ```
   

Wenn Sie Ihre remotes richtig eingerichtet haben, sollten Sie jetzt Folgendes sehen:

```bash
branch 'rocky-8' set up to track 'upstream/rocky-8'.
Switched to a new branch 'rocky-8'
```

Dadurch wird effektiv ein lokaler Zweig rocky-8 erstellt. Ihr nächster Schritt besteht darin, alle Änderungen von rocky-8 abzurufen und sie an Ihren origin zu übertragen. Es sollten keine lokalen Änderungen vorgenommen werden, aber der Zweig ist auf Ihrem Fork nicht vorhanden, daher wird er durch diesen Prozess erstellt:

```bash
git pull upstream rocky-8 && git push origin rocky-8
```

Sie erhalten wahrscheinlich eine Art Nachricht, dass Sie aus dem Push ein Pull-Request erstellen können. Sie können dies ignorieren. Was passiert ist, ist, dass Ihr Fork jetzt einen rocky-8-Branch hat.

1. Schauen Sie sich den verbleibenden älteren Zweig an. (rocky-9) und wiederholen Sie die Schritte, die Sie gerade mit diesem Zweig ausgeführt haben.

Nach Abschluss dieses Vorgangs verfügen Sie nun über die Branches main, rocky-8 und rocky-9 in Ihrem lokalen Fork und Klon und können Dokumentation zu jedem dieser Branches schreiben.

Schreiben eines Dokuments oder Aktualisieren eines vorhandenen Dokuments auf einer älteren Version

Wenn Sie mit dem Schreiben eines Pull Requests (PR) für den main-Branch der Dokumentation vertraut sind, funktioniert dieser Vorgang weiterhin wie immer. Denken Sie daran, dass main für die neueste Version steht (10 zum Zeitpunkt —2025-10-19— des Schreibens dieses Artikels). Um eine kleine Änderung an einer der älteren Versionen vorzunehmen, müssen Sie zunächst einen Zweig zur lokalen Bearbeitung basierend auf diesem Zweig erstellen. Verwenden Sie dazu die Option -b mit Ihrem Befehl git checkout. Dieser Befehl erstellt einen Branch namens 8_rkhunter_changes basierend auf dem Branch rocky-8:

git checkout -b 8_rkhunter_changes rocky-8

Sie können jetzt die Datei bearbeiten, an der Sie Änderungen vornehmen möchten. Dabei wird die Version des Dokuments verwendet, die im Zweig rocky-8 vorhanden ist.

Sobald Sie mit dem Bearbeiten, Speichern, Zwischenspeichern und Übertragen Ihrer Änderungen wie gewohnt fertig sind, übertragen Sie diese bitte an Ihren Remote-origin-Server:

git push origin 8_rkhunter_changes

Wenn Sie den PR erstellen, geht GitHub jedoch automatisch davon aus, dass Sie einen PR erstellen, um den Zweig main zu ändern, obwohl Sie beim Ändern des Dokuments ausdrücklich den Zweig rocky-8 verwendet haben. Achten Sie darauf, den Pull Request nicht zu schnell zu erstellen, wenn Sie diesen fehlerhaften Vergleichsbildschirm sehen:

Hier müssen Sie den Vergleichszweig auf den richtigen Zweig (in diesem Fall rocky-8) ändern:

Nachdem der Vergleichszweig korrigiert wurde, kann mit der Erstellung des Pull Requests fortgefahren werden. Anschließend muss auf die Zusammenführung gewartet werden.

Aktualisieren Ihrer älteren Versionszweige nach einer Zusammenführung

Genau wie beim main-Branch ist es ratsam, auch die älteren Versionszweige stets mit allen Änderungen auf dem neuesten Stand zu halten. Der folgende Befehlssatz aktualisiert alle Ihre Versionen, sodass sie mit dem upstream übereinstimmen:

git checkout rocky-8
git pull upstream rocky-8 && git push origin rocky-8
git checkout rocky-9
git pull upstream rocky-9 && git push origin rocky-9
git checkout main
git pull upstream main && git push origin main

Nach Ausführung dieser Befehle sind alle Ihre lokalen Branches und Ihr Fork auf dem neuesten Stand.

Fazit

Dieses Dokument führt Sie durch eine doppelte Remote-Strategie für den Umgang mit neuen Dokumenten oder Korrekturen seit der Erstellung von Dokumentation-Versionen.

Author: Steven Spencer

Contributors: Ganna Zhyrnova