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

Ecco quindi la guida completa tradotta automaticamente:

Assicurarsi di essere preparati per ogni evenienza

È fortemente consigliato, oltre ai backup locali (memorizzati sullo stesso server del forum), di avere una copia di tali backup su un altro server o nel cloud[1].

È anche utile conservare una copia del file /var/discourse/containers/app.yml in un luogo sicuro[2]. Questo file opzionale è utile in caso di reinstallazione del forum o migrazione su un altro server.

Se hai dubbi seri su qualcosa, contattami.

Aggiornamenti

:information_source: Prima di effettuare un aggiornamento, è fortemente consigliato scaricare l’ultimo backup del tuo forum.

Tramite l’interfaccia

Esegui gli aggiornamenti quando c’è una faccina rossa triste nell’amministrazione (significa che c’è un aggiornamento importante da fare).
Gli aggiornamenti si effettuano tramite https://tonforum.fr/admin/upgrade

A volte avvengono in due fasi: devi prima aggiornare “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à se necessario).

  1. Connettiti al server tramite SSH
  2. Ricostruisci il forum (una ricostruzione aggiorna sempre Discourse) usando il seguente comando:
  3. /var/discourse/launcher rebuild app
    
  4. Di tanto in tanto, dopo esserti assicurato che il forum funzioni correttamente, può essere utile rimuovere le immagini Docker inutilizzate (avanzi di aggiornamenti precedenti) per liberare spazio su disco:
    /var/discourse/launcher cleanup
    

Cosa fare se il forum non funziona più?

Ricostruire il forum risolve molti problemi e si esegue con lo stesso comando di un aggiornamento tramite riga di comando:

/var/discourse/launcher rebuild app

E se il forum ancora non funziona dopo una ricostruzione?

Chiedi a me o pubblica sul forum di supporto ufficiale.

Posizione dei file importanti sul server

app.yml

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

/var/discourse/containers/app.yml

mail-receiver.yml

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

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

Backup

I file di backup si trovano qui:

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

Pagine importanti nell’amministrazione del forum:

Pagine che possono essere utili :technologist:

Temi e componenti

Contengono, tra le altre cose, CSS e HTML personalizzati:

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

Log

Email

Utile per il debug:

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

Azioni dello staff

Molto utile. Mantiene una registrazione di (quasi) tutte le modifiche alle impostazioni del sito e altre azioni di moderatori e amministratori.

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

Log degli errori

Può fornire indizi quando c’è un problema la cui causa non è ovvia.

https://tonforum.fr/logs/

Backup

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

https://tonforum.fr/admin/backups

Risorse

https://meta.discourse.org : supporto ufficiale, non esitare a pubblicare lì, membri e sviluppatori sono felici di aiutare
https://ask.discourse.com : un chatbot addestrato sul supporto e sui dati di Discourse, sorprendentemente efficace nel rispondere alle domande (sì, davvero)


  1. Se ho installato il tuo forum, i tuoi backup vengono copiati automaticamente sul mio Google Drive, ma idealmente in futuro dovrebbero essere salvati in uno spazio di cui sei responsabile. Ne parleremo un giorno :smile: ↩︎

  2. Contiene l’identificativo e la password per il server di posta, nonché l’email amministratore (la mia, in realtà). ↩︎

3 Mi Piace