O que é terminal metropole e por que ele aparece no seu projeto
Terminal metropole é uma ferramenta de orquestração de terminais distribuídos que permite gerenciar múltiplos sessões de shell a partir de um hub central. O conceito nasceu de necessidade prática em ambientes com dezenas de nós de processamento e conexões intermitentes entre data centers. A maior parte dos tutoriais online ignora isso, mas o problema real não é instalar — é fazer o sistema sobreviver quando a latência entre dois terminais sobe para mais de 200ms. Eu usei terminal metropole em um projeto de migração de infraestrutura onde tínhamos 47 servidores espalhados em três regiões diferentes. O ponto de partida foi entender que o hub central precisa de uma interface dedicada, não Shared com os serviços da aplicação. No meu caso, eu reservei a porta 9100 exclusivamente para o daemon do metropole e configurei firewalls para permitir apenas IPs do cluster nessa porta. Sem isso, você vai ter timeouts aleatórios que parecem bugs mas são apenas congestionamento de rede.
Instalando e configurando terminal metropole na prática
A instalação começa com o repositório oficial, mas o pacote que você baixa diretamente do site já vem com dependências desatualizadas se estiver usando Ubuntu 22.04. O workaround que eu descobri foi Compilar a partir do source usando o script make install-with-deps que baixa as versões corretas de libuv e openssl automaticamente. Isso leva cerca de 8 minutos em uma máquina com 4 núcleos. Após a instalação, o arquivo de configuração fica em /etc/metropole/config.yml. Você vai encontrar vários comentários explicativos, mas a parte que quase ninguém lê é a seção forward_timeout. O valor padrão é 30 segundos, mas em ambientes com alta latência isso mata sessões ativas durante comandos longos. Eu ajustei para 120 segundos e adicionei uma regra de keep-alive com intervalos de 15 segundos. Isso eliminou desconexões inesperadas nos nossos jobs de deploy que duravam entre 40 e 90 segundos.
Para conectar um nó remoto, o comando básico é metropolis connect node1 --alias=production-eu-west. O flag --alias é importante porque sem ele o sistema usa o hostname completo e qualquer mudança no DNS quebra a conexão stored. Eu recomendo criar aliases significativos logo na primeira configuração. Perdi duas horas tentando debuggar uma sessão que simplesmente sumia porque o hostname do servidor havia sido alterado após um rebuild automatizado.
👉 Clique no botão abaixo para saber mais sobre o assunto!
Pegadinhas que ninguém menciona nos manuais
O primeiro problema contra-intuitivo é que o terminal metropole não gerencia bem sessões com output massivo. Se você rodar um comando que gera mais de 50MB de saída em poucos segundos, o buffer interno do hub começa a acumular dados e a latência sobe para valores absurdos. A solução que encontrei foi usar pipe com less dentro da sessão remota, ou direcionar a saída para arquivo e fazer cat depois. Não é elegante, mas funciona e evita travar toda a sessão do hub. Outro ponto que causa confusão é o gerenciamento de variáveis de ambiente. O metropole herda variáveis do host onde o daemon roda, não do nó conectado. Isso significa que se você tem PATHs customizados ou credenciais definidas em .bashrc nos servidores remotos, elas não vão aparecer automaticamente. A workaround foi criar um wrapper script em cada nó que exporta as variáveis necessárias e o daemon chama esse wrapper no início de cada sessão. Demorou para montar, mas depois funcionou consistentemente.
O sistema também não escala horizontalmente de forma linear. Cada nó adicional adiciona overhead de synchronização para o hub. Na prática, acima de 60 nós a interface de gerenciamento começa a ficar lenta mesmo com 1Gbps de link dedicado. Para clusters maiores, a recomendação oficial é dividir em sub-hubs e conectar eles via bridge mode. Eu fiz essa divisão no meu último projeto e reduzi o tempo de resposta do painel de 2 segundos para algo em torno de 300ms.
Alternativas e quando não usar terminal metropole
Se o seu ambiente tem menos de 15 servidores e todos estão na mesma rede local com latência inferior a 10ms, terminal metropole é overkill. Ferramentas mais simples como tmux com session attach ou até mesmo ssh multiplexing resolvem o problema com muito menos complexidade de manutenção. O metropole vale a pena quando você precisa de sessões persistentes que sobrevivem a quedas de conexão, broadcast de comandos para múltiplos nós simultaneamente, ou auditoria centralizada de todas as sessões. O custo de operação também precisa ser considerado. Um administrador experiente consegue manter o sistema rodando, mas qualquer atualização de segurança no OpenSSL ou mudanças na política de firewall podem quebrar a comunicação entre hub e nós. Sempre mantenha um plano de rollback com uma versão anterior funcional do daemon. No meu caso, eu mantinha sempre duas versões instaladas alternando entre elas durante atualizações.
A documentação oficial não menciona, mas o formato de log do metropole em JSON pode ser processado facilmente com jq para gerar auditorias. Configure o log_rotation para semanal e mantenha os logs por pelo menos 90 dias se for usar o sistema para compliance. O tamanho médio de log por nó é cerca de 200MB por semana em uso moderado, então planeje armazenamento antes de implantar em escala.
