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

Allgemein
13

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:

image
image1096×674 23.4 KB

Ü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“