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

Se está a querer começar com o Docker, compreender como trabalhar com a sua interface de linha de comando é crucial para gerir os seus contentores e imagens de forma eficaz.

Docker tornou-se a solução de referência para a conteinerização de aplicações, e este guia leva-o através dos comandos essenciais que precisa de conhecer para controlar o seu ambiente Docker.

Começar com Comandos Docker

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

Os primeiros comandos com os quais deve familiarizar-se 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 a sua versão do Docker, basta executar:

docker --version

Quando precisar de ajuda com qualquer comando Docker, o sistema de ajuda incorporado torna-se o seu primeiro ponto de referência, onde pode aceder a informações gerais de ajuda executando o seguinte comando:

docker --help

Também pode obter ajuda específica para qualquer comando em particular que queira compreender melhor, o que irá mostrar todas as opções e flags disponíveis para esse comando específico.

docker run --help

Trabalhar com Imagens Docker

As imagens Docker formam a base dos seus contêineres, pois contêm tudo o que é necessário para executar uma aplicação, incluindo o código, o ambiente de execução, bibliotecas e dependências.

Os seguintes comandos explicam como trabalhar eficazmente com imagens Docker.

A pesquisar imagens do Docker

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

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

sudo docker search nginx

Transferir Imagens Docker

Uma vez que tenha encontrado a imagem de que precisa, pode transferi-la para o seu sistema local usando o comando pull, que irá obter a versão mais recente:

sudo docker pull nginx

Se precisar de uma versão específica, pode especificar a etiqueta:

sudo docker pull nginx:1.25.3

Listar Imagens Docker Locais

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

sudo docker images

Criar Imagens Docker Personalizadas

Quando precisa de criar a sua própria imagem personalizada a partir de um Dockerfile, primeiro precisa de criar o próprio Dockerfile na sua diretoria 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. Depois de ter um Dockerfile preparado, pode então construir a sua imagem personalizada usando o comando build:

sudo docker build -t myapp:1.0 .

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

Remover Imagens Docker

Quando precisar de remover uma imagem que já não necessita do seu sistema, pode usar o seguinte comando:

sudo docker rmi nginx:latest

No entanto, se a imagem estiver atualmente a ser utilizada por um contentor em execução ou parado, o Docker impedirá a sua remoção. Nesses casos, será necessário remover primeiro o contentor antes de apagar a imagem ou, alternativamente, pode forçar a remoção adicionando o parâmetro -f ao comando.

docker rm container_name
docker rmi -f nginx:latest

Gestão de Contêineres Docker

A próxima secção orienta-o sobre a gestão de contentores, que são as instâncias em execução das suas imagens Docker. Compreender como gerir e controlar estes contentores é essencial para trabalhar com o Docker de forma eficaz nas suas operações diárias.

A executar Contentores Docker

A forma mais básica de executar um contentor a partir de uma imagem é utilizando o seguinte comando.

sudo docker run nginx

No entanto, o comando acima executa o contêiner em primeiro plano, o que prende o seu terminal. Para utilização prática em cenários reais, vai querer executar os seus contêineres em modo destacado:

sudo docker run -d nginx

Também pode mapear portas e atribuir nomes aos seus contêineres para uma gestão e identificação mais fáceis:

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 no seu computador para a porta 80 dentro do contêiner usando a flag -p, e atribui-lhe o nome "my-webserver" com a flag --name.

Listar Contentores Docker

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

sudo docker ps

No entanto, se quiser ver todos os contentores no seu sistema, incluindo os que estão parados, pode adicionar o parâmetro -a ao comando:

sudo docker ps -a

Iniciar e Parar Contentores Docker

Antes de poder stop, start ou restart um contentor, primeiro precisa de saber que contentores existem no seu sistema.

sudo docker ps -a

Uma vez que conheça os nomes dos containers, pode então parar um container que está atualmente a ser executado usando o comando stop:

sudo docker stop my-webserver

Para iniciar um contentor que foi previamente parado, pode usar o comando start:

sudo docker start my-webserver

Se precisar de reiniciar um contentor, o que o pára e depois o inicia novamente, pode usar o comando restart:

sudo docker restart my-webserver

Remover Contentores Docker

Quando já não precisar de um contentor, pode removê-lo do seu sistema para libertar espaço utilizando o comando rm:

sudo docker rm happy_satoshi

No entanto, se tentares remover um contentor que está atualmente em execução, o Docker irá impedir a remoção e mostrar um erro. Nesses casos, tens duas opções – podes parar primeiro o contentor e depois removê-lo, ou podes forçar a remoção usando a opção -f:

sudo docker rm -f happy_satoshi

A flag de força permite remover um contêiner em execução sem o parar primeiro, embora deva usar esta opção com cuidado, pois encerra imediatamente o contêiner sem um encerramento adequado.

Monitorização e Depuração de Contêineres Docker

Compreender o que está a acontecer dentro dos seus containers é crucial para resolver problemas e manter aplicações saudáveis. As secções seguintes levam-no através dos comandos essenciais para monitorizar e depurar os seus containers Docker.

A visualizar registos do contentor

Para verificar os registos gerados por um contentor, pode utilizar o comando logs:

sudo docker logs awesome_heyrovsky

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

sudo docker logs -f awesome_heyrovsky

Executar 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 lhe permite aceder ao shell do container e explorar o seu ambiente:

sudo docker exec -it awesome_heyrovsky /bin/bash

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

A Inspeção dos Detalhes do Contentor

Quando precisa de informações detalhadas sobre a configuração, definições de rede e estado de um contentor, pode utilizar o comando inspect:

sudo docker inspect awesome_heyrovsky

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

Monitorizar o Uso de Recursos

Para ver o uso de recursos em tempo real de todos os contêineres em execução no seu sistema, pode usar o comando stats, que mostra uma transmissão ao vivo do uso da CPU, consumo de memória, E/S de rede e uso de disco de cada contêiner em execução:

sudo docker stats

Limpeza e Manutenção do Docker

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

Para remover todos os contentores parados do seu sistema com um só comando, pode usar:

sudo docker container prune

Se quiser remover imagens não utilizadas que já não estão a ser referenciadas por nenhum contêiner, use:

sudo docker image prune

Para uma limpeza mais abrangente que trate múltiplos tipos de recursos não utilizados de uma só vez, pode utilizar o comando do sistema prune:

sudo docker system prune

Folha de Dicas de Comandos Docker

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

Conclusão

Este guia guiou-o pelos comandos essenciais do Docker que precisa de conhecer para gerir eficazmente os contêineres e as imagens no seu ambiente.

Você aprendeu como pesquisar e obter imagens do Docker Hub, executar e gerir contêineres com várias opções, monitorizar o seu desempenho e registos, e manter o seu ambiente Docker limpo através de manutenção regular.

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 partilhar a sua experiência nos comentários abaixo, os seus conhecimentos podem ajudar outros leitores na sua jornada com o Docker!