País ou região e idioma

    Escolha seu país ou região e seu idioma.

    Sugerido para você

      Todos os países e regiões

        Escolha seu personagem

        Ele aparece na barra superior e no seu perfil. Você pode mudar quando quiser.

        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.

        Uma pessoa pratica em um notebook em um espaço de trabalho tranquilo

        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.

        Pratique o que este artigo ensina

        Your Work Gym account

        Save your progress and pick up on another device. Your browser's progress comes with you.

        or

        You can keep practicing without an account.

        Ajuda e feedback

        Faça uma pergunta, conte o que não está funcionando ou compartilhe uma ideia. Respondemos por e-mail.

        Qual é o assunto?

        Usamos apenas para responder a você.