Sto scrivendo una breve documentazione per gli admin dei forum Discourse che ho aiutato a configurare. Mi manca qualcosa?

[Canapin (Coin-coin le Canapin)]

J’ai configurato forum Discourse per diversi amici/associazioni. Vorrei che fossero più autonomi nell’amministrazione, in modo da intervenire meno io stesso.

Usano Discourse come utenti e co-amministratori da mesi o anni. Non sono “nuovi amministratori”, ma mancano loro di una conoscenza approfondita su come mantenere Discourse quotidianamente (al di fuori delle basi della moderazione) e su cosa si dovrebbe sapere, in quanto amministratori, in caso di problemi tecnici, poiché sono sempre stato io a occuparmi di tali cose.

Sarò ancora disponibile in futuro, ma l’obiettivo è consentire loro di monitorare e risolvere da soli i problemi più comuni.

Ecco cosa ho scritto finora (tradotto automaticamente in inglese perché il mio testo sarà scritto in francese, quindi non fate caso se alcune frasi sono strane):

---

Aggiornamenti

Tramite l’interfaccia web

Eseguire gli aggiornamenti quando compare una faccina rossa triste nel pannello di amministrazione (indica che c’è un aggiornamento importante da applicare).
Gli aggiornamenti si eseguono tramite:
https://tonforum.fr/admin/upgrade

A volte si svolgono in due fasi: potrebbe essere necessario aggiornare prima “Docker_Manager” prima di poter aggiornare il resto:

Tramite riga di comando

A volte, un aggiornamento deve essere eseguito tramite riga di comando (la pagina di amministrazione di Discourse lo indicherà esplicitamente se necessario).

1. Connettersi al server tramite SSH
2. Ricostruire il forum (una ricostruzione aggiorna sempre Discourse) usando il seguente comando:

3. /var/discourse/launcher rebuild app
   

4. Di tanto in tanto, una volta confermato che il forum funziona correttamente, può essere utile rimuovere le immagini Docker inutilizzate (avanzi degli aggiornamenti precedenti) per liberare spazio su disco:

   /var/discourse/launcher cleanup
   

Posizione dei file importanti sul server

app.yml

Contiene la configurazione del server e l’elenco dei plugin installati. Molto utile se si deve migrare il forum su un altro server o applicare determinate configurazioni (ad esempio, spostare caricamenti e backup su un altro disco). Si trova qui:

/var/discourse/containers/app.yml

mail-receiver.yml

Contiene la configurazione del software che consente di ricevere risposte via email e pubblicarle sul forum. Si trova qui:

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

Backup

I file di backup sono memorizzati qui:

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

Pagine importanti nell’amministrazione del forum

Alcune pagine che possono essere utili

Temi e componenti

Includono CSS e HTML personalizzati:

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

Log

Email

Utili per il debug:

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

Azioni dello staff

Molto utili. Conservano una registrazione di (quasi) tutte le modifiche alle impostazioni del sito e altre azioni eseguite da moderatori e amministratori.

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

Log degli errori

Possono fornire indizi quando un problema non è ovvio:

https://tonforum.fr/logs/

Backup

Per modificare la frequenza dei backup e il numero massimo di backup, visualizzarli o scaricarli:

https://tonforum.fr/admin/backups

Risorse

https://meta.discourse.org
Supporto ufficiale. Non esitate a pubblicare lì; i membri della community e gli sviluppatori sono solitamente molto disponibili.

---

Vedete qualcosa che si potrebbe aggiungere/rimuovere? Penso di poter rimuovere la parte /logs/, dato che è molto, molto raramente utile. Non sono nemmeno sicuro di aver trovato informazioni utili in essa in molti anni di amministrazione di alcune istanze.

[Ed_S]

Un paio di cose che vorrei chiarire.

Una è che, nel momento in cui si tenta un aggiornamento tramite interfaccia web, siate consapevoli che l’aggiornamento potrebbe fallire e il vostro forum potrebbe essere inattivo. Siate preparati.

Un’altra è che, se il vostro host diventa inaccessibile o corrotto, avrete bisogno dei file di backup e dei file yml. Dovrete averli già salvati in un luogo sicuro su un sistema separato.

Per combinare le due cose: fate sempre un backup e scaricate il backup, prima di tentare un aggiornamento.

[Heliosurge (Dan DeMontmorency)]

Ciao Ed, punti molto validi. Un membro tempo fa ha creato uno script per il backup su un altro sistema, se ricordo bene. Dovrò fare una ricerca e controllare.

Ecco un estratto dal post originale. Canapin ha una buona risposta con un link per il backup su Google Drive/Dropbox.

@Lhc_fl

Recentemente, un mio amico si è imbattuto nel problema che il fornitore di VPS ha chiuso improvvisamente senza preavviso. Purtroppo, per risparmiare, ha scelto un fornitore di nicchia, uno che non offriva nemmeno il download dei dati. Peggio ancora, non aveva nemmeno l’abitudine di scaricare regolarmente i backup. Da un giorno all’altro, il suo sito è scomparso, insieme a tutti i dati in esso contenuti.

Scioccato da questo, ho scritto uno script Powershell che scaricherà automaticamente i backup dal tuo server al tuo computer locale regolarmente senza dover acquistare servizi di archiviazione oggetti aggiuntivi o spendere un centesimo per altre cose. Tutto ciò di cui hai bisogno è un computer Windows che usi regolarmente (e che abbia molto spazio su disco) e che sia connesso a Internet.

Lo script pulirà automaticamente i backup di 5 giorni fa. Puoi impostare l’intervallo di backup automatico e il tempo del backup più vecchio salvato localmente in base alle tue esigenze.

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


Write-Output "Avvio attività di download backup di Discourse..."
Write-Output '------------------------'
Write-Output "Recupero del file di backup più recente..."
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 "Recupero fallito... Ecco il log:"
            Write-Output '-------------'
            Write-Output $_
            
            $answer = Read-Host "Vuoi recuperare di nuovo? (s/N)"
            if ($answer -ne 's') {
                break
            }
            Write-Output ''
        }
    }
    
    
    if ([String]::IsNullOrEmpty($filename)) {
        Write-Output "Errore: impossibile recuperare il nome del file $filename"
        Write-Output ''
        $answer = Read-Host 'Riprova?(s/N)'
  
        if ($answer -eq 's') {
  
        }
        else {
      
            exit 1
        }
  
    }
    else {

        Write-Output "Backup più recente: $filename"
        Write-Output ''
        
        $need_download = $true
        if (Test-Path ".\backups\$filename") {
            $answer = Read-Host ".\backups\$filename esiste già. Vuoi scaricarlo di nuovo?(s/N)"
            Write-Output ''
            if ($answer -ne 's') {
                $need_download = $false
            }
        }
        if ($need_download) {
            Write-Output "Avvio 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 completato"
                    Write-Output ''
                    
                    break
                }
                catch {

                    Write-Output "Download fallito >_<... Il seguente è il log:"
                    Write-Output ''

                    Write-Output $_
                    
                    $answer = Read-Host "Scarica di nuovo? (s/N)"
                    Write-Output ''
                    if ($answer -ne 's') {
                        break
                    }
                }
            }

        }
  
        Write-Output "Avvio tentativo di pulizia dei vecchi file di backup..."
        Write-Output ''

        $count = 0
        $backupfiles = Get-ChildItem -Path .\\backups\\
  
        foreach ($file in $backupfiles) {
            if ($file.CreationTime -le (Get-Date).AddDays(-5)) {
                try {
                    Write-Output "Eliminazione vecchio file di backup $file ..."
                    Write-Output ''
                    $file.Delete()
                    $count = $count + 1
                } catch {
                    Write-Output "Si è verificato un errore durante l'eliminazione del vecchio file di backup $file >_<"
                    Write-Output '-------------------'
                    Write-Output $_
                    Write-Output '-------------------'
                }
            }
        }

        if ($count -ge 0) {
            Write-Output "Puliti $count vecchi file di backup"
            Write-Output ''
        }
        else {
            Write-Output 'Nessun vecchio file di backup da pulire'
            Write-Output ''
        }

        Pause
  
        exit 0
  
    }
  
  
}

Salva questo script come scriptname.ps1 nel percorso in cui desideri scaricare il backup. Prova “Esegui con Powershell”. Se ha successo, puoi procedere al passo successivo.

Per pianificare un’attività

1. Cerca “Utilità di pianificazione”.
2. Fai doppio clic su Aggiungi attività pianificata. Appare la procedura guidata per l’utilità di pianificazione.
3. Fai clic su Avanti, quindi fai clic su Sfoglia. Appare la finestra di dialogo Seleziona programma da pianificare.
4. Naviga fino allo script che hai creato, fai clic su di esso, quindi su Apri. Si torna alla procedura guidata per l’utilità di pianificazione.
5. Fornisci un nome per l’attività, o mantieni quello predefinito, che è il nome del file, specifica ogni quanto eseguire lo script, quindi fai clic su Avanti.
6. Specifica l’ora e la data di inizio (se hai specificato Giornaliero, Settimanale, Mensile, ecc.) e la ricorrenza, quindi fai clic su Avanti. Questo elemento dovrebbe corrispondere al ciclo di backup automatico del tuo discourse
7. Digita il nome utente e la password per l’account che eseguirà lo script, quindi fai clic su Avanti.
8. Se desideri configurare proprietà avanzate, seleziona la casella di controllo, quindi fai clic su Fine.

@Canapin con l’applicazione di rebuild del launcher, non deve essere eseguito come

./launcher r build app

Questo è solo il modo in cui ho sempre usato eseguirlo da altri documenti qui sul sito. Come ho imparato, ci sono spesso molti modi per fare le cose. Lol

Bella descrizione, utile.