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 10mmostra apenas o que aconteceu nos últimos dez minutos.-tacrescenta um carimbo temporal a cada linha.| grep -i errorfiltra 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 apiUma sequência segura para atualizar a partir do telemóvel:
- Verifique o estado com
docker compose psantes de mexer em qualquer coisa. - Descarregue as imagens com
docker compose pull; se falhar, ainda nada parou. - Aplique as alterações com
docker compose up -d, que recria os contentores afetados e devolve a prompt. - Confirme novamente com
docker compose psque tudo está em execução. - Acompanhe o arranque com
docker compose logs -f --tail 100 apie 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 compara | Computador | iOS/Android com termi1 |
|---|---|---|
Parar logs -f com Ctrl+C | Tecla Ctrl física | Tecla Ctrl no teclado integrado |
| Esc, Tab e setas | Sempre disponíveis | No teclado do termi1; o teclado do sistema esconde-as |
| Passar do wifi para dados móveis | Rede normalmente fixa | O Mosh mantém a sessão aberta |
pull longo com o telemóvel bloqueado | A máquina continua ligada | O tmux mantém o processo e a sua saída |
Consultar compose.yaml ou .env | Editor local ou scp | SFTP integrado sem sair da sessão |
| Escrever comandos longos | Teclado completo | Sugestõ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 deployA 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.