Cheat Sheet Docker — Comandos e Compose

docker pull node:22-alpine

Baixe uma imagem de um registro.

docker image ls

Liste as imagens locais com seus tamanhos.

docker build -t myapp:1.0 .

Crie uma imagem a partir do Dockerfile da pasta atual.

docker build -t myapp:1.0 -f Dockerfile.prod .

Faça o build com outro Dockerfile.

docker build --no-cache -t myapp:1.0 .

Refaça todas as camadas do zero.

docker buildx build --platform linux/amd64,linux/arm64 -t ghcr.io/acme/myapp:1.0 --push .

Faça o build para Intel e ARM (ex.: Apple Silicon, Graviton) e envie as duas versões.

docker tag myapp:1.0 ghcr.io/acme/myapp:1.0

Dê um nome de registro à imagem antes de enviar.

docker push ghcr.io/acme/myapp:1.0

Envie uma imagem para um registro.

docker history myapp:1.0

Mostre as camadas de uma imagem e o tamanho de cada uma.

docker run -d --name web -p 8080:3000 myapp:1.0

Execute em segundo plano e publique a porta {{cport}} do container na porta {{hport}} do host.

docker run --rm -it node:22-alpine sh

Abra um shell interativo descartável; o container é removido ao sair.

docker run -d --restart unless-stopped --name web myapp:1.0

Reinicie automaticamente após falhas e reinicializações.

docker run --env-file .env -e NODE_ENV=production myapp:1.0

Passe variáveis de ambiente de um arquivo e pela linha de comando.

docker run -v app-data:/data myapp:1.0

Monte um volume nomeado para que os dados sobrevivam à remoção do container.

docker run --rm -v "$(pwd)":/app -w /app node:22-alpine npm test

Monte a pasta atual e execute um comando dentro dela.

docker run --memory 512m --cpus 1.5 myapp:1.0

Limite memória e CPU.

docker run -d --network app-net --name web myapp:1.0

Conecte-se a uma rede definida pelo usuário para que os containers se encontrem pelo nome.

docker ps -a

Liste todos os containers, inclusive os parados.

docker logs -f --tail 100 web

Acompanhe as últimas 100 linhas de log.

docker exec -it web sh

Abra um shell em um container em execução (use bash se a imagem tiver).

docker stop web

Pare com segurança (SIGTERM e, após 10 s, SIGKILL).

docker restart web

Reinicie um container.

docker cp web:/app/logs ./logs

Copie arquivos para fora de um container (inverta os argumentos para copiar para dentro).

docker stats

Uso ao vivo de CPU, memória, rede e disco dos containers em execução.

docker inspect -f '{{.State.Health.Status}}' web

Leia um campo dos detalhes do container — aqui, o status do health check.

docker port web

Mostre quais portas do host estão mapeadas para o container.

docker compose up -d

Inicie todos os serviços em segundo plano.

docker compose up -d --build

Refaça as imagens e depois inicie.

docker compose ps

Liste os serviços e seus estados.

docker compose logs -f api

Acompanhe os logs de um serviço.

docker compose exec api sh

Abra um shell em um serviço em execução.

docker compose run --rm api npm run migrate

Execute um comando único em um novo container de um serviço.

docker compose restart api

Reinicie um serviço.

docker compose pull

Baixe as imagens mais recentes de todos os serviços.

docker compose config

Valide o arquivo e mostre a configuração final combinada.

docker compose -f compose.yml -f compose.prod.yml up -d

Sobreponha um arquivo de override sobre o arquivo base.

docker compose down

Pare e remova containers e redes (os volumes são mantidos).

docker volume ls

Liste os volumes.

docker volume inspect app-data

Mostre onde um volume fica no host.

docker run --rm -v app-data:/data -v "$(pwd)":/backup alpine tar czf /backup/app-data.tar.gz -C /data .

Faça backup de um volume em um .tar.gz na pasta atual.

docker network create app-net

Crie uma rede para containers que precisam se comunicar.

docker network connect app-net web

Conecte um container em execução a uma rede.

docker system df

Mostre quanto espaço ocupam imagens, containers, volumes e cache de build.

docker builder prune

Remova o cache de build não utilizado.

docker run --rm -it --entrypoint sh myapp:1.0

Inicie uma imagem com um shell em vez do comando normal — útil para imagens que falham ao iniciar.

docker logs web 2>&1 | grep -i error

Pesquise nos logs de um container (stdout e stderr).

docker exec web env

Mostre as variáveis de ambiente que o container realmente enxerga.

docker compose exec api wget -qO- localhost:3000/health

Chame um endpoint de health check de dentro do serviço.

docker events --since 10m

Acompanhe os eventos recentes do Docker: inícios, paradas, encerramentos por OOM e mudanças de saúde.