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
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).
- Connectez-vous au serveur via SSH
- Reconstruisez le forum (une reconstruction met toujours à jour Discourse) avec la commande suivante :
-
/var/discourse/launcher rebuild app - 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 ![]()
Thèmes et composants
Ils contiennent, entre autres, du CSS et du HTML personnalisé :
https://tonforum.fr/admin/config/customize/themes
Journaux (Logs)
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)
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↩︎
Il contient l’identifiant et le mot de passe du serveur mail, ainsi que l’email administrateur
(le mien, en fait). ↩︎
