Définissez l'identité avec soin
Choisissez le domaine public avant le lancement et comprenez quels identifiants sont difficiles à modifier ultérieurement. Planifiez la récupération de compte et les e-mails transactionnels. Un chemin de notification fiable est important pour l'inscription et la modération.
Dimensionnez l'ensemble du service
Les processus web, les workers en arrière-plan, PostgreSQL, Redis et le stockage des médias contribuent tous à l'utilisation des ressources. La fédération et les médias distants peuvent dépasser le nombre d'utilisateurs locaux. Mesurez les files de workers, la croissance de la base de données et le stockage.
Maintenez l'administration et la modération actives
Utilisez des versions prises en charge, une authentification administrateur robuste et des contrôles d'inscription réfléchis. Publiez les règles de la communauté et une procédure de contact. Les décisions de fédération nécessitent un opérateur responsable, pas seulement un conteneur en fonctionnement.
Sauvegardez l’état durable
Conservez des sauvegardes de base de données cohérentes, les médias téléversés localement, la configuration et les secrets de signature protégés. Suivez les instructions de récupération amont et testez une restauration. Une copie statique du conteneur web ne constitue pas une sauvegarde complète de l'instance.
Validez le premier parcours utilisateur
Avant d'inviter une communauté, testez l'inscription ou l'invitation, l'acheminement des e-mails, le téléversement de médias, la récupération de mot de passe et une interaction fédérée. Les processus en arrière-plan peuvent échouer alors que la page d'accueil répond encore : surveillez donc les files de tâches et les nouvelles tentatives. Gardez alignés la configuration, la base de données et le plan de récupération des médias locaux.
Documentation officielle : Guide d'installation pour opérateur Mastodon
Donnez un cycle de vie aux médias
La mise en cache de médias distants, les téléversements locaux et les sauvegardes ont des besoins de valeur et de rétention différents. Estimez la croissance et choisissez délibérément tout stockage objet externe. Examinez son emplacement des données, ses identifiants et son coût plutôt que de supposer qu'une intégration de stockage est opérationnellement gratuite.
Choisissez une identité durable et une filière d'installation
Définissez le domaine public de l'instance avant que les utilisateurs ne dépendent des adresses de leurs comptes. Prévoyez SMTP, TLS, un système d'exploitation pris en charge et un stockage suffisant pour les téléversements locaux et les médias fédérés. Le guide d'installation amont actuel fournit une procédure basée sur les sources ; l'empaquetage en conteneur doit être vérifié par rapport au projet et à la version que vous sélectionnez réellement. Évitez de présenter un ancien exemple Compose comme la seule voie prise en charge par les mainteneurs. Planifiez l'administration de la communauté et un contact de récupération en parallèle du logiciel.
- Inventoriez le processus web, le service de streaming, les workers en arrière-plan, PostgreSQL et Redis.
- Utilisez des identifiants de service distincts et gardez les bases de données hors de l'écouteur public.
- Définissez les règles d'inscription et de modération avant d'inviter des utilisateurs.
Documentation officielle : Prérequis pour l’installation de Mastodon
Démarrez une instance testée avant de monter en charge
Suivez la procédure d'installation de la version épinglée, configurez l'origine publique et SMTP, initialisez la base de données et créez un compte opérateur via le chemin d'administration pris en charge. Placez le service derrière un proxy TLS correctement configuré et démarrez les processus web, de streaming et de tâches. Gardez les téléversements persistants séparés des fichiers applicatifs remplaçables. Limitez initialement les inscriptions afin qu'un problème de configuration puisse être corrigé avant que de nombreux comptes et événements fédérés n'en dépendent.
Documentation officielle : Installation officielle de Mastodon
Suivez une publication réelle via le service
Utilisez des comptes de test pour vérifier l'invitation/inscription, la livraison des e-mails, la connexion, le téléversement de médias, une publication locale et une interaction autorisée avec une autre instance. Vérifiez si les tâches en arrière-plan s'achèvent plutôt que de seulement consulter la page d'accueil web. Contrôlez une notification et un message de réinitialisation de mot de passe. Une file d'attente qui s'allonge avec une page d'accueil saine indique un problème de workers ou de dépendances ; une défaillance limitée au streaming indique un problème de service de streaming ou de proxy. Un suivi distant peut échouer en raison de la politique de fédération autant que du transport.
- Enregistrez l'âge de la file des workers, la croissance du stockage et les livraisons échouées.
- Protégez fortement les comptes de modération et d'opérateur.
- Traitez le stockage objet comme une autre dépendance d'accès, de localisation et de sauvegarde s'il est activé.
Préservez les médias locaux et le matériel de signature
Une restauration Mastodon nécessite la base de données, la configuration et les secrets, ainsi que les médias téléversés localement, et non simplement une image d'application téléchargée. Les médias mis en cache à distance peuvent suivre une politique de restauration différente ; distinguez-les des téléversements locaux irremplaçables. Protégez une sauvegarde hors hôte et restaurez-la dans un environnement isolé avant de déclarer le processus fiable. Lisez les notes de migration et de retour arrière propres à chaque version avant de mettre à niveau ; revenir à une version antérieure d'un conteneur n'annule pas automatiquement une migration de base de données.
Documentation officielle : Guide de sauvegarde Mastodon