Tutorial de Docker em PDF
Use este tutorial de Docker em PDF para criar um arquivo em volume, recriar contêineres e conferir o que persiste, com comandos e resultados para comparar.

Você pode salvar este tutorial de Docker em PDF pelo recurso de impressão do navegador e executar os comandos no seu terminal. O exercício cria um arquivo em um volume, remove automaticamente o contêiner e recupera o conteúdo em outro contêiner. Você também vai testar a ausência da montagem para distinguir um arquivo inacessível de um arquivo apagado.
Um guia para salvar e executar
Este guia usa um único arquivo fictício para mostrar a diferença entre imagem, contêiner e volume. Em vez de memorizar um catálogo de comandos, você vai observar onde o arquivo é gravado e quais condições permitem encontrá-lo novamente.
O PDF serve como material de consulta, não como ambiente de execução. Você lê as instruções no documento e executa os comandos no Bash, um interpretador de comandos do Linux. Não é necessário baixar um PDF externo: o próprio artigo reúne a sequência e os resultados esperados.
Guardar o documento permite consultar as instruções sem conexão. Entretanto, o primeiro download da imagem usada no exercício exige internet, caso a imagem ainda não esteja disponível no seu computador.
O ambiente do exercício
O exemplo usa Docker Engine com contêineres Linux e comandos executados no Bash do Linux. A instalação fica fora do exercício: você precisa começar com o Docker instalado, em execução e acessível pelo seu usuário.
Três conceitos explicam o comportamento que você vai observar:
- Imagem: o modelo usado para criar um contêiner. Neste exercício, a imagem é do Alpine Linux, uma distribuição Linux.
- Contêiner: uma instância executável de uma imagem, com seu próprio ambiente de processos e arquivos.
- Volume nomeado: armazenamento gerenciado pelo Docker, identificado por um nome e separado do ciclo de vida do contêiner.
A Docker CLI é a interface de linha de comando que envia instruções ao mecanismo do Docker. Antes de começar, confirme a comunicação com esse mecanismo e o uso de contêineres Linux:
docker info --format '{{.OSType}}'
# Resultado esperado:
# linux
Se aparecer um erro de conexão, confirme se o mecanismo do Docker está em execução no ambiente escolhido. Se aparecer um erro de permissão, resolva o acesso do seu usuário conforme a configuração da instalação antes de continuar. Não altere indiscriminadamente as permissões do sistema para contornar a mensagem.
Pratique o que este artigo ensina
Um arquivo entre dois contêineres
O experimento demonstra que um arquivo gravado em um volume nomeado continua disponível depois da remoção do contêiner que o escreveu. O segundo contêiner consegue ler o arquivo porque recebe acesso ao mesmo volume.
Use o nome de volume indicado somente para este exercício e não prossiga se já houver dados seus nesse volume. Execute os comandos na ordem apresentada, comparando cada resultado antes de avançar. Deixe a limpeza da última etapa para quando terminar todas as verificações.
# Exercício fictício para Bash no Linux.
# Objetivo: ler pedido-101 em um novo contêiner após remover o primeiro.
# Estado inicial: Docker acessível e nenhum volume chamado caderno_docker.
# Imagem usada: alpine:3.21.
# Arquivo criado: /dados/pedidos.txt.
# Conteúdo esperado: pedido-101 seguido de uma quebra de linha.
# O volume caderno_docker será usado somente neste exercício.
# 1. Crie o volume.
docker volume create caderno_docker
# Resultado esperado:
# caderno_docker
# 2. Grave o arquivo e confira o conteúdo antes da remoção automática.
docker run --rm -v caderno_docker:/dados alpine:3.21 sh -c 'printf "pedido-101\n" > /dados/pedidos.txt; cat /dados/pedidos.txt'
# Resultado esperado, além de possíveis mensagens de download:
# pedido-101
# 3. Crie outro contêiner e monte o mesmo volume no mesmo caminho.
docker run --rm -v caderno_docker:/dados alpine:3.21 cat /dados/pedidos.txt
# Resultado esperado:
# pedido-101
# 4. Variação: retire apenas o argumento -v caderno_docker:/dados.
# Use a mesma verificação com e sem a montagem para comparar os resultados.
docker run --rm -v caderno_docker:/dados alpine:3.21 sh -c 'if test -f /dados/pedidos.txt; then cat /dados/pedidos.txt; else printf "arquivo ausente\n"; fi'
# Resultado esperado:
# pedido-101
docker run --rm alpine:3.21 sh -c 'if test -f /dados/pedidos.txt; then cat /dados/pedidos.txt; else printf "arquivo ausente\n"; fi'
# Resultado esperado:
# arquivo ausente
# 5. Monte o volume novamente para conferir que o arquivo não foi apagado.
docker run --rm -v caderno_docker:/dados alpine:3.21 cat /dados/pedidos.txt
# Resultado esperado:
# pedido-101
# 6. Após terminar, remova somente o volume deste exercício.
# Esta operação apaga os dados armazenados nesse volume.
docker volume rm caderno_docker
# Resultado esperado:
# caderno_docker
Os mecanismos da gravação
Na segunda etapa, o Docker cria um contêiner a partir da imagem indicada. Se a imagem ainda não estiver disponível localmente, o Docker tenta baixá-la. Por isso, mensagens de download antes do conteúdo do arquivo são esperadas na primeira execução.
A opção de remoção automática descarta o contêiner quando o processo termina. Essa remoção não exclui o volume nomeado criado na primeira etapa. O arquivo continua no volume mesmo depois que o ambiente usado para gravá-lo deixa de existir.
A montagem associa o volume ao diretório interno indicado no comando. O nome à esquerda dos dois-pontos identifica o volume; o caminho à direita indica onde o contêiner acessa esse armazenamento. A montagem não é uma cópia do arquivo: ela disponibiliza o conteúdo do volume naquele caminho.
O interpretador iniciado dentro do contêiner executa a gravação e a leitura. O redirecionamento escreve a saída do comando de texto no arquivo, e o comando de leitura exibe o conteúdo para conferência. As aspas simples fazem o Bash do computador passar essa instrução ao interpretador do contêiner, em vez de realizar o redirecionamento no computador.
A diferença entre ausência e perda
O resultado “arquivo ausente” significa, nesta comparação controlada, que o novo contêiner não recebeu a montagem. O resultado não demonstra exclusão do volume: a etapa seguinte recupera o conteúdo sem gravar o arquivo novamente.
Na variação, você retira somente o argumento de montagem e mantém a imagem, o caminho consultado e a verificação. Essa mudança isolada permite atribuir a diferença de resultado à falta de acesso ao volume, não a uma alteração no conteúdo.
Trocar o nome do volume pode selecionar outro armazenamento ou criar um volume vazio. Nesse caso, o contêiner não está consultando os dados originais. Usar um nome parecido não estabelece relação entre dois volumes.
Trocar apenas o diretório de montagem produz outro tipo de confusão: o arquivo fica acessível no novo caminho, mas a leitura ainda pode apontar para o caminho antigo. Para diagnosticar o problema, compare o destino da montagem com o endereço completo usado na leitura.
A limpeza final é diferente da remoção dos contêineres: ela exclui explicitamente o volume do exercício e seu conteúdo. Volumes permitem persistência entre contêineres, mas não substituem backup. Exclusão acidental e falhas no armazenamento continuam exigindo uma estratégia de recuperação.
O PDF e a próxima prática
Para salvar o tutorial em PDF, abra a impressão do navegador e escolha o destino de salvar em PDF disponível no seu ambiente. Confira a prévia antes de salvar, especialmente as linhas longas do bloco de comandos.
Se houver texto cortado, ajuste a orientação da página ou a escala de impressão. Preserve os comandos como texto selecionável, junto com os comentários e os resultados esperados. Capturas de tela dificultam copiar aspas, conferir caminhos e identificar caracteres ausentes. Mesmo com texto selecionável, copiar do PDF pode inserir quebras de linha que fazem um comando falhar; confira cada comando antes de executá-lo no terminal.
O exercício ensina persistência com volume nomeado, mas não cobre criação de imagens, redes, permissões entre usuários nem implantação em produção. Mesmo quando a leitura funciona, uma aplicação real pode exigir cuidados adicionais com acesso e consistência dos dados.
Para continuar praticando, acesse o curso de Docker e Kubernetes. Na The Work Gym, você pratica no navegador, em cópias funcionais das ferramentas reais, com correção imediata e uma dica que aponta o erro.
Ao revisar o exercício, explique com suas palavras por que o segundo contêiner leu o arquivo e o contêiner sem montagem não conseguiu encontrá-lo. A explicação deve mencionar o mesmo volume, o caminho de acesso e a diferença entre remover o contêiner e excluir o armazenamento.
Perguntas frequentes
Posso acompanhar o tutorial de Docker em PDF sem internet? Você pode consultar o PDF sem internet. Para executar o exercício offline, o Docker precisa estar disponível e a imagem indicada já deve ter sido baixada no ambiente usado.
Preciso instalar o Docker para executar os comandos? Para executar os comandos deste tutorial no seu ambiente, você precisa de uma instalação acessível do Docker com contêineres Linux. O exemplo usa Bash no Linux e não inclui as etapas de instalação.
Por que o arquivo não aparece quando crio outro contêiner? Um novo contêiner não recebe automaticamente acesso ao volume usado pelo anterior. Confira se você montou o mesmo volume e se a leitura aponta para o caminho correto dentro do contêiner.
Remover um contêiner também remove o volume? Neste exercício, a remoção automática dos contêineres preserva o volume nomeado. A última etapa exclui esse volume explicitamente, apagando o conteúdo usado na prática.