docker exec -it abre uma shell interativa dentro de um contentor que já está em execução: -i mantém a entrada padrão aberta e -t atribui um terminal. Em produção, comece com sh se não sabe o que a imagem inclui, defina o utilizador com -u e o diretório com --workdir, e não altere nada que não sobreviva a uma recriação.

docker exec -it: sintaxe mínima e o que faz cada flag

A forma básica é docker exec [options] CONTAINER COMMAND, e o comando é executado no contentor existente em vez de criar um novo. Encontre primeiro o nome exato e depois entre:

docker ps
docker exec -it api sh

# With Docker Compose, by service name
docker compose exec api sh

-i liga a sua entrada padrão ao processo e -t dá-lhe um pseudoterminal; sem -t não tem prompt nem edição de linha. docker compose exec atribui um terminal por omissão e -T desativa-o, que é o que os scripts precisam. Se o contentor estiver preso num ciclo de reinícios, o exec falhará: verifique primeiro docker logs --tail 100 api.

sh vs bash no docker exec: como saber que shell a imagem inclui

Muitas imagens mínimas, como as baseadas em Alpine, incluem sh mas não bash, e as imagens distroless não incluem shell nenhuma. Peça bash onde não existe e o Docker devolve um erro de executável não encontrado no $PATH. Verifique em vez de adivinhar:

docker exec api sh -c 'command -v bash || echo no-bash'

# Use bash if present, otherwise stay in sh
docker exec -it api bash
docker exec -it api sh

sh é a opção segura por omissão: funciona quase sempre, e ler logs ou verificar a configuração não exige um autocompletar sofisticado. Não instale bash com o gestor de pacotes dentro do contentor por comodidade; essa instalação desaparece no próximo deploy. Se a imagem não tiver shell, o docker cp continua a funcionar, por isso pode extrair ficheiros e lê-los no host.

Utilizador no docker exec: -u, root e ficheiros com o dono errado

Por omissão, o docker exec é executado com o mesmo utilizador do processo principal do contentor, ou seja, o USER da imagem ou o --user com que foi criado. Confirme quem é antes de tocar em qualquer coisa:

docker inspect --format '{{.Config.User}}' api
docker exec api id

# Root only for what strictly needs it
docker exec -it -u 0 api sh

# Same UID:GID as the application
docker exec -it -u 1000:1000 api sh

Uma string vazia devolvida por docker inspect significa que o contentor corre como root. O risco real de -u 0 não é só de segurança: um ficheiro criado como root dentro de um volume partilhado pode impedir que a aplicação, que corre com outro UID, lhe escreva mais tarde. Regra de trabalho: leia como utilizador da aplicação, mude para root para uma ação concreta e saia logo a seguir.

--workdir no docker exec: abrir a shell no diretório que interessa

-w ou --workdir define o diretório de trabalho do comando; sem ele, o docker exec começa no WORKDIR da imagem. Combinado com -u, elimina o erro clássico do cd errado:

docker exec -it -w /var/log/nginx web sh

# One-off command, no interactive shell
docker exec -w /app api ls -la

# User and directory together
docker exec -it -u www-data -w /var/www/html web sh

As verificações de uma linha não precisam de -it: um docker exec sem terminal imprime o resultado e termina, o que facilita repeti-lo e colá-lo num relatório de incidente.

Alterações feitas com docker exec que não sobrevivem à recriação do contentor

Tudo o que for escrito fora de um volume fica na camada gravável do contentor, e docker compose up -d --force-recreate ou qualquer novo deploy descarta essa camada. Um simples docker restart mantém-na, o que faz uma correção rápida parecer permanente quando não o é. Antes de sair, reveja o que alterou:

# A = added, C = changed, D = deleted
docker diff api

# Paths that do persist (volumes and bind mounts)
docker inspect --format '{{range .Mounts}}{{.Destination}} {{end}}' api

# Take a copy before you start poking
docker cp api:/app/config/settings.yml ./settings.yml
  1. Não instale pacotes para depurar; desaparecem e alteram a imagem que julga estar a executar.
  2. Não edite a configuração dentro do contentor; corrija-a na imagem, no ficheiro compose ou no volume.
  3. Não execute chmod nem chown fora de um volume; a próxima recriação reverte-os sem aviso.
  4. Não mate o PID 1; quando o processo principal morre, o contentor inteiro para.

docker exec -it a partir do telemóvel vs do computador: o que muda

Entrar num contentor a partir do telemóvel exige duas coisas que um computador dá como garantidas: teclas como Ctrl e Tab, e uma sessão que sobreviva às deslocações. Eis a comparação:

Necessidade durante o docker execComputadorTelemóvel com termi1
Ctrl+C, Ctrl+D, Tab e setasTeclado físicoTeclado próprio com Esc, Ctrl, Tab e setas
Mudança de redePor SSH, a shell aberta perde-seO Mosh mantém a sessão ao passar do Wi-Fi para os dados móveis
Tarefas longas no hosttmux, configurado à mãotmux: o que deixar a correr continua lá
Descarregar um ficheiro extraído com docker cpscp ou sftp noutra janelaSFTP integrado sem sair da sessão
Escrever o comandoÀ mão ou a partir do históricoA IA escreve-o no prompt sem carregar em Enter

Numa ligação marcada como produção, o Production Guard do termi1, o terminal SSH móvel não envia Enter automaticamente a nada e retém tudo o que apague, pare ou altere algo antes de chegar ao prompt, pelo que um docker exec com -u 0 nunca é executado sozinho. A IA não abre a sessão nem recebe teclas, e a chave privada SSH nunca sai do telemóvel. Pode obtê-lo na app termi1 no Google Play; tem mais guias de servidores no blog técnico do termi1.

Perguntas frequentes

Porque é que o docker exec -it não encontra o bash no contentor?

O docker exec -it não encontra o bash porque muitas imagens mínimas, como as baseadas em Alpine, só incluem sh, e as imagens distroless não incluem shell nenhuma. Execute antes docker exec -it contentor sh e, quando não houver shell, extraia os ficheiros com docker cp para os inspecionar no host.

Como obtenho uma shell de root num contentor com docker exec?

Uma shell de root com docker exec usa -u 0, por exemplo docker exec -it -u 0 api sh. Limite-a a uma ação concreta: os ficheiros que criar como root dentro de um volume podem deixar de ter permissão de escrita para a aplicação, que normalmente corre com outro UID.

As alterações feitas com docker exec perdem-se quando o contentor reinicia?

As alterações feitas com docker exec fora de um volume sobrevivem a docker restart, mas perdem-se quando o contentor é recriado com docker compose up -d --force-recreate ou por um novo deploy. O docker diff lista os ficheiros que adicionou, alterou ou eliminou na camada gravável.

Qual é a diferença entre docker exec e docker attach?

O docker exec inicia um novo processo dentro do contentor, enquanto o docker attach se liga à entrada e à saída do processo principal. Com attach, um Ctrl+C pode chegar ao processo principal e parar o contentor, por isso o docker exec é a opção prudente para inspecionar produção.