Tutorial de Docker: aprenda a instalar, executar contêineres e criar imagens

Entenda o que é Docker, por que ele é útil e como funcionam imagens, contêineres e registries. Conheça a arquitetura do Docker e veja como contêineres diferem de máquinas virtuais.

Instale o Docker passo a passo no Windows (WSL 2), macOS e Linux (Ubuntu 26.04 / 24.04), confira a virtualização e a configuração do WSL, valide a instalação com docker version e hello-world e veja mensagens reais de erros comuns e suas soluções.

Conheça cada tela do Docker Desktop: menu lateral, lista de contêineres e ações, Logs/Inspect/Exec/Files/Stats, projetos Compose, Images, busca e download de imagens, barra de status e comandos docker correspondentes para alternar entre a interface gráfica e o terminal.

Execute seu primeiro contêiner Docker com nginx: baixe a imagem com docker run, inicie o contêiner, abra a página no navegador, consulte o contêiner com docker ps, veja logs, acesse com exec e gerencie-o com stop / start / rm. Veja também como fazer o mesmo pela interface gráfica do Docker Desktop.

Entenda como imagens Docker são nomeadas e aprenda a baixar, listar, marcar, remover e inspecionar imagens, comparar tamanhos e entender suas camadas.

Entenda os estados de um contêiner Docker com saídas reais: created, running, paused e exited; por que um contêiner encerra logo após iniciar; diferenças entre stop e kill; por que docker stop espera 10 segundos; códigos de saída e comportamento das políticas --restart.

Conheça os parâmetros mais usados do docker run: -d, -it, -p, -v, -e, --name, --rm, --network, --restart, --memory, --cpus, --user, --entrypoint e --read-only, com comandos e resultados reais.

Como investigar problemas em contêineres? Aprenda com saídas reais a consultar logs com docker logs (incluindo a diferença entre stdout e stderr), acessar contêineres com docker exec, verificar configurações com docker inspect, copiar arquivos com docker cp, conferir o estado com docker stats / top / diff e diagnosticar problemas comuns, como contêineres que encerram logo após iniciar, portas ocupadas e exec format error.

Aprenda a escrever um Dockerfile com um exemplo em Node.js. Entenda o que FROM, WORKDIR, COPY, RUN e CMD fazem, como funciona o cache de build (CACHED) e como o .dockerignore reduz o conteúdo do build de 30 MB para menos de 1 KB.

Use docker init para responder a algumas perguntas e gerar Dockerfile, compose.yaml, .dockerignore e README.Docker.md. Veja o processo completo em um projeto Node.js, analise os arquivos gerados linha por linha, encontre dois avisos no modelo com docker build --check e descubra por que o exemplo PostgreSQL do modelo falha com postgres:18.

Entenda as instruções mais usadas do Dockerfile e seus resultados: FROM, RUN, COPY, ADD, WORKDIR, ENV, ARG, EXPOSE, USER, VOLUME, HEALTHCHECK, CMD e ENTRYPOINT. Compare CMD e ENTRYPOINT, COPY e ADD, ARG e ENV, além da relação entre PID 1 e os 10 segundos de espera do docker stop.

Entenda o funcionamento e as regras de invalidação do cache de build com saídas reais do docker build. Veja como a ordem das instruções afeta o tempo, como reduzir imagens e usar cache de montagem.

Separe o ambiente de compilação do ambiente de execução com builds em múltiplos estágios. Compare tamanhos de imagens Go e veja exemplos com Node.js, Java e a opção --target.

Aprenda a usar docker login, docker tag e docker push para publicar imagens no Docker Hub e no GitHub Container Registry, além de configurar um Registry privado.

Os dados desaparecem quando você remove um contêiner? Aprenda na prática a usar Docker Volume e Bind Mount: preserve os dados ao remover o contêiner, entenda de onde vêm os Volumes anônimos, compare -v e --mount com caminhos inexistentes, faça backup e restaure Volumes e conheça o novo diretório de dados da imagem PostgreSQL 18 (o formato antigo impede a inicialização).

Entenda as redes Docker com exemplos reais: limites da bridge padrão, DNS integrado nas redes personalizadas, conexão entre app e banco de dados, aliases, várias redes, serviços que escutam apenas em 127.0.0.1 e como acessar o host com host.docker.internal.

Aprenda com exemplos reais a usar -e, --env-file, ENV no Dockerfile e environment, env_file e substituição de variáveis com .env no Docker Compose; veja como aspas e secrets funcionam.

Introdução ao Docker Compose: inicie site, PostgreSQL e Adminer com um compose.yaml, com saídas reais de docker compose up, ps, logs, stop e down, além de capturas de tela do login no Adminer (lembre-se de selecionar PostgreSQL), da execução de SQL e do impacto de down e down -v nos dados.

Guia completo da sintaxe do arquivo compose.yaml do Docker Compose: services, image, build, ports, volumes, environment, env_file e mais.

Comandos do Docker Compose com exemplos reais: up, down, ps, ls, images, top, logs, exec, run, pull, config e port. Veja por que restart não aplica alterações no compose.yaml e quando usar up -d para recriar serviços.

Configure WordPress 7 com MySQL 8.4 usando Docker Compose, com saídas reais e capturas de tela: health check, persistência, limite de upload, phpMyAdmin, backup, restauração e atualização de imagens.

Empacote sites Python em imagens Docker com exemplos reais de build e execução: Flask com gunicorn, recarga automática no desenvolvimento, FastAPI com uvicorn, collectstatic e erros de STATIC_ROOT no Django, build com uv e uv.lock e comparação do tamanho das imagens.

Como escrever e testar Dockerfiles para projetos Node.js: npm ci, dependências de produção, usuário node, PID 1 e SIGTERM, build em vários estágios para TypeScript, Next.js standalone e recarga automática no desenvolvimento.

Use Nginx com Docker para servir um site estático, personalizar configurações (SPA, cache, gzip), validar a sintaxe com nginx -t, gerar configurações com modelos e variáveis de ambiente e encaminhar solicitações a contêineres de back-end. Inclui testes práticos de proxy_pass, montagem de arquivo único, erro 502 e HTTPS automático com Caddy.

Inicie o MySQL 8.4 com Docker e veja saídas reais: variáveis de ambiente, SQL de inicialização, utf8mb4 em chinês, conexões e backups.

Inicie o PostgreSQL 18 com Docker e veja a saída real: novo diretório de dados da versão 18, configuração do Compose, armadilha do health check pg_isready, comandos psql, login sem senha no contêiner, backup e restauração com pg_dump e atualização da versão 16 para a 18.

Execute o Redis 8 com Docker e veja a saída real: comandos básicos do redis-cli, senha e erro NOAUTH, diferenças entre docker stop e docker rm -f com RDB, persistência AOF, política maxmemory, contador Flask com Compose e por que adicionar grep PONG à verificação de integridade.

O Docker está ocupando espaço demais? Descubra o que está consumindo espaço com docker system df e faça a limpeza com container, image, volume, builder e system prune. Testado no Docker 29: system prune --volumes não exclui mais volumes nomeados, novas builds não deixam imagens <none>, logs de contêiner chegam a 69 MB em 3 segundos e há configuração de limite para logs.

Introdução à segurança de contêineres Docker com testes práticos: execução sem root, versão fixa da imagem, segredos em camadas de imagem, BuildKit secret, banco de dados não exposto, limites e varredura de vulnerabilidades com Trivy.

Entenda por que Docker equivale a privilégios de root, veja como o modo Rootless mapeia o root do contêiner para um usuário comum do host e conheça o Podman, sem daemon permanente, compatível com Dockerfile e rootless por padrão.

A imagem criada no Apple Silicon falha com exec format error no servidor? Entenda arquiteturas de CPU e imagens multiplataforma; crie linux/amd64 e linux/arm64 com docker buildx e compilação cruzada em Go, inspecione com docker images --tree, publique no Registry e verifique o manifest, além de saber quando usar QEMU.

Faça build e envie imagens Docker multiplataforma ao GitHub Container Registry e implante no servidor por SSH automaticamente. Inclui workflow completo e cache.

Implante um app Docker em um servidor Linux na nuvem: build e envio de imagem, execução com Compose, Caddy com HTTPS, atualização, rollback, backup e checklist.

O que é um contêiner? Observe diretamente em um host Docker: um processo Linux isolado por namespaces, limitado por cgroups e com um sistema de arquivos overlayfs. Veja PIDs, lsns, limites de memória e CPU, upperdir, capabilities e seccomp.

Encontre respostas para erros comuns do Docker, como Cannot connect to the Docker daemon, permission denied docker.sock, port is already allocated e outros 25 erros, com saída real do Docker 29, causas e soluções.

Os comandos Docker mais usados em uma página: contêineres, imagens, build, Volume, rede, Docker Compose, limpeza e informações do sistema.

Guia completo dos parâmetros de docker build, com exemplos práticos no Docker 29 para nomear imagens, passar argumentos, escolher Dockerfile e controlar o build.

Guia completo dos parâmetros do docker exec (-it, -u, -w, -e, -d, --env-file, --privileged), com exemplos práticos no Docker 29: acessar o shell, definir usuário e diretório, passar variáveis, executar em segundo plano e entender erros quando o contêiner está parado.

Aprenda a listar, filtrar e formatar contêineres com docker ps. Veja exemplos de IDs, status, nomes, rótulos, tamanhos e remoção em lote.

Guia completo dos parâmetros de docker logs (-f, --tail, -t, --since, --until e --details), com exemplos práticos no Docker 29 para filtrar, pesquisar e acompanhar logs.

Veja como usar docker cp para copiar arquivos e pastas entre o host e o contêiner, entender regras de caminhos e erros, e fazer backup e restauração de bancos de dados no Windows. Exemplos com Docker 29.

Aprenda os parâmetros de docker inspect e modelos -f/--format, com exemplos no Docker 29 para consultar estado, IP, variáveis, política de reinício, configurações de imagem, volumes e redes.

Guia completo dos subcomandos create, ls, inspect, rm e prune de docker volume, com exemplos reais no Docker 29: crie um volume e grave dados, encontre volumes anônimos órfãos, adicione labels e filtre por elas, e entenda a diferença entre prune e prune -a.

Guia completo dos subcomandos create, ls, inspect, connect, disconnect, rm e prune do docker network, com exemplos práticos no Docker 29: resolução de nomes em redes personalizadas, aliases --network-alias, sub-redes específicas, um contêiner em várias redes e o erro ao remover uma rede em uso.

Guia completo das opções de docker compose up (-d, --build, --wait, --force-recreate, --no-deps, --scale, --remove-orphans, --abort-on-container-exit, --exit-code-from, --pull, -V, --watch e outras), com exemplos práticos no Docker Compose v5.

Entenda as opções do docker compose down (-v/--volumes, --rmi local|all, --remove-orphans, -t/--timeout), veja exemplos práticos no Docker Compose v5 e saiba o que down preserva ou remove em comparação com stop e rm.