Mover uma instância do Mastodon de um relé para outro pode interromper a federação se não for feito corretamente. Relés são servidores que encaminham postagens públicas entre instâncias, e alterá-los de forma inadequada pode causar perda de atualizações ou indisponibilidade temporária. Este artigo explica como migrar relés de forma suave, mantendo sua instância totalmente federada e disponível para os usuários. Você aprenderá as etapas de preparação, o procedimento exato de troca de relé e como verificar se a federação continua sem interrupção.
Principais Conclusões: Migração de Relé Sem Lacunas na Federação
- Preferências > Administração > Relés: A interface onde você adiciona, ativa e desativa relés na sua instância do Mastodon.
- Adicione o novo relé antes de remover o antigo: Mantém a instância conectada a pelo menos um relé o tempo todo para evitar indisponibilidade.
- Verifique a federação após a troca: Confira a linha do tempo federada e a acessibilidade de instâncias externas para confirmar que o novo relé está funcionando.
O Que São Relés do Mastodon e Por Que Migrar?
Um relé do Mastodon é um servidor que coleta postagens públicas de várias instâncias e as redistribui para todas as instâncias conectadas. Relés ajudam instâncias menores a descobrir conteúdo do fediverso sem precisar seguir cada usuário individualmente. Quando uma instância se conecta a um relé, ela envia suas próprias postagens públicas para o relé e recebe postagens públicas de todas as outras instâncias conectadas a esse relé.
Você pode precisar mover sua instância entre relés por vários motivos. O relé atual pode ter alta latência ou falhas frequentes. Um novo relé pode oferecer melhor proximidade geográfica ou políticas de moderação mais rigorosas. Ou você pode estar consolidando vários relés em um para simplificar a administração. Seja qual for o motivo, o objetivo é alterar a conexão do relé sem criar um período em que sua instância não esteja recebendo ou enviando postagens públicas através de nenhum relé.
A chave para zero indisponibilidade é a sobreposição de conexões de relé. Enquanto sua instância estiver conectada a pelo menos um relé ativo o tempo todo, a federação continua. O procedimento envolve adicionar o novo relé, ativá-lo, aguardar a sincronização e, em seguida, remover o relé antigo. Isso evita a lacuna que ocorreria se você removesse o relé antigo primeiro.
Pré-requisitos para a Migração de Relé
Antes de começar, confirme que você tem acesso de administrador à sua instância do Mastodon. Você precisa da capacidade de adicionar e remover relés no painel de Administração. Além disso, tenha o endereço do servidor do novo relé pronto. Um endereço de relé geralmente se parece com wss://relay.example.com ou https://relay.example.com. Entre em contato com o operador do relé se você não tiver o endereço correto. Por fim, certifique-se de que sua instância esteja executando uma versão recente do Mastodon, pelo menos a versão 3.4 ou posterior, para suportar os recursos de gerenciamento de relés descritos aqui.
Passos para Migrar Relés Sem Indisponibilidade
Siga estes passos exatos para trocar relés mantendo sua instância totalmente federada. Execute cada etapa na ordem listada. Não remova o relé antigo até confirmar que o novo relé está ativo e funcionando.
- Abra a Página de Administração de Relés
Faça login na sua instância do Mastodon como administrador. Clique em Preferências no menu superior direito. Na barra lateral esquerda, navegue até Administração > Relés. Esta página lista todos os relés atualmente conectados à sua instância. - Adicione o Novo Relé
Clique no botão Adicionar novo relé. Na caixa de diálogo que aparece, cole o endereço do servidor do novo relé. Clique em Adicionar. O relé aparece na lista com o status Pendente. - Ative o Novo Relé
Encontre o novo relé na lista. Clique no botão Ativar ao lado dele. O status muda para Ativado. Sua instância agora começa a enviar postagens públicas para o novo relé e a receber postagens dele. Neste ponto, sua instância está conectada tanto ao relé antigo quanto ao novo simultaneamente. - Aguarde a Sincronização
Aguarde pelo menos 10 a 15 minutos para que o novo relé sincronize com sua instância e para que as postagens fluam através de ambos os relés. Durante esse tempo, verifique a linha do tempo federada na sua instância. Você deve ver postagens chegando de instâncias que usam o novo relé. Se a linha do tempo federada parecer vazia ou desatualizada, aguarde mais ou verifique se o relé está configurado corretamente. - Verifique se o Novo Relé Está Funcionando
Para confirmar que o novo relé está ativo, visite uma instância externa que esteja conectada ao mesmo novo relé. Pesquise por uma postagem pública da sua instância nessa instância externa. Se a postagem aparecer, o relé está funcionando. Alternativamente, peça a um usuário em outra instância para verificar se ele consegue ver postagens públicas da sua instância. - Desative o Relé Antigo
Volte à página de Relés. Encontre o relé antigo na lista e clique em Desativar. O status muda para Desativado. Sua instância agora está conectada apenas ao novo relé. - Remova o Relé Antigo (Opcional)
Depois que o relé antigo estiver desativado, você pode removê-lo completamente clicando em Remover. Isso limpa a lista e evita reativação acidental. A remoção é segura porque o relé já está desativado. - Verificação Final
Após remover o relé antigo, verifique a linha do tempo federada novamente. As postagens devem continuar chegando normalmente. Além disso, teste se instâncias externas ainda conseguem encontrar sua instância pesquisando pelo domínio da sua instância a partir de uma instância diferente. Se tudo estiver certo, a migração está completa.
Erros Comuns e Coisas a Evitar Durante a Migração de Relé
Remover o Relé Antigo Antes de Adicionar o Novo
Este é o erro mais frequente. Se você remover o relé antigo primeiro, sua instância perde a conexão com todos os relés até que você adicione e ative o novo. Durante essa lacuna, sua instância para de receber postagens públicas da rede de relés. Os usuários podem ver uma linha do tempo federada vazia. Sempre adicione o novo relé primeiro, ative-o e verifique se funciona antes de tocar no relé antigo.
Usar um Endereço de Relé Incorreto
Digitar a URL errada ou usar um endereço de relé desatualizado faz com que a etapa de adição falhe ou que o relé permaneça no status Pendente indefinidamente. Verifique novamente o endereço com o operador do relé. Certifique-se de que a URL inclua o protocolo correto, wss:// para relés WebSocket ou https:// para relés HTTP. Alguns relés suportam ambos, mas você deve usar o que o operador fornecer.
Não Aguardar Tempo Suficiente para Sincronização
O tempo de sincronização depende da carga do relé e da latência da rede. Se você desativar o relé antigo muito rapidamente, antes que o novo relé tenha sincronizado completamente, pode perder algumas postagens. A espera de 10 a 15 minutos é o mínimo. Em relés movimentados, aguarde até 30 minutos. Verifique a linha do tempo federada para um fluxo constante de novas postagens antes de prosseguir.
Esquecer de Verificar a Federação a Partir de uma Instância Externa
A linha do tempo federada na sua própria instância mostra apenas as postagens que chegaram. Isso não prova que instâncias externas conseguem ver suas postagens. Para verificar completamente, você deve verificar a partir de outra instância. Se você não conseguir encontrar as postagens da sua instância em uma instância externa, o novo relé pode não estar distribuindo seu conteúdo corretamente. Nesse caso, reative o relé antigo e solucione o problema do endereço ou configuração do novo relé.
Tipos de Relé do Mastodon: WebSocket vs HTTP
| Item | Relé WebSocket | Relé HTTP |
|---|---|---|
| Método de conexão | Conexão bidirecional persistente | Requisições HTTP POST e GET |
| Latência | Menor, entrega quase em tempo real | Maior, depende do intervalo de polling |
| Uso de recursos na instância | Ligeiramente maior devido ao socket persistente | Menor, sem necessidade de conexão persistente |
| Formato do endereço do relé | wss://relay.example.com |
https://relay.example.com |
| Caso de uso comum | Instâncias de alto tráfego que desejam federação rápida | Instâncias menores ou com recursos limitados |
Ao migrar entre relés, observe o tipo de cada relé. Mudar de um relé WebSocket para um relé HTTP pode alterar a experiência de latência para seus usuários. O procedimento de migração em si é idêntico para ambos os tipos. O importante é ter o formato de endereço correto para o novo relé.
Agora você pode mover sua instância do Mastodon entre relés sem interrupção na federação. A técnica principal é adicionar e ativar o novo relé antes de desativar o antigo. Sempre verifique se o novo relé está funcionando conferindo a linha do tempo federada e testando a partir de uma instância externa. Para configurações avançadas, considere automatizar a etapa de verificação com um script que teste periodicamente a federação usando um endpoint de API pública de uma instância conhecida.