Ich schreibe eine kurze Dokumentation für Admins von Discourse-Foren, die ich eingerichtet habe. Fehlt mir etwas darin?

Ich habe Discourse-Foren für mehrere Freunde/Vereine eingerichtet. Ich möchte, dass sie bei der Verwaltung autonomer werden, damit ich selbst seltener eingreifen muss.

Sie nutzen Discourse seit Monaten oder Jahren als Benutzer und Co-Admins. Sie sind keine „neuen Admins“, aber ihnen fehlt das tiefgehende Wissen für die tägliche Wartung von Discourse (abgesehen von grundlegenden Moderationsaufgaben) und was sie als Admin wissen sollten, insbesondere bei technischen Problemen, da ich mich bisher immer um solche Dinge gekümmert habe.

Ich werde auch in Zukunft verfügbar sein, aber das Ziel ist, ihnen zu ermöglichen, die häufigsten Probleme selbst zu verfolgen und zu beheben.

Hier ist, was ich bisher geschrieben habe (KI-übersetzt ins Englische, da mein Text auf Französisch verfasst wird, also ignorieren Sie es, wenn einige Sätze seltsam formuliert sind):


Updates

Über die Weboberfläche

Führen Sie Updates durch, wenn im Admin-Panel ein unglückliches rotes Smiley erscheint (es bedeutet, dass ein wichtiges Update angewendet werden muss).
Updates werden über folgende Adresse durchgeführt:
https://tonforum.fr/admin/upgrade

Manchmal sind sie in zwei Schritten durchzuführen: Sie müssen zuerst „Docker_Manager“ aktualisieren, bevor Sie den Rest aktualisieren können:

Über die Kommandozeile

Manchmal muss ein Update über die Kommandozeile durchgeführt werden (die Discourse-Admin-Seite wird dies explizit angeben, falls erforderlich).

  1. Verbinden Sie sich über SSH mit dem Server
  2. Bauen Sie das Forum neu auf (ein Rebuild aktualisiert immer Discourse) mit dem folgenden Befehl:
  3. /var/discourse/launcher rebuild app
    
  4. Von Zeit zu Zeit, nachdem Sie bestätigt haben, dass das Forum korrekt funktioniert, kann es nützlich sein, ungenutzte Docker-Images (Überbleibsel früherer Upgrades) zu entfernen, um Speicherplatz freizugeben:
    /var/discourse/launcher cleanup
    

Speicherort wichtiger Dateien auf dem Server

app.yml

Enthält die Serverkonfiguration und die Liste der installierten Plugins. Sehr nützlich, wenn Sie das Forum auf einen anderen Server migrieren oder bestimmte Konfigurationen anwenden müssen (z. B. das Verschieben von Uploads und Backups auf eine andere Festplatte). Es befindet sich hier:

/var/discourse/containers/app.yml

mail-receiver.yml

Enthält die Konfiguration für die Software, die das Empfangen von Antworten per E-Mail und deren Veröffentlichung im Forum ermöglicht. Es befindet sich hier:

/var/discourse/containers/mail-receiver.yml

Backups

Backup-Dateien werden hier gespeichert:

/var/discourse/shared/standalone/backups/default

Wichtige Seiten in der Forum-Administration

Einige Seiten, die nützlich sein können :robot:

Themes und Komponenten

Diese enthalten benutzerdefinierten CSS- und HTML-Code:

https://tonforum.fr/admin/config/customize/themes

Protokolle (Logs)

E-Mail

Nützlich für das Debugging:

https://tonforum.fr/admin/email-logs

Mitarbeiteraktionen (Staff actions)

Sehr nützlich. Es protokolliert (fast) alle Änderungen der Site-Einstellungen und andere Aktionen, die von Moderatoren und Admins durchgeführt wurden.

https://tonforum.fr/admin/logs/staff_action_logs

Fehlerprotokolle (Error logs)

Kann Hinweise liefern, wenn ein Problem nicht offensichtlich ist:

https://tonforum.fr/logs/

Backups

Um die Backup-Frequenz und die maximale Anzahl von Backups zu ändern, sie anzuzeigen oder herunterzuladen:

https://tonforum.fr/admin/backups

Ressourcen

https://meta.discourse.org
Offizieller Support. Zögern Sie nicht, dort zu posten; Community-Mitglieder und Entwickler sind in der Regel sehr hilfsbereit.


Sehen Sie Dinge, die hinzugefügt/entfernt werden könnten? Ich denke, ich könnte den /logs/-Teil entfernen, da er sehr, sehr selten nützlich ist. Ich bin mir nicht einmal sicher, ob ich in vielen Jahren der Verwaltung einiger Instanzen nützliche Informationen darin gefunden habe.

10 „Gefällt mir“

Ein paar Dinge, die ich klarstellen möchte.

Erstens: Seien Sie sich beim Versuch eines Updates über die Weboberfläche bewusst, dass das Update fehlschlagen und Ihr Forum möglicherweise nicht mehr erreichbar sein kann. Seien Sie vorbereitet.

Zweitens: Wenn Ihr Host unzugänglich oder beschädigt wird, benötigen Sie die Sicherungsdateien und die yml-Dateien. Sie müssen diese bereits an einem sicheren Ort auf einem separaten System aufbewahrt haben.

Um beides zusammenzufassen: Erstellen Sie immer ein Backup und laden Sie das Backup herunter, bevor Sie ein Update versuchen.

3 „Gefällt mir“

Hallo Ed, sehr valide Punkte. Ich erinnere mich, dass ein Mitglied vor einiger Zeit ein Skript zum Sichern auf einem anderen System erstellt hat. Ich muss suchen und nachsehen.

Hier ist ein Auszug aus dem ursprünglichen Beitrag. Canapin hat eine gute Antwort mit einem Link zum Sichern auf Google Drive/Dropbox) sowie.

@Canapin muss bei der Launcher-Rebuild-App nicht Folgendes ausgeführt werden:

./launcher r build app

Das ist nur, wie ich es gewohnt bin, es von anderen Dokumenten hier auf der Seite auszuführen. Wie ich jedoch gelernt habe, gibt es oft viele Möglichkeiten, Dinge zu tun. Lol

Schöner Abriss, praktisch.

1 „Gefällt mir“

Aber da Sie vorher in das Verzeichnis /var/discourse wechseln würden, würde sich ./ auf dieses Verzeichnis beziehen, also ist der Pfad des Launchers im Grunde /var/discourse/launcher, oder?

Das war mir nicht bewusst. Ich habe es einfach so benutzt, wie es in anderen Tutorials zu Discourse beschrieben wurde. Aber das ergibt Sinn. Danke schön.

Ich frage mich, ob es sich lohnt, einige Eskalationstipps hinzuzufügen? Wenn die Person, die das Dokument liest, nicht weiß, wie man sich per ssh auf den Host einloggt, um zu untersuchen oder zu beheben, wer kann es dann? Vielleicht ein Tipp, hier im Meta-Bereich Fragen zu stellen, vielleicht auch ein Tipp zur Nutzung von ask.

4 „Gefällt mir“

Das ist gut zu wissen. Ich wusste nur vom Herunterladen des Backups, das vom Forum selbst erstellt wurde.

1 „Gefällt mir“

Vielen Dank für deine Hilfe!

Ich habe dies an den Anfang meines Leitfadens hinzugefügt:

Stellen Sie sicher, dass Sie auf jede Situation vorbereitet sind

Es wird dringend empfohlen, zusätzlich zu lokalen Backups (die auf demselben Server wie das Forum gespeichert sind), eine Kopie dieser Backups auf einem anderen Server oder in der Cloud[1] aufzubewahren.

Es ist auch nützlich, eine Kopie der Datei /var/discourse/containers/app.yml an einem sicheren Ort aufzubewahren[2]. Diese optionale Datei wird im Falle einer Neuinstallation des Forums oder einer Migration auf einen anderen Server verwendet.

Wenn bei irgendetwas ernsthafte Zweifel bestehen, kontaktieren Sie mich (canapin@gmail.com).

Dies wurde im Update-Abschnitt hinzugefügt:

:information_source: Bevor Sie ein Update durchführen, wird dringend empfohlen, das neueste Backup Ihres Forums herunterzuladen.

Dies wurde hinzugefügt:

Was tun, wenn das Forum nicht mehr funktioniert?

Das Neuerstellen des Forums behebt viele Probleme und wird mit demselben Befehl wie ein Kommandozeilen-Update durchgeführt:

/var/discourse/launcher rebuild app

Was tun, wenn das Forum nach dem Neuerstellen immer noch nicht funktioniert?

Fragen Sie mich (canapin@gmail.com) oder posten Sie im offiziellen Support-Forum.

Ich habe auch ask.discourse.org am Ende des Leitfadens erwähnt.

Ressourcen

https://meta.discourse.org : offizieller Support, zögern Sie nicht, dort zu posten – Community-Mitglieder und Entwickler sind sehr hilfsbereit
https://ask.discourse.com : ein Chatbot, der auf Discourse-Support und Daten trainiert wurde, überraschend effektiv bei der Beantwortung von Fragen (ja, wirklich)

Vollständiger Text

Stellen Sie sicher, dass Sie auf jede Situation vorbereitet sind

Es wird dringend empfohlen, zusätzlich zu lokalen Backups (die auf demselben Server wie das Forum gespeichert sind), eine Kopie dieser Backups auf einem anderen Server oder in der Cloud[1:1] aufzubewahren.

Es ist auch nützlich, eine Kopie der Datei /var/discourse/containers/app.yml an einem sicheren Ort aufzubewahren[2:1]. Diese optionale Datei wird im Falle einer Neuinstallation des Forums oder einer Migration auf einen anderen Server verwendet.

Wenn bei irgendetwas ernsthafte Zweifel bestehen, kontaktieren Sie mich (canapin@gmail.com).

Updates

:information_source: Bevor Sie ein Update durchführen, wird dringend empfohlen, das neueste Backup Ihres Forums herunterzuladen.

Über die Oberfläche

Führen Sie Updates durch, wenn im Admin-Bereich ein unglückliches rotes Smiley erscheint (es bedeutet, dass ein wichtiges Update durchgeführt werden muss).
Updates werden über https://yourforum.com/admin/upgrade durchgeführt

Manchmal sind sie in zwei Schritten durchzuführen: Sie müssen zuerst „Docker_Manager“ aktualisieren, bevor Sie den Rest aktualisieren können:

Über die Kommandozeile

Manchmal muss ein Update über die Kommandozeile durchgeführt werden (die Discourse-Admin-Seite wird dies bei Bedarf anzeigen).

  1. Verbinden Sie sich über SSH mit dem Server
  2. Erstellen Sie das Forum neu (ein Neuerstellen aktualisiert immer Discourse) mit dem folgenden Befehl:
  3. /var/discourse/launcher rebuild app
    
  4. Von Zeit zu Zeit, nachdem Sie sichergestellt haben, dass das Forum korrekt funktioniert, kann es nützlich sein, nicht verwendete Docker-Images (Überbleibsel früherer Upgrades) zu entfernen, um Speicherplatz freizugeben:
    /var/discourse/launcher cleanup
    

Was tun, wenn das Forum nicht mehr funktioniert?

Das Neuerstellen des Forums behebt viele Probleme und wird mit demselben Befehl wie ein Kommandozeilen-Update durchgeführt:

/var/discourse/launcher rebuild app

Ich denke, es ist jetzt ziemlich gut und ich habe nichts Wichtiges ausgelassen :slight_smile:


  1. Wenn ich Ihr Forum installiert habe, werden Ihre Backups automatisch in meinen Google Drive kopiert, aber idealerweise sollten sie in Zukunft auf einem Speicherplatz gesichert werden, für den Sie verantwortlich sind. Wir werden eines Tages darüber sprechen :smile: ↩︎ ↩︎

  2. Sie enthält den Benutzernamen und das Passwort des Mailservers sowie die E-Mail-Adresse des Administrators der obersten Ebene (eigentlich meine). ↩︎ ↩︎

3 „Gefällt mir“

Wenn das funktioniert, wäre dies eine bessere (einfachere) Empfehlung als die übliche Zwei-Zeilen-Version (die früher drei war, sodass wir den Trend fortsetzen können).

Beides funktioniert.

Wenn Sie sich im Verzeichnis ./ befinden, ist dies erforderlich, da sich der Speicherort des Launchers nicht im Pfad befindet.

Unter Linux muss, wenn ein Befehl nicht im Pfad enthalten ist, dessen vollständiger Pfad angegeben werden, damit kein Zweifel besteht, welche Datei gemeint ist.

3 „Gefällt mir“

Ja, aber oft macht man mehrere Dinge gleichzeitig, zum Beispiel zuerst eine Bereinigung. In diesem Fall könnte das erste Wechseln des Verzeichnisses kürzer ausfallen.

3 „Gefällt mir“

Ich stimme zu und habe das Thema für die zukünftige Verwendung mit einem Lesezeichen versehen, danke

Nun gut, hier ist die vollständige automatisch übersetzte Anleitung:

Sicherstellen, dass Sie für jede Eventualität vorbereitet sind

Es wird dringend empfohlen, zusätzlich zu lokalen Backups (die auf demselben Server wie das Forum gespeichert sind), eine Kopie dieser Backups auf einem anderen Server oder in der Cloud[1] aufzubewahren.

Es ist auch nützlich, eine Kopie der Datei /var/discourse/containers/app.yml an einem sicheren Ort aufzubewahren[2]. Diese optionale Datei ist nützlich für den Fall einer Neuinstallation des Forums oder einer Migration auf einen anderen Server.

Wenn Sie bei irgendetwas ernsthafte Zweifel haben, kontaktieren Sie mich.

Updates

:information_source: Bevor Sie ein Update durchführen, wird dringend empfohlen, das neueste Backup Ihres Forums herunterzuladen.

Über die Oberfläche

Führen Sie Updates durch, wenn im Admin-Bereich ein unglückliches rotes Smiley angezeigt wird (es bedeutet, dass ein wichtiges Update durchgeführt werden muss).
Updates werden über https://tonforum.fr/admin/upgrade durchgeführt

Manchmal erfolgen sie in zwei Schritten: Sie müssen zuerst „Docker_Manager“ aktualisieren, bevor Sie den Rest aktualisieren können:

Über die Kommandozeile

Manchmal muss ein Update über die Kommandozeile durchgeführt werden (die Discourse-Admin-Seite wird dies anzeigen, falls erforderlich).

  1. Verbinden Sie sich über SSH mit dem Server
  2. Bauen Sie das Forum neu (ein Rebuild aktualisiert immer Discourse) mit dem folgenden Befehl:
  3. /var/discourse/launcher rebuild app
    
  4. Von Zeit zu Zeit, nachdem Sie sichergestellt haben, dass das Forum korrekt funktioniert, kann es nützlich sein, ungenutzte Docker-Images (Überbleibsel früherer Upgrades) zu entfernen, um Speicherplatz freizugeben:
    /var/discourse/launcher cleanup
    

Was tun, wenn das Forum nicht mehr funktioniert?

Das Neuaufbauen des Forums behebt viele Probleme und wird mit demselben Befehl wie ein Update über die Kommandozeile durchgeführt:

/var/discourse/launcher rebuild app

Was, wenn das Forum nach einem Rebuild immer noch nicht funktioniert?

Fragen Sie mich oder posten Sie im offiziellen Support-Forum.

Speicherort wichtiger Dateien auf dem Server

app.yml

Es enthält die Serverkonfiguration und die Liste der installierten Plugins. Sehr nützlich, wenn das Forum auf einen anderen Server verschoben werden muss oder für bestimmte Konfigurationen (z. B. das Verschieben von Uploads und Backups auf eine andere Festplatte). Es befindet sich hier:

/var/discourse/containers/app.yml

mail-receiver.yml

Es enthält die Konfiguration der Software, die das Empfangen und Veröffentlichen von Antworten per E-Mail im Forum ermöglicht. Es befindet sich hier:

/var/discourse/containers/mail-receiver.yml

Backups

Die Backup-Dateien befinden sich hier:

/var/discourse/shared/standalone/backups/default

Wichtige Seiten im Forum-Admin:

Seiten, die nützlich sein können :technologist:

Themes und Komponenten

Sie enthalten unter anderem benutzerdefiniertes CSS und HTML:

https://tonforum.fr/admin/config/customize/themes

Protokolle (Logs)

E-Mail

Nützlich zum Debuggen:

https://tonforum.fr/admin/email-logs

Mitarbeiteraktionen (Staff actions)

Sehr nützlich. Es protokolliert (fast) alle Änderungen der Site-Einstellungen und andere Moderatoren- und Admin-Aktionen.

https://tonforum.fr/admin/logs/staff_action_logs

Fehlerprotokolle (Error logs)

Kann Hinweise geben, wenn ein Problem vorliegt, dessen Ursache nicht offensichtlich ist.

https://tonforum.fr/logs/

Backups

Um die Backup-Häufigkeit und die maximale Anzahl zu ändern, sie anzuzeigen oder herunterzuladen:

https://tonforum.fr/admin/backups

Ressourcen

https://meta.discourse.org : offizieller Support, zögern Sie nicht, dort zu posten, Mitglieder und Entwickler helfen gerne weiter
https://ask.discourse.com : ein Chatbot, der auf Discourse-Support und Daten trainiert ist, überraschend effektiv bei der Beantwortung von Fragen (ja, wirklich)


  1. Wenn ich Ihr Forum installiert habe, werden Ihre Backups automatisch auf meine Google Drive kopiert, aber idealerweise sollten sie zukünftig an einem Ort gespeichert werden, für den Sie verantwortlich sind. Wir werden eines Tages darüber sprechen :smile: ↩︎

  2. Sie enthält die Kennung und das Passwort für den Mailserver sowie die Administrator-E-Mail-Adresse (eigentlich meine). ↩︎

3 „Gefällt mir“