J'écris une courte documentation pour les admins des forums Discourse que j'ai aidé à configurer. Est-ce que j'oublie quelque chose ?

Voici donc le guide complet traduit automatiquement :

S’assurer que vous êtes préparé à toute éventualité

Il est fortement recommandé, en plus des sauvegardes locales (stockées sur le même serveur que le forum), d’avoir une copie de ces sauvegardes sur un autre serveur ou dans le cloud[1].

Il est également utile de conserver une copie du fichier /var/discourse/containers/app.yml dans un endroit sûr[2]. Ce fichier optionnel est utile en cas de réinstallation du forum ou de migration vers un autre serveur.

Si vous avez des doutes sérieux sur quoi que ce soit, contactez-moi.

Mises à jour

:information_source: Avant de faire une mise à jour, il est fortement recommandé de télécharger la dernière sauvegarde de votre forum.

Via l’interface

Faites les mises à jour lorsqu’il y a un smiley rouge mécontent dans l’administration (cela signifie qu’il y a une mise à jour importante à faire).
Les mises à jour se font via https://tonforum.fr/admin/upgrade

Elles se font parfois en deux étapes : il faut d’abord mettre à jour “Docker_Manager” avant de pouvoir mettre à jour le reste :

Via la ligne de commande

Parfois une mise à jour doit se faire via la ligne de commande (la page d’administration de Discourse le signalera si c’est nécessaire).

  1. Connectez-vous au serveur via SSH
  2. Reconstruisez le forum (une reconstruction met toujours à jour Discourse) avec la commande suivante :
  3. /var/discourse/launcher rebuild app
    
  4. De temps en temps, après vous être assuré que le forum fonctionne correctement, il peut être utile de supprimer les images Docker inutilisées (les restes des mises à jour précédentes) pour libérer de l’espace disque :
    /var/discourse/launcher cleanup
    

Que faire si le forum ne fonctionne plus ?

Reconstruire le forum règle beaucoup de problèmes et se fait avec la même commande qu’une mise à jour via la ligne de commande :

/var/discourse/launcher rebuild app

Et si le forum ne fonctionne toujours pas après une reconstruction ?

Demandez-moi ou postez sur le forum de support officiel.

Emplacement des fichiers importants sur le serveur

app.yml

Il contient la configuration du serveur et la liste des plugins installés. Très utile si le forum doit être déplacé sur un autre serveur, ou pour certaines configurations (déplacer les uploads et les sauvegardes sur un autre disque, par exemple). Il se trouve ici :

/var/discourse/containers/app.yml

mail-receiver.yml

Il contient la configuration du logiciel qui permet de recevoir et publier sur le forum les réponses par email. Il se trouve ici :

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

Sauvegardes (Backups)

Les fichiers de sauvegarde se trouvent ici :

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

Pages importantes dans l’administration du forum :

Pages qui peuvent être utiles :technologist:

Thèmes et composants

Ils contiennent, entre autres, du CSS et du HTML personnalisé :

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

Journaux (Logs)

Email

Utile pour le débogage :

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

Actions du personnel (Staff actions)

Très utile. Il garde une trace de (presque) tous les changements de paramètres du site et des autres actions des modérateurs et administrateurs.

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

Journaux d’erreurs (Error logs)

Peut donner des indices lorsqu’il y a un problème dont la cause n’est pas évidente.

https://tonforum.fr/logs/

Sauvegardes (Backups)

Pour modifier la fréquence et le nombre maximum de sauvegardes, les visualiser, ou les télécharger :

https://tonforum.fr/admin/backups

Ressources

https://meta.discourse.org : support officiel, n’hésitez pas à y poster, les membres et les développeurs sont heureux d’aider
https://ask.discourse.com : un agent conversationnel entraîné sur le support et les données de Discourse, étonnamment efficace pour répondre aux questions (oui, vraiment)


  1. Si j’ai installé votre forum, vos sauvegardes sont automatiquement copiées sur mon Google Drive, mais idéalement à l’avenir elles devraient être sauvegardées sur un espace dont vous êtes responsable. On en parlera un jour :smile: ↩︎

  2. Il contient l’identifiant et le mot de passe du serveur mail, ainsi que l’email administrateur (le mien, en fait). ↩︎

3 « J'aime »