Konfigurieren Sie einen unterstützten Tracking-Branch, um Discourse-Software-Updates zu erhalten

[Discourse]

Diese Anleitung erklärt, wie Sie einen unterstützten Tracking-Branch für Ihre Discourse-Instanz konfigurieren, um Software-Updates zu verwalten.

Erforderliches Benutzerniveau: Systemadministrator

Konsolenzugriff ist erforderlich.

Die Verwaltung des Tracking-Branches Ihrer Discourse-Instanz bestimmt die Häufigkeit und Art der Updates, die Sie erhalten. Diese Anleitung erläutert die verschiedenen verfügbaren Tracking-Branches und bietet einen schrittweisen Ansatz zum Ändern des Branches in Ihrer Einrichtung.

Zusammenfassung

Discourse bietet mehrere Branches und Tags zur Nachverfolgung von Software-Updates: latest, release und esr. Diese Dokumentation erläutert den Zweck jedes Einzelnen, ihre Hauptmerkmale und wie sie in Ihrer Discourse-Instanz konfiguriert werden. Für vollständige Details zum Release-Modell siehe RFC: Eine neue Versionsstrategie für Discourse.

Unterstützte Branches

latest

Empfohlene Standardeinstellung
Dieser Branch stellt die neuesten Fehlerbehebungen und Kompatibilitäts-Updates für Plugins bereit. Jeder erfolgreiche Commit aus dem main-Branch wird vom Build-Server getestet und nach erfolgreicher Überprüfung zum latest-Branch hinzugefügt.

• Geeignet für Sites, die auf dem neuesten Stand bleiben möchten.
• Sites können jederzeit manuell aktualisieren.

release

Für Sites, die monatliche Releases bevorzugen
Das Tag release verfolgt die neueste monatliche Veröffentlichung von Discourse. Jeden Monat wird ein Release-Branch (z. B. release/2026.2) von latest abgeschnitten, was einen stabilen Snapshot liefert.

• Ungefähr einmal pro Monat veröffentlicht.
• Jedes Release erhält kritische Korrekturen für zwei vollständige Release-Zyklen.

esr

Extended Support Release (Release mit erweitertem Support)
Das Tag esr verfolgt die neueste Extended Support Release, die für Sites gedacht ist, die langfristige Stabilität und Sicherheit gegenüber häufigen Updates priorisieren.

• Ungefähr alle 6 Monate aus den monatlichen Releases deklariert.
• Erhält Sicherheitskorrekturen und kritische Backports über einen längeren Zeitraum.
• Kann eine begrenzte Kompatibilität mit Community-Plugins und Theme-Komponenten aufweisen.

Hinweis: Wenn Sie keine regelmäßigen Wartungsupdates erhalten, können einige Funktionen veraltet oder visuell inkonsistent sein.

Veraltete Aliase

Aus Gründen der Abwärtskompatibilität funktionieren die folgenden alten Branch-/Tag-Namen weiterhin, gelten jedoch als veraltet:

• tests-passed → latest
• beta → release
• stable → esr

Andere Branches oder Referenzen

Das Verfolgen anderer Branches (z. B. spezifischer release/JJJJ.M-Branches oder Commit-SHAs) ist möglich, erfordert jedoch Fachwissen. Diese Branches erhalten nur für einen begrenzten Zeitraum kritische Korrekturen.

Anweisungen zur Konfiguration Ihres Tracking-Branches

Befolgen Sie diese Schritte, um den gewünschten Branch in Ihrer Discourse-Instanz zu konfigurieren:

1. Zugriff auf die Konfigurationsdatei
   Öffnen Sie die Konfigurationsdatei app.yml, indem Sie die folgenden Befehle in Ihrer Konsole ausführen:

cd /var/discourse
git pull
nano containers/app.yml

Der Editor nano wird die Konfigurationsdatei öffnen.
2. Den Tracking-Branch bearbeiten
Suchen Sie den Parameter version, indem Sie nach dem Wort „version“ in der Datei suchen:

params:  
## Which Git revision should this container use? (default: latest)  
#version: latest

• Kommentieren Sie die Versionszeile aus.
• Ersetzen Sie latest durch den gewünschten Branch- oder Tag-Namen (z. B. esr). Beispiel:

params:  
## Which Git revision should this container use? (default: latest)  
version: esr  

3. Speichern und beenden

• Drücken Sie Strg+O, um Ihre Änderungen zu speichern.
• Drücken Sie Enter, um zu bestätigen.
• Verwenden Sie Strg+X, um den Editor zu beenden.

4. Den Container neu erstellen
   Sobald die Änderungen vorgenommen und gespeichert wurden, erstellen Sie den Container neu, um die neue Konfiguration anzuwenden:

git pull
./launcher rebuild app

Dieser Vorgang kann zu vorübergehenden Ausfallzeiten führen. Stellen Sie sicher, dass Sie die Instanz nach Möglichkeit außerhalb der Geschäftszeiten aktualisieren.