Sauvegardes et restaurations

Instantanés complets du serveur, y compris les canaux, les rôles, les autorisations, les emojis, les autocollants, les règles d'automodulation, les paramètres du serveur, les messages et les rôles des membres. Programmation de sauvegardes automatiques et restauration sur n'importe quel serveur.

Vue d'ensemble

Les sauvegardes Restore Hub capturent un instantané complet de la structure et du contenu de votre serveur Discord. Contrairement aux simples exportations de listes de canaux, Restore Hub sauvegarde tout ce qui est nécessaire pour recréer un serveur à partir de zéro, y compris les écrasements de permissions, les règles d'automod et l'historique des messages (limité par le plan).

Les sauvegardes sont stockées en toute sécurité sur l'infrastructure de Restore Hub et peuvent être restaurées sur le même serveur ou sur un serveur complètement différent. Elles sont donc précieuses pour la reprise après sinistre, la migration des serveurs et la création de modèles.

Ce qui est sauvegardé

Une sauvegarde Restore Hub inclut les données suivantes, capturées via l'API REST de Discord au moment de la création de la sauvegarde :

• Canaux - Tous les types de canaux : texte, voix, annonce, forum, scène et catégories. Inclut le nom du canal, le sujet, la position, le drapeau NSFW, la limite de débit (mode lent), le débit binaire (voix), la limite d'utilisateur (voix), la durée d'archivage automatique par défaut, les balises disponibles (forum) et la catégorie parente.
• Rôles - Chaque rôle dans le serveur : nom, couleur (hex), champ de bits des permissions, position dans la hiérarchie, drapeau de renvoi (affiché séparément), drapeau mentionnable et icône du rôle (le cas échéant).
• L'autorisation écrase - Remplacements d'autorisations pour les rôles et les membres par canal. Pour chaque canal, la sauvegarde stocke les rôles/membres qui ont des autorisations d'écrasement spécifiques.
• Emojis - Tous les emojis personnalisés : nom, drapeau animé et URL CDN pour la recréation. Lors de la restauration, les emojis sont retéléchargés à partir de l'URL CDN.
• Autocollants - Tous les autocollants personnalisés : nom, description, type de format (PNG/APNG/Lottie), balises et URL de l'image.
• Règles de l'Automod - Toutes les règles AutoMod : type de déclencheur, métadonnées de déclenchement (listes de mots clés, motifs de regex, préréglages), actions (blocage, alerte, délai d'attente), rôles et canaux exemptés.
• Paramètres du serveur - Nom du serveur, URL de l'icône, URL de la bannière, URL du splash, description, niveau de vérification, paramètres de notification par défaut, filtre de contenu explicite, canal AFK, délai AFK, canal système et drapeaux du canal système.
• Messages - Messages récents provenant de canaux de texte (limité par le plan). Chaque message contient : le contenu, les informations sur l'auteur (ID, nom d'utilisateur, avatar), les embeds, les URL des pièces jointes, l'horodatage et l'horodatage de l'édition. Les messages sont capturés dans l'ordre chronologique inverse jusqu'à la limite du plan par canal.
• Rôles des membres - Une correspondance entre l'identifiant de l'utilisateur Discord et un tableau d'identifiants de rôles. Cela permet de savoir quels membres avaient quels rôles au moment de la sauvegarde, ce qui permet de restaurer les rôles lors d'une opération de restauration.

Conseil : les sauvegardes sont des instantanés ponctuels. Elles capturent l'état du serveur au moment précis où la sauvegarde est exécutée. Les modifications apportées après la sauvegarde ne sont pas prises en compte.

Création d'une sauvegarde

1. Depuis le tableau de bord - Naviguez vers votre serveur dans le tableau de bord. Cliquez sur "Sauvegardes" dans la barre latérale, puis sur "Créer une sauvegarde". La sauvegarde est mise en file d'attente et traitée en arrière-plan par l'agent de sauvegarde. Vous verrez la mise à jour du statut en temps réel.
2. Depuis Discord (Premium+) - Utilisez la commande /backup dans votre serveur Discord. Le robot confirmera que la sauvegarde a été mise en file d'attente et vous enverra un message de confirmation lorsqu'elle sera terminée.
3. Via l'API - Envoyer une requête POST à /api/v1/servers/:id/backups. La réponse comprend l'identifiant de la sauvegarde et l'état "en attente". Interroger GET /api/v1/servers/:id/backups pour vérifier la progression.

L'agent de sauvegarde s'exécute de manière asynchrone. Pour un grand serveur avec de nombreux canaux et messages, une sauvegarde peut prendre de quelques secondes à plusieurs minutes. Le travailleur récupère toutes les données de l'API REST de Discord, en respectant les limites de débit.

Sauvegardes programmées (Premium+)

À partir de la version Premium, vous pouvez programmer des sauvegardes automatiques à intervalles réguliers. Le planificateur fonctionne de manière indépendante et crée des sauvegardes sans aucune intervention manuelle.

| Paramètres | Description | Valeur par défaut
|---|---|---|
| Intervalle (jours) | Fréquence de création d'une sauvegarde (par exemple, tous les 1 jours, tous les 7 jours) | 1 jour | Intervalle (jours) | Intervalle (jours) | Intervalle (jours) | Intervalle (jours) | Intervalle (jours)
| Nombre maximal de sauvegardes | Nombre maximal de sauvegardes planifiées à conserver. Les plus anciennes sont élaguées automatiquement. | 5 |
| Actif | Si la planification est en cours d'exécution | Oui |

Conseil : L'élagage automatique n'affecte que les sauvegardes programmées. Les sauvegardes manuelles ne sont jamais supprimées automatiquement. Si vous avez 5 sauvegardes programmées et que le maximum est de 5, la sauvegarde programmée la plus ancienne est supprimée lorsqu'une nouvelle sauvegarde est créée.

Limites du régime

| Plan de sauvegarde - Sauvegardes maximales - Messages par canal - Sauvegardes planifiées - Sauvegardes planifiées
|---|---|---|---|
| Sauvegarde gratuite - 3 - 50 - Non - Non - Non
| Premium - 10 - 200 - Oui - Non - Non
| Business | 30 | 500 | Oui
| Entreprise | 50 | 2.000 | Oui

Attention : La limite de messages s'entend par canal et non par sauvegarde. Une sauvegarde de plan gratuit d'un serveur avec 20 canaux de texte capture jusqu'à 50 messages de chaque canal (1 000 messages au total).

Restauration d'une sauvegarde

La restauration reconstruit la structure d'un serveur à partir d'un instantané de sauvegarde. Vous pouvez restaurer sur le même serveur (pour annuler les modifications) ou sur un autre serveur (pour cloner ou migrer).

1. Sélectionner la sauvegarde - Dans le tableau de bord, allez dans Sauvegardes et cliquez sur "Restaurer" sur la sauvegarde que vous voulez restaurer. Vous pouvez également utiliser la commande /restore dans Discord, ou POST à /api/v1/servers/:id/backups/:backupId/restore.
2. Choisir un serveur cible - Par défaut, la sauvegarde est restaurée sur le même serveur. Vous pouvez éventuellement spécifier un autre ID de serveur cible. Le bot doit se trouver sur le serveur cible et disposer des autorisations nécessaires.
3. Choisir ce qu'il faut restaurer - Vous pouvez restaurer sélectivement : les canaux (activés par défaut), les rôles (activés par défaut), les autorisations écrasées (activées par défaut), les emojis (désactivés par défaut), les paramètres du serveur (désactivés par défaut) et les rôles des membres (désactivés par défaut).
4. Confirmer et exécuter - Le travail de restauration est mis en file d'attente et traité par l'employé chargé de la sauvegarde. Restore Hub crée d'abord les rôles (pour établir la hiérarchie), puis les canaux avec leurs autorisations d'écrasement, puis les emojis/autocollants, puis les paramètres du serveur.

Attention : La restauration des canaux SUPPRIME tous les canaux existants dans le serveur cible et les recrée à partir de la sauvegarde. Cette opération est destructive et ne peut être annulée. La restauration des rôles des membres ne fonctionne que pour les membres qui se trouvent actuellement sur le serveur.

Comment Restore gère les identifiants de rôle

Lorsqu'une sauvegarde est créée, les identifiants de rôle sont capturés tels qu'ils existent à ce moment-là. Lors de la restauration sur un autre serveur, ces identifiants de rôle n'existent pas. Restore Hub gère ce problème en créant de nouveaux rôles avec le même nom, la même couleur et les mêmes permissions, puis en mappant les anciens ID de rôle aux nouveaux ID de rôle en interne.

Ce mappage des ID de rôle est utilisé pour : l'écrasement des permissions (les permissions du canal font référence aux rôles par ID), la restauration des rôles des membres (réassignation des rôles aux membres) et les dérogations aux permissions au niveau du canal.

Utilisation de sauvegardes sur différents serveurs

Les sauvegardes ne sont pas verrouillées sur le serveur à partir duquel elles ont été créées. Vous pouvez restaurer n'importe quelle sauvegarde sur n'importe quel serveur où votre robot dispose des autorisations nécessaires. Cas d'utilisation courants :

• Modèles de serveur - Créer une sauvegarde d'un serveur parfaitement configuré et la restaurer sur de nouveaux serveurs comme point de départ.
• Migration - Sauvegardez votre ancien serveur, créez-en un nouveau et restaurez toute la structure.
• Reprise après sinistre - Si votre serveur est détruit ou compromis, restaurez-le à partir de la sauvegarde la plus récente.
• Essais - La restauration sur un serveur de test permet d'expérimenter des modifications sans affecter le serveur réel.

Le travailleur de réserve

Les sauvegardes et les restaurations s'exécutent de manière asynchrone par le biais d'un travailleur en arrière-plan (file d'attente de travaux BullMQ). Lorsque vous créez une sauvegarde ou une restauration, un travail est ajouté à la file d'attente. Le travailleur le récupère, le traite (récupère les données de Discord ou crée des ressources) et met à jour l'enregistrement de la sauvegarde dans la base de données.

Le travailleur respecte les limites de débit de l'API REST de Discord. Pour les grands serveurs, le travailleur peut prendre plusieurs minutes. Vous pouvez suivre la progression via le tableau de bord, qui interroge les mises à jour d'état.