Categorias do Site

Como usar docker exec em containers ativos

Aprenda a usar docker exec para interagir com containers sem reiniciá-los.

Ilustração de um navio azul simplista sobre um fundo abstrato com tons de creme, marrom e laranja que simulam um efeito marmoreado.

O comando exec do Docker permite executar comandos de shell diretamente dentro dos seus containers em execução, sem precisar reiniciá-los. Isso é útil para depurar erros, ajustar configurações ou verificar rapidamente o ambiente de um container, tornando o fluxo de trabalho mais eficiente e evitando tempos de inatividade desnecessários.

docker exec command

Os containers do Docker mudaram a forma como implantamos aplicativos, possibilitando implementar em múltiplas arquiteturas com uma abordagem universal. Com Docker, você pode implementar qualquer coisa, incluindo ferramentas de linha de comando, em diferentes ambientes sem se preocupar com diferenças na infraestrutura subjacente.

Introdução ao docker exec

Antes de explorar o comando, você precisará de um container em execução. Primeiro, se ainda não tiver o Docker instalado, faça o download e configure-o; você precisará dele para executar os comandos.

Depois de tudo configurado, execute este comando para executar o container Ubuntu através da imagem oficial:

docker run -d --name meu_container_ubuntu ubuntu sleep infinity

O que acontece aqui?

  • d — Executa o container em segundo plano (modo desanexado)
  • --name meu_container_ubuntu — Atribui um nome ao container para referências
  • ubuntu — Especifica a imagem do Ubuntu (Docker a baixará se não estiver disponível localmente)
  • sleep infinity — Mantém o container em execução indefinidamente:

getting started with docker exec

Você pode verificar se o container está em execução com o comando ps assim:

docker ps

O comando ps lista todos os containers em execução. Se o container estiver em execução, ele deverá aparecer na lista com o nome atribuído por você.

verify docker container is running

Agora que você está configurado com o Docker e tem um container em execução, pode interagir com ele usando o comando exec.

O comando docker exec

O Docker vem com o comando exec, que permite executar comandos em containers em execução sem reiniciá-los. O comando exec é útil quando você deseja iniciar um shell interativo, inspecionar logs, modificar arquivos ou realizar várias outras tarefas.

A sintaxe geral para o comando docker exec é:

docker exec [OPÇÕES] CONTAINER COMANDO [ARG...]
OpçãoFunçãoDescrição
-d, --detachExecutar em segundo planoExecuta o comando em modo desanexado
--detach-keys stringSobrepor teclas de desanexaçãoDefine uma sequência de teclas personalizada para desanexar um container
-e, --env listDefinir variáveis de ambientePassa variáveis de ambiente para o comando
--env-file listCarregar arquivo envCarrega variáveis de ambiente de um arquivo especificado
-i, --interactiveManter entrada abertaMantém a entrada padrão aberta para interação
--privilegedConceder privilégios estendidosFornece permissões adicionais para executar comandos
-t, --ttyAlocar pseudo-TTYFornece uma interface de shell interativa
-u, --user stringExecutar como usuário específicoExecuta o comando como um usuário especificado
-w, --workdir stringDefinir diretório de trabalhoDefine o diretório de trabalho dentro do container

Você seguirá a opção especificada com o comando e os argumentos que está executando no container. Vamos executar um comando para listar todos os arquivos no diretório do container:

docker exec meu_container_ubuntu ls -l

O comando deve exibir os arquivos e diretórios em formato longo como este:

ubuntu container command output

Neste caso, usei o ID do container para referenciar o container; funciona como usar o nome do container. Você pode adicionar a opção -it para executar um shell interativo dentro do container:

docker exec -it meu_container /bin/bash

Este comando abre um shell Bash em execução no container. Agora, você pode executar comandos diretamente sem o comando exec:

bash shell no need for exec command

Você pode sair do modo interativo com o comando exit que acompanha o sistema operacional. Por padrão, docker exec executa comandos como usuário root dentro do container. Você pode especificar um usuário diferente com a opção -u.

Primeiro, você precisa criar um novo usuário no sistema operacional do container. Execute este comando para criar um novo usuário chamado paul:

docker exec meu_container_ubuntu useradd -m paul

Agora, você pode especificar o usuário antes dos comandos para executar comandos para um usuário:

docker exec -u paul meu_container_ubuntu whoami

Este comando deve exibir o nome de usuário do usuário assim:

who am i command docker

Você pode passar variáveis de ambiente e ler variáveis de ambiente existentes com a opção -e:

docker exec -e MY_VAR=Hello meu_container_ubuntu printenv MY_VAR

Executar este comando deve exibir “Hello”, já que é o valor para a variável de ambiente MY_VAR. Provavelmente, você precisará executar comandos em modo desanexado (em segundo plano). É aí que a opção -d é útil:

docker exec -d meu_container_ubuntu touch /tmp/detached_file

Este comando cria um arquivo vazio dentro do diretório /tmp sem manter uma sessão interativa aberta. Você também pode definir um diretório de trabalho com a opção -w assim:

docker exec -w /var/log meu_container_ubuntu ls

O comando define o diretório de trabalho como /var/log antes de listar todos os arquivos no diretório de trabalho. Se estiver preso no desenvolvimento, você sempre pode usar a opção --help para navegar por todas as opções:

docker-exec-help-flag

Resolvendo erros do docker exec

Você pode encontrar alguns erros ao usar o comando exec do Docker para interagir com containers em execução. Vamos ver alguns deles e como corrigi-los.

Erro “No such container”

Verifique se você está referenciando um container existente. Execute docker ps para visualizar todos os containers em execução, copie a referência e execute o comando com a referência correta.

Erros de permissão negada

Você pode experimentar isso ao tentar executar um comando como um usuário não-root sem os privilégios necessários. Você pode executar o comando como root ou usar a opção --privileged para permissões extras.

Erro “OCI runtime exec failed”

Neste caso, o container provavelmente não está em execução. Execute docker start para iniciar o container, se for o caso.

Você sempre pode visitar o Fórum da Comunidade Docker se tiver erros diferentes ou se nenhuma dessas soluções funcionar para você.

docker exec ou docker attach?

Os comandos exec e attach do Docker são úteis para interagir com containers em execução, mas são construídos para propósitos diferentes.

RecursoDocker execDocker attach
Inicia um novo processo dentro do container
Anexa a um processo em execução existente
Suporta várias sessões ao mesmo tempo
Pode executar comandos interativos ou não-interativos

Você usará docker exec quando precisar executar um comando separado dentro de um container em execução e docker attach se precisar interagir com o processo principal em execução dentro do container.

Conclusão

Neste artigo, você aprendeu a interagir com seus containers em execução usando docker exec. O comando docker exec permite que você execute comandos dentro de um container em execução, seja de forma interativa, com variáveis de ambiente ou como um usuário diferente, sem reiniciar o container. Você também aprendeu a resolver erros comuns e a diferença entre exec e docker attach, que se conecta a um processo já em execução.

  • Desenvolva apps de IA com React e MediaPipe

    Aprenda a criar apps de IA em React usando APIs mais recentes do MediaPipe para detecção de objetos em tempo real.

    Aprenda a criar apps de IA em React usando APIs mais recentes do MediaPipe para detecção de objetos em tempo real.

    Ler notícia completa
  • 12 exemplos de UX para evitar erros de usuário

    Descubra 12 exemplos de design UX que evitam erros de usuários, melhorando a experiência e a usabilidade.

    Descubra 12 exemplos de design UX que evitam erros de usuários, melhorando a experiência e a usabilidade.

    Ler notícia completa
  • Impactos da IA na Próxima Geração de Designers

    Descubra como a IA pode alterar a criatividade e o mercado de trabalho dos designers do futuro.

    Descubra como a IA pode alterar a criatividade e o mercado de trabalho dos designers do futuro.

    Ler notícia completa
  • Melhores fontes numéricas para logos e designs 2025

    A maioria das fontes padrão inclui números, mas muitos designers focam em caracteres alfabéticos, negligenciando os números. Se números são um elemento-chave no seu design, é importante escolher uma fonte com números bem desenhados. Esta lista traz fontes onde os números são um destaque e funcionam bem em diversos projetos tipográficos. Essas fontes são ideais […]

    Descubra as melhores fontes numéricas para logos, tatuagens e infográficos em 2025.

    Ler notícia completa
  • Plataformas de Orquestração de Agentes de IA

    Na primeira onda de IA nas empresas, os copilotos se destacaram. Esses assistentes, integrados em ferramentas como Microsoft 365, Google Workspace e Salesforce, tornaram a IA mais acessível, aumentando a produtividade humana. Entretanto, em 2025, fica claro que os copilotos não são o destino final. Surge então a plataforma de orquestração de agentes de IA: […]

    Orquestração de agentes de IA revoluciona produtividade e arquitetura empresarial, indo além dos copilotos.

    Ler notícia completa
    Ilustração de um personagem sem rosto interagindo com ícones flutuantes de tecnologia, incluindo um robô, uma engrenagem e diagramas de rede.
  • Novas ferramentas de design para julho de 2025

    O verão chegou e os designers estão animados com os lançamentos da Apple e as novas tendências de design. Um dos destaques é o efeito de vidro. Confira algumas das novas ferramentas para designers que refletem essa tendência, além de novos kits de design e ferramentas de IA. Veja o que há de novo para […]

    Confira as novas ferramentas de design de 2025, incluindo ícones, jogos, animações e IA para aprimorar seus projetos.

    Ler notícia completa
    Imagem de ícones variados em estilo 3D representando objetos como lâmpada, trator, bota e pessoas, incluindo um músico e figuras históricas.
  • Melhores Modelos de Currículo Word para 2025

    Muitos designers preferem usar Figma, Photoshop ou InDesign para criar currículos devido ao maior controle sobre layout e tipografia. No entanto, o Word é prático, fácil de abrir e compartilhar, não necessitando de software especial para visualização. Os arquivos em Word são práticos e a maioria dos empregadores espera recebê-los. Quando bem utilizados, parecem profissionais, […]

    Descubra os melhores modelos de currículo em Word para 2025. Designs minimalistas, modernos e coloridos para destacar sua carreira.

    Ler notícia completa
  • Sua Equipe Está Pronta para o Design com IA?

    O design com IA não é mais novidade — está se tornando parte fundamental do trabalho dos designers modernos. Neste artigo, exploramos como as ferramentas atuais oferecem valor real, como se integram aos fluxos de trabalho existentes e o que é necessário para construir uma prática de design aprimorada por IA. A integração da IA […]

    Descubra como integrar ferramentas de design com IA nos fluxos de trabalho e maximize o potencial em equipes de design.

    Ler notícia completa
    Ilustração de três pessoas utilizando laptops em espaços de trabalho diferentes, cercados por gráficos e elementos de design. Texto sobre ferramentas de IA e integração inteligente.
  • Como a IA Agente transforma a experiência do cliente

    A corrida para redefinir a experiência do cliente (CX) está acelerando. Com expectativas crescentes, as empresas precisam oferecer interações mais rápidas e personalizadas. Segundo a Salesforce, 80% dos clientes consideram a experiência tão importante quanto os produtos, e 73% exigem melhor personalização. O Índice de Experiência do Cliente 2024 da Forrester revelou que apenas 3% […]

    IA Agente melhora o atendimento ao cliente com personalização e rapidez, transformando a experiência e aumentando a satisfação.

    Ler notícia completa
    Imagem de fundo escuro com faixas azuis brilhantes e inúmeros pontos brancos, representando uma visualização de dados ou uma abstração de velocidade e tecnologia.