Gerir uma stack docker compose a partir do telemóvel resume-se a quatro comandos. docker compose ps mostra o estado e docker compose logs -f --tail 100 service segue um log. docker compose restart service reinicia um serviço e docker compose pull && docker compose up -d atualiza as imagens. Execute-os todos a partir do diretório que contém o ficheiro compose.

docker compose ps: verificar o estado dos serviços a partir do telemóvel

docker compose ps lista os contentores do projeto com o nome, o serviço, o estado e as portas publicadas. É o primeiro comando a executar depois de se ligar: indica se algo reiniciou, se um serviço terminou com erro ou se o seu healthcheck reporta unhealthy. Execute-o no diretório que contém o ficheiro compose ou indique o nome do projeto com -p.

cd /srv/app
docker compose ps
docker compose ps -a
docker compose ps --services
docker compose ps --format "table {{.Name}}\t{{.Status}}"

No ecrã de um telemóvel, a tabela completa divide-se por várias linhas. -a inclui os contentores parados, --services mostra apenas os nomes dos serviços e --format mantém só as colunas que cabem na vertical.

docker compose logs -f --tail 100: seguir um serviço sem inundar o ecrã

--tail 100 limita a saída às últimas 100 linhas por contentor e -f mantém o log aberto, mostrando as novas linhas à medida que chegam. Sem nome de serviço, o Compose intercala a saída de todo o projeto, o que é ilegível num telemóvel, por isso indique sempre o serviço.

docker compose logs -f --tail 100 api
docker compose logs --since 10m api
docker compose logs -t --tail 50 api worker
docker compose logs --tail 200 api | grep -i error
  • --since 10m mostra apenas o que aconteceu nos últimos dez minutos.
  • -t acrescenta um carimbo temporal a cada linha.
  • | grep -i error filtra o texto antes de chegar ao ecrã.

Prima Ctrl+C para deixar de seguir o log; o contentor continua em execução. O teclado do sistema no iOS e no Android não tem tecla Ctrl. O teclado do termi1 acrescenta-a junto de Esc, Tab e das setas, além de uma camada fn com PgUp/PgDn, Home e End.

docker compose restart e pull && up -d: reiniciar e atualizar passo a passo

docker compose restart api reinicia os contentores do serviço sem os recriar, pelo que não aplica alterações ao ficheiro compose, às variáveis de ambiente ou à imagem. Para isso precisa de docker compose up -d, que recria apenas os contentores cuja configuração ou imagem mudou.

docker compose restart api
docker compose pull && docker compose up -d
docker compose pull api && docker compose up -d api

Uma sequência segura para atualizar a partir do telemóvel:

  1. Verifique o estado com docker compose ps antes de mexer em qualquer coisa.
  2. Descarregue as imagens com docker compose pull; se falhar, ainda nada parou.
  3. Aplique as alterações com docker compose up -d, que recria os contentores afetados e devolve a prompt.
  4. Confirme novamente com docker compose ps que tudo está em execução.
  5. Acompanhe o arranque com docker compose logs -f --tail 100 api e saia com Ctrl+C.

Encadear com && garante que up -d só é executado se pull terminar sem erros.

docker compose no telemóvel versus no computador: tabela comparativa

O que se comparaComputadoriOS/Android com termi1
Parar logs -f com Ctrl+CTecla Ctrl físicaTecla Ctrl no teclado integrado
Esc, Tab e setasSempre disponíveisNo teclado do termi1; o teclado do sistema esconde-as
Passar do wifi para dados móveisRede normalmente fixaO Mosh mantém a sessão aberta
pull longo com o telemóvel bloqueadoA máquina continua ligadaO tmux mantém o processo e a sua saída
Consultar compose.yaml ou .envEditor local ou scpSFTP integrado sem sair da sessão
Escrever comandos longosTeclado completoSugestões durante a escrita ou IA que redige o comando

Mosh, tmux e a IA do termi1 para docker compose em produção

O Mosh usa UDP, por omissão nas portas 60000-61000, e inicia o mosh-server através de uma ligação SSH inicial, pelo que essas portas têm de estar abertas no servidor. Com o Mosh, um docker compose logs -f em execução sobrevive a sair do escritório e a mudar para dados móveis.

Para operações longas, execute-as dentro do tmux, o multiplexador de terminal:

tmux new -s deploy
docker compose pull && docker compose up -d
# Ctrl+b then d to detach
tmux attach -t deploy

A IA do termi1, o terminal SSH para telemóvel, transforma uma frase como «segue os logs da api» no comando e escreve-o na prompt sem premir Enter. No modo «Rever» nunca prime Enter. No modo «Auto seguro» só um conjunto limitado de comandos reconhecidos como seguros o recebe. Nas ligações marcadas como produção, o Production Guard bloqueia qualquer Enter automático e retém tudo o que pare ou altere algo, como um restart, antes de chegar à prompt. A IA nunca abre a sessão nem recebe chaves: a chave privada é gerada e guardada no armazenamento seguro do telemóvel.

Se o servidor não tiver IP público, uma rede mesh privada como a Prialo ou a Tailscale permite aceder-lhe por SSH sem abrir portas. O termi1 é gratuito na App Store para iPhone e no Google Play.

Perguntas frequentes

Como saio do docker compose logs -f sem parar o contentor?

O docker compose logs -f termina com Ctrl+C, que apenas deixa de seguir o log; os contentores continuam em execução. No telemóvel precisa de um teclado com tecla Ctrl, como o teclado do termi1, ou de um cliente que a ofereça numa barra extra por cima do teclado do sistema.

Qual é a diferença entre docker compose restart e docker compose up -d?

docker compose restart reinicia os contentores existentes sem os recriar, pelo que ignora alterações à imagem, às variáveis de ambiente ou ao ficheiro compose. docker compose up -d compara a configuração atual e recria, em segundo plano, apenas os contentores que mudaram. Depois de um pull, o up -d é o comando certo.

Porque é que o docker compose ps não mostra nenhum contentor?

O docker compose ps só lista os contentores do projeto no diretório atual e, sem -a, oculta os que estão parados. Se o executar a partir de outra pasta, faça cd para o diretório do ficheiro compose, indique o caminho do ficheiro com -f ou dê o nome do projeto com -p.

Posso gerir o docker compose a partir do telemóvel sem abrir a porta 22?

É possível gerir o docker compose a partir do telemóvel sem expor a porta TCP 22 à internet, usando uma rede mesh privada como a Prialo ou a Tailscale. O telemóvel e o servidor comunicam dentro dessa rede, e a ligação SSH ou Mosh passa por ela sem portas públicas.