Comandos da CLI do Docker Que Todo Desenvolvedor Deve Conhecer em 2025

Se você está procurando começar com Docker, entender como trabalhar com sua interface de linha de comando é crucial para gerenciar seus contêineres e imagens de forma eficaz.

Docker se tornou a solução preferida para conteinerizar aplicações, e este guia leva você pelos comandos essenciais que você precisa conhecer para controlar seu ambiente Docker.

Começando com Comandos do Docker

Antes de mergulhar em comandos específicos, é importante entender que os comandos do Docker seguem uma estrutura simples e a maioria dos comandos começa com docker, seguido pela ação que você deseja executar e quaisquer opções ou argumentos adicionais.

Os primeiros comandos com os quais você deve se familiarizar são os comandos de ajuda e de versão, que são úteis para qualquer utilitário de linha de comando, e o Docker não é exceção.

Para verificar sua versão do Docker, basta executar:

docker --version

Quando você precisa de ajuda com qualquer comando do Docker, o sistema de ajuda integrado se torna seu primeiro ponto de referência, onde você pode acessar informações gerais de ajuda executando o seguinte comando:

docker --help

Você também pode obter ajuda específica para qualquer comando que queira entender melhor, o que exibirá todas as opções e bandeiras disponíveis para esse comando específico.

docker run --help

Trabalhando com Imagens Docker

Imagens Docker formam a base dos seus contêineres, pois contêm tudo o que é necessário para executar um aplicativo, incluindo o código, runtime, bibliotecas e dependências.

Os seguintes comandos mostram como trabalhar com imagens do Docker de forma eficiente.

Procurando por Imagens Docker

Antes de você poder usar uma imagem, primeiro precisa encontrá-la no Docker Hub, que serve como o registro padrão onde milhares de imagens pré-construídas estão disponíveis para você usar.

Para procurar uma imagem específica, você pode executar o seguinte comando, que exibirá uma lista de imagens nginx disponíveis junto com suas descrições e classificações por estrelas, ajudando você a identificar as opções mais populares e bem mantidas.

sudo docker search nginx

Baixando imagens do Docker

Uma vez que você encontrar a imagem que precisa, pode baixá-la para o seu sistema local usando o comando pull, que irá puxar a versão mais recente:

sudo docker pull nginx

Se você precisar de uma versão específica, pode especificar a tag:

sudo docker pull nginx:1.25.3

Listando Imagens Docker Locais

Para ver todas as imagens que você armazenou localmente, use o seguinte comando, que exibirá uma tabela mostrando o nome do repositório, a tag, o ID da imagem, a data de criação e o tamanho de cada imagem no seu sistema.

sudo docker images

Criando Imagens Docker Personalizadas

Quando você precisa criar sua própria imagem personalizada a partir de um Dockerfile, primeiro você precisa criar o próprio Dockerfile no seu diretório atual com o seguinte conteúdo:

FROM ubuntu:24.04
RUN apt update && apt install -y nginx
EXPOSE 80
CMD ["nginx", "-g", "daemon off;"]

O Dockerfile acima cria uma imagem de servidor web simples baseada no Ubuntu 24.04 que instala e executa o Nginx. Uma vez que você tenha um Dockerfile pronto, você pode então criar sua imagem personalizada usando o comando build:

sudo docker build -t myapp:1.0 .

A flag -t permite que você marque sua imagem com um nome e versão para fácil identificação. Neste exemplo, myapp é o nome da imagem e 1.0 é a tag de versão. O . (ponto) no final indica que o contexto de build é o seu diretório atual, onde o Docker irá procurar pelo Dockerfile que você acabou de criar.

Removendo Imagens Docker

Quando você precisar remover uma imagem que não precisa mais do seu sistema, você pode usar o seguinte comando:

sudo docker rmi nginx:latest

No entanto, se a imagem estiver sendo usada atualmente por um contêiner em execução ou parado, o Docker impedirá que você a remova. Nesses casos, você precisará remover o contêiner primeiro antes de deletar a imagem ou, alternativamente, pode forçar a remoção adicionando a flag -f ao comando.

docker rm container_name
docker rmi -f nginx:latest

Gerenciando Contêineres Docker

A próxima seção guia você pelo gerenciamento de containers, que são as instâncias em execução das suas imagens Docker. Entender como gerenciar e controlar esses containers é essencial para trabalhar com Docker de forma eficaz em suas operações do dia a dia.

Executando Contêineres Docker

A maneira mais básica de executar um contêiner a partir de uma imagem é usando o seguinte comando.

sudo docker run nginx

No entanto, o comando acima executa o contêiner em primeiro plano, o que ocupa o seu terminal. Para uso prático em cenários do mundo real, você vai querer executar seus contêineres no modo destacado:

sudo docker run -d nginx

Você também pode mapear portas e atribuir nomes aos seus contêineres para facilitar a gestão e a identificação:

sudo docker run -d -p 8080:80 --name my-webserver nginx

O comando acima executa um contêiner nginx em segundo plano usando a flag -d, mapeia a porta 8080 da sua máquina host para a porta 80 dentro do contêiner usando a flag -p e atribui a ele o nome "my-webserver" com a flag --name.

Listando Containers Docker

Para ver todos os containers que estão atualmente em execução no seu sistema, você pode usar o seguinte comando:

sudo docker ps

No entanto, se você quiser ver todos os contêineres no seu sistema, incluindo os que estão parados, você pode adicionar a flag -a ao comando:

sudo docker ps -a

Iniciando e Parando Contêineres Docker

Antes de você poder parar, iniciar ou reiniciar um contêiner, você primeiro precisa saber quais contêineres existem no seu sistema.

sudo docker ps -a

Uma vez que você saiba os nomes dos containers, você pode então parar um container que está em execução usando o comando stop:

sudo docker stop my-webserver

Para iniciar um contêiner que foi parado anteriormente, você pode usar o comando start:

sudo docker start my-webserver

Se você precisar reiniciar um contêiner, o que o interrompe e depois o inicia novamente, você pode usar o comando restart:

sudo docker restart my-webserver

Removendo Contêineres Docker

Quando você não precisar mais de um contêiner, pode removê-lo do seu sistema para liberar espaço usando o comando rm:

sudo docker rm happy_satoshi

No entanto, se você tentar remover um contêiner que está em execução, o Docker impedirá a remoção e exibirá um erro. Nesses casos, você tem duas opções – pode parar o contêiner primeiro e depois removê-lo, ou pode forçar a remoção usando a flag -f:

sudo docker rm -f happy_satoshi

A flag de força permite que você remova um contêiner em execução sem interrompê-lo primeiro, embora deva usar esta opção com cuidado, pois ela encerra o contêiner imediatamente sem um desligamento gracioso.

Monitoramento e Depuração de Containers Docker

Entender o que está acontecendo dentro dos seus containers é crucial para resolver problemas e manter as aplicações saudáveis. As seções a seguir apresentam os comandos essenciais para monitorar e depurar seus containers Docker.

Visualizando Logs do Contêiner

Para verificar os logs gerados por um contêiner, você pode usar o comando logs:

sudo docker logs awesome_heyrovsky

Se você quiser acompanhar os logs em tempo real à medida que são gerados, de forma semelhante a usar tail -f em um arquivo de log, você pode adicionar a flag -f:

sudo docker logs -f awesome_heyrovsky

Executando Comandos Dentro de Contêineres

Uma das funcionalidades mais poderosas que o Docker oferece é a capacidade de executar comandos dentro de containers em execução, o que permite acessar o shell do container e explorar seu ambiente:

sudo docker exec -it awesome_heyrovsky /bin/bash

O comando acima abre um shell interativo dentro do contêiner usando as flags -it (terminal interativo), o que permite executar comandos, verificar arquivos e depurar problemas diretamente no ambiente do contêiner.

Inspecionando Detalhes do Contêiner

Quando você precisa de informações detalhadas sobre a configuração de um contêiner, configurações de rede e estado, você pode usar o comando inspect:

sudo docker inspect awesome_heyrovsky

O comando acima retorna dados abrangentes em formato JSON sobre o contêiner, incluindo sua configuração, configurações de rede, volumes montados e variáveis de ambiente.

Monitoramento do Uso de Recursos

Para visualizar o uso de recursos em tempo real de todos os contêineres em execução no seu sistema, você pode usar o comando stats, que exibirá uma transmissão ao vivo do uso da CPU, consumo de memória, I/O de rede e uso de disco para cada contêiner em execução:

sudo docker stats

Limpeza e Manutenção do Docker

Com o tempo, o Docker acumula imagens, containers, redes e outros recursos não utilizados no seu sistema, então a limpeza regular se torna importante para liberar espaço em disco e manter seu ambiente Docker organizado.

Para remover todos os contêineres parados do seu sistema em um único comando, você pode usar:

sudo docker container prune

Se você quiser remover imagens não utilizadas que não estão mais sendo referenciadas por nenhum contêiner, use:

sudo docker image prune

Para uma limpeza mais abrangente que lida com vários tipos de recursos não utilizados ao mesmo tempo, você pode usar o comando do sistema prune:

sudo docker system prune

Resumo de Comandos do Docker

Aqui está uma tabela de referência prática com os comandos Docker mais usados para acesso rápido:

Conclusão

Este guia apresentou a você os comandos essenciais do Docker que você precisa conhecer para gerenciar contêineres e imagens de forma eficaz em seu ambiente.

Você aprendeu como buscar e obter imagens do Docker Hub, executar e gerenciar contêineres com várias opções, monitorar seu desempenho e logs, e manter seu ambiente Docker limpo por meio de manutenção regular.

Você encontrou algum comando do Docker particularmente útil? Ou tem dicas e truques que tornam o trabalho com Docker mais fácil? Sinta-se à vontade para compartilhar sua experiência nos comentários abaixo, seus insights podem ajudar outros leitores na jornada com Docker!