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

[Canapin (Coin-coin le Canapin)]

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

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.

[Ed_S]

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.

[Heliosurge (Dan DeMontmorency)]

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.

@Lhc_fl

Kürzlich stieß eine Freundin von mir auf das Problem, dass der VPS-Anbieter plötzlich und ohne Vorankündigung den Betrieb einstellte. Leider wählte sie aus Kostengründen einen Nischenanbieter – einen, der nicht einmal das Herunterladen von Daten anbot. Was noch schlimmer ist: Sie hat nicht die Gewohnheit, regelmäßig Backups herunterzuladen. Über Nacht verschwand ihre Website zusammen mit allen darauf befindlichen Daten.

Davon schockiert schrieb ich ein Powershell-Skript, das automatisch regelmäßig Backups von Ihrem Server auf Ihren lokalen Computer herunterlädt, ohne dass zusätzliche Objektspeicherdienste gekauft oder einen Cent für andere Dinge ausgegeben werden müssen. Alles, was Sie benötigen, ist ein Windows-Computer, den Sie regelmäßig benutzen (und der über viel Festplattenspeicher verfügt) und der mit dem Internet verbunden ist.

Das Skript löscht automatisch Backups, die älter als 5 Tage sind. Sie können das automatische Sicherungsintervall und die lokal gespeicherte älteste Sicherungszeit nach Bedarf einstellen.

$ssh_port = 22
$ssh_address = "username@your.site"


Write-Output "Starte den Downloadvorgang für die Discourse-Sicherung..."
Write-Output '------------------------'
Write-Output "Rufe die neueste Sicherungsdatei ab..."
Write-Output ''

while ($true) {

    $filename = ''

    while ($true) {
        try {
            Write-Output "> ssh -p $ssh_port $ssh_address 'cd /var/discourse/shared/standalone/backups/default/ && ls -t | head -n 1'"
            Write-Output ''
            $filename = ssh -p $ssh_port "$ssh_address" 'cd /var/discourse/shared/standalone/backups/default/ && ls -t | head -n 1'
            break
        }
        catch {
            $filename = ''
    
            Write-Output "Abruf fehlgeschlagen... Hier ist das Protokoll:"
            Write-Output '-------------'
            Write-Output $_
            
            $answer = Read-Host "Möchten Sie erneut abrufen? (j/N)"
            if ($answer -ne 'j') {
                break
            }
            Write-Output ''
        }
    }
    
    
    if ([String]::IsNullOrEmpty($filename)) {
        Write-Output "Fehler: Dateiname $filename konnte nicht abgerufen werden"
        Write-Output ''
        $answer = Read-Host 'Erneut versuchen?(j/N)'
  
        if ($answer -eq 'j') {
  
        }
        else {
      
            exit 1
        }
  
    }
    else {

        Write-Output "Neueste Sicherung: $filename"
        Write-Output ''
        
        $need_download = $true
        if (Test-Path ".\backups\$filename") {
            $answer = Read-Host ".\backups\$filename existiert bereits. Möchten Sie es erneut herunterladen?(j/N)"
            Write-Output ''
            if ($answer -ne 'j') {
                $need_download = $false
            }
        }
        if ($need_download) {
            Write-Output "Starte den Download..."
            Write-Output ''
            
            while ($true) {
                try {
                    Write-Output "scp -p $ssh_port ${ssh_address}:/var/discourse/shared/standalone/backups/default/$filename .\\backups\\"
                    Write-Output ''

                    scp -p $ssh_port "${ssh_address}:/var/discourse/shared/standalone/backups/default/$filename" .\\backups\\
                    
                    Write-Output "Download abgeschlossen"
                    Write-Output ''
                    
                    break
                }
                catch {

                    Write-Output "Download fehlgeschlagen >_<... Das Protokoll lautet:"
                    Write-Output ''

                    Write-Output $_
                    
                    $answer = Read-Host "Erneut herunterladen? (j/N)"
                    Write-Output ''
                    if ($answer -ne 'j') {
                        break
                    }
                }
            }

        }
  
        Write-Output "Versuche, alte Sicherungsdateien zu bereinigen..."
        Write-Output ''

        $count = 0
        $backupfiles = Get-ChildItem -Path .\\backups\\
  
        foreach ($file in $backupfiles) {
            if ($file.CreationTime -le (Get-Date).AddDays(-5)) {
                try {
                    Write-Output "Lösche alte Sicherungsdatei $file ..."
                    Write-Output ''
                    $file.Delete()
                    $count = $count + 1
                } catch {
                    Write-Output "Ein Fehler ist beim Löschen der alten Sicherungsdatei $file aufgetreten >_<"
                    Write-Output '-------------------'
                    Write-Output $_
                    Write-Output '-------------------'
                }
            }
        }

        if ($count -ge 0) {
            Write-Output "Habe $count alte Sicherungsdateien bereinigt"
            Write-Output ''
        }
        else {
            Write-Output 'Keine alten Sicherungsdateien zum Bereinigen erforderlich'
            Write-Output ''
        }

        Pause
  
        exit 0
  
    }
  
  
}

Speichern Sie das obige Skript als scriptname.ps1 in dem Pfad, in dem Sie das Backup herunterladen möchten. Versuchen Sie „Mit Powershell ausführen“. Wenn dies erfolgreich ist, können Sie mit dem nächsten Schritt fortfahren.

So planen Sie eine Aufgabe

1. Suchen Sie nach „Geplante Aufgaben“.
2. Doppelklicken Sie auf „Geplante Aufgabe hinzufügen“. Der Assistent für geplante Aufgaben wird angezeigt.
3. Klicken Sie auf Weiter und dann auf Durchsuchen. Das Dialogfeld „Programm zur Planung auswählen“ wird angezeigt.
4. Navigieren Sie zu dem von Ihnen erstellten Skript, klicken Sie darauf und dann auf Öffnen. Sie kehren zum Assistenten für geplante Aufgaben zurück.
5. Geben Sie einen Namen für die Aufgabe ein oder behalten Sie den Standardnamen bei, der der Dateiname ist, geben Sie an, wie oft das Skript ausgeführt werden soll, und klicken Sie dann auf Weiter.
6. Geben Sie die Startzeit und das Datum (falls Sie Täglich, Wöchentlich oder Monatlich usw. angegeben haben) und die Wiederholung an und klicken Sie dann auf Weiter. Dieser Eintrag sollte mit dem automatischen Sicherungszyklus Ihres Discourse übereinstimmen
7. Geben Sie den Benutzernamen und das Kennwort für das Konto ein, das das Skript ausführen soll, und klicken Sie dann auf Weiter.
8. Wenn Sie erweiterte Eigenschaften konfigurieren möchten, aktivieren Sie das Kontrollkästchen und klicken Sie dann auf Fertig stellen.

@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.