Créer, télécharger et restaurer une sauvegarde de votre base de données Discourse

[Discourse]

Ce guide fournit des instructions étape par étape pour créer, télécharger et restaurer une sauvegarde de votre base de données Discourse.

Niveau d’utilisateur requis : Administrateur

Discourse permet aux administrateurs de site de créer et de télécharger une copie de la base de données du site. La sauvegarde peut ensuite être téléchargée et restaurée sur n’importe quel forum Discourse.

Les sauvegardes Discourse incluent la base de données complète du site, qui contient tout ce qui se trouve sur le site : sujets, messages, utilisateurs, groupes, paramètres, thèmes, etc. Selon la manière dont le fichier de sauvegarde est créé, il peut ou non inclure les téléchargements. Les sauvegardes qui incluent les téléchargements sont enregistrées sous forme de fichiers .tar.gz, tandis que les sauvegardes sans téléchargements sont enregistrées sous forme de fichiers .sql.gz. Voir la section suivante pour plus de détails.

Bien que les données créées par les plugins existent dans la base de données, les plugins eux-mêmes sont installés dans votre fichier app.yml. Pour restaurer votre site sur un nouveau serveur, vous devrez vous assurer que votre installation inclut les plugins dont vous avez besoin.

Mode lecture seule

Vous pouvez activer le mode lecture seule sur la page Sauvegardes pour empêcher les modifications du site pour les tâches liées à l’administration. En savoir plus sur le mode lecture seule ici.

Créer une sauvegarde

Pour créer une sauvegarde de votre site Discourse, suivez ces étapes :

1. Accédez à la section Admin / Sauvegardes de votre site.
2. Cliquez sur le bouton Sauvegarde.

3. Une fenêtre modale s’ouvrira avec une case à cocher pour inclure les téléchargements du site dans la sauvegarde. Cochez ou décochez cette option en fonction de vos préférences.

Si votre site est hébergé par nos soins et que vous souhaitez créer une sauvegarde incluant les téléchargements, contactez l’équipe Discourse avant de créer la sauvegarde.

4. Cliquez sur le bouton de confirmation pour démarrer la sauvegarde.

Télécharger une sauvegarde

Lorsque la sauvegarde est terminée, Discourse vous enverra une notification.

• Cliquez sur le lien dans la notification pour revenir à votre page Sauvegardes. Ensuite, cliquez sur le bouton Télécharger.

• Un e-mail contenant un lien pour télécharger la sauvegarde vous sera envoyé. Cliquez sur le lien pour enregistrer la sauvegarde sur votre ordinateur.

Télécharger une sauvegarde

• Pour télécharger une sauvegarde, accédez à la section Admin / Sauvegardes de votre site, naviguez jusqu’à l’onglet Fichiers de sauvegarde, et cliquez sur le bouton Télécharger.

• Cela ouvrira le gestionnaire de fichiers de votre navigateur. Sélectionnez la sauvegarde à partir de votre système de fichiers et cliquez sur le bouton Ouvrir du gestionnaire de fichiers. Le nouveau fichier de sauvegarde apparaîtra dans la liste des fichiers.

Restaurer une sauvegarde

Avant de pouvoir restaurer votre fichier de sauvegarde, vous devez activer le paramètre de site allow restore. Ensuite, sur la page Sauvegardes, trouvez la sauvegarde que vous souhaitez restaurer, cliquez sur le menu d’options supplémentaires (⋮) et sélectionnez Restaurer.

La restauration d’un fichier de sauvegarde écrasera toutes les données du site. Une fois la sauvegarde restaurée, vous serez déconnecté du site et devrez vous reconnecter avec vos identifiants du site restauré.

Assurez-vous que le site sur lequel vous restaurez exécute la même version de Discourse que l’ancien site. Il est préférable de mettre à jour les deux sites vers la dernière version avant d’exécuter le processus de sauvegarde/restauration.

Le processus de restauration définit automatiquement le paramètre disable emails sur « non-staff », de sorte que les e-mails ne seront pas envoyés aux utilisateurs de votre site tant que vous n’êtes pas prêt.

Si votre site est hébergé par Discourse, l’option Restaurer sera désactivée. Après avoir téléchargé le fichier de sauvegarde, contactez l’équipe Discourse et informez-nous du nom du fichier de sauvegarde que vous souhaitez restaurer. Nous nous en chargerons.

Sauvegarde et restauration en ligne de commande

Pour les administrateurs à l’aise avec la ligne de commande, vous pouvez créer et gérer des sauvegardes par programme :

• Les sauvegardes sont stockées dans /var/discourse/shared/standalone/backups.
• Démarrez une sauvegarde en utilisant :

./launcher run app discourse backup

ou

docker exec app bash -c "discourse backup"

Pour plus d’informations sur les sauvegardes en ligne de commande, consultez : Sauvegarder discourse depuis la ligne de commande.