Notice: This page requires JavaScript to function properly.
Please enable JavaScript in your browser settings or update your browser.
Aprenda Executando Sua Imagem Personalizada | Trabalhando com Imagens Docker
Docker Essentials

bookExecutando Sua Imagem Personalizada

Executando um Contêiner a partir da Sua Imagem Personalizada

Para executar um contêiner a partir de sua própria imagem personalizada, utilize o comando docker run. É necessário especificar o nome da imagem e, opcionalmente, fornecer um nome para o contêiner em execução.

Se você criou uma imagem chamada myapp:latest, inicie um contêiner com:

docker run myapp:latest

Adicionando a opção --name, é possível atribuir um nome identificável ao contêiner, facilitando sua administração:

docker run --name my-running-app myapp:latest

Também é possível executar o contêiner em segundo plano (modo destacado) adicionando a opção -d:

docker run -d --name my-running-app myapp:latest

Principais opções do docker run:

  • Utilizar --name para definir um nome personalizado para o contêiner;
  • Utilizar -d para executar o contêiner em modo destacado;
  • Especificar a imagem e a tag como image:tag (por exemplo, myapp:latest).

Executar seus contêineres com nomes claros e no modo apropriado facilita o gerenciamento e o monitoramento.

Expondo Portas e Montando Volumes ao Executar Contêineres

Ao executar contêineres, frequentemente é necessário expor portas e montar volumes para interagir com sua aplicação e persistir dados.

Exposição de portas é realizada com a opção -p, que faz o mapeamento de uma porta do host para uma porta dentro do contêiner:

  • Utilizar -p <host_port>:<container_port> para mapear portas;
  • Acessar aplicações em execução dentro do contêiner a partir do host;
  • Executar múltiplos contêineres em diferentes portas do host.

Por exemplo, para acessar uma aplicação web rodando na porta 80 do contêiner a partir da porta 8080 do host:

docker run -p 8080:80 myapp:latest

Montagem de volume permite compartilhar arquivos entre o host e o contêiner. Utilize a opção -v para especificar os diretórios de origem e destino:

  • Utilizar -v /host/path:/container/path para montar diretórios;
  • Persistir dados gerados pelo contêiner;
  • Compartilhar arquivos de configuração ou código entre host e contêiner.

Exemplo de comando:

docker run -v /host/path:/container/path myapp:latest

Combinando opções: É possível executar um contêiner nomeado, expondo portas e montando um volume:

docker run -d --name my-running-app -p 8080:80 -v /host/data:/app/data myapp:latest

Essa abordagem permite gerenciar como sua aplicação se comunica e onde armazena dados, proporcionando flexibilidade em implantações reais.

Solução de Problemas Comuns ao Iniciar Contêineres Personalizados

Se o seu contêiner personalizado não iniciar ou apresentar comportamento inesperado, utilize os seguintes passos para diagnosticar e resolver problemas:

  • Verifique os logs do contêiner com o comando:
  docker logs <container-name>
  • Confirme se a imagem foi criada com sucesso e se o CMD ou ENTRYPOINT no seu Dockerfile está correto;
  • Verifique se as portas necessárias não estão em uso no host;
  • Ao montar volumes, certifique-se de que o diretório de origem existe e possui as permissões corretas;
  • Execute o contêiner de forma interativa para depuração, adicionando a opção -it e sobrescrevendo o comando:
  docker run -it myapp:latest /bin/sh

Isso permite inspecionar o ambiente do contêiner e solucionar problemas diretamente.

question mark

Qual é a finalidade do parâmetro --name no comando docker run?

Select the correct answer

Tudo estava claro?

Como podemos melhorá-lo?

Obrigado pelo seu feedback!

Seção 2. Capítulo 4

Pergunte à IA

expand

Pergunte à IA

ChatGPT

Pergunte o que quiser ou experimente uma das perguntas sugeridas para iniciar nosso bate-papo

Awesome!

Completion rate improved to 7.14

bookExecutando Sua Imagem Personalizada

Deslize para mostrar o menu

Executando um Contêiner a partir da Sua Imagem Personalizada

Para executar um contêiner a partir de sua própria imagem personalizada, utilize o comando docker run. É necessário especificar o nome da imagem e, opcionalmente, fornecer um nome para o contêiner em execução.

Se você criou uma imagem chamada myapp:latest, inicie um contêiner com:

docker run myapp:latest

Adicionando a opção --name, é possível atribuir um nome identificável ao contêiner, facilitando sua administração:

docker run --name my-running-app myapp:latest

Também é possível executar o contêiner em segundo plano (modo destacado) adicionando a opção -d:

docker run -d --name my-running-app myapp:latest

Principais opções do docker run:

  • Utilizar --name para definir um nome personalizado para o contêiner;
  • Utilizar -d para executar o contêiner em modo destacado;
  • Especificar a imagem e a tag como image:tag (por exemplo, myapp:latest).

Executar seus contêineres com nomes claros e no modo apropriado facilita o gerenciamento e o monitoramento.

Expondo Portas e Montando Volumes ao Executar Contêineres

Ao executar contêineres, frequentemente é necessário expor portas e montar volumes para interagir com sua aplicação e persistir dados.

Exposição de portas é realizada com a opção -p, que faz o mapeamento de uma porta do host para uma porta dentro do contêiner:

  • Utilizar -p <host_port>:<container_port> para mapear portas;
  • Acessar aplicações em execução dentro do contêiner a partir do host;
  • Executar múltiplos contêineres em diferentes portas do host.

Por exemplo, para acessar uma aplicação web rodando na porta 80 do contêiner a partir da porta 8080 do host:

docker run -p 8080:80 myapp:latest

Montagem de volume permite compartilhar arquivos entre o host e o contêiner. Utilize a opção -v para especificar os diretórios de origem e destino:

  • Utilizar -v /host/path:/container/path para montar diretórios;
  • Persistir dados gerados pelo contêiner;
  • Compartilhar arquivos de configuração ou código entre host e contêiner.

Exemplo de comando:

docker run -v /host/path:/container/path myapp:latest

Combinando opções: É possível executar um contêiner nomeado, expondo portas e montando um volume:

docker run -d --name my-running-app -p 8080:80 -v /host/data:/app/data myapp:latest

Essa abordagem permite gerenciar como sua aplicação se comunica e onde armazena dados, proporcionando flexibilidade em implantações reais.

Solução de Problemas Comuns ao Iniciar Contêineres Personalizados

Se o seu contêiner personalizado não iniciar ou apresentar comportamento inesperado, utilize os seguintes passos para diagnosticar e resolver problemas:

  • Verifique os logs do contêiner com o comando:
  docker logs <container-name>
  • Confirme se a imagem foi criada com sucesso e se o CMD ou ENTRYPOINT no seu Dockerfile está correto;
  • Verifique se as portas necessárias não estão em uso no host;
  • Ao montar volumes, certifique-se de que o diretório de origem existe e possui as permissões corretas;
  • Execute o contêiner de forma interativa para depuração, adicionando a opção -it e sobrescrevendo o comando:
  docker run -it myapp:latest /bin/sh

Isso permite inspecionar o ambiente do contêiner e solucionar problemas diretamente.

question mark

Qual é a finalidade do parâmetro --name no comando docker run?

Select the correct answer

Tudo estava claro?

Como podemos melhorá-lo?

Obrigado pelo seu feedback!

Seção 2. Capítulo 4
some-alt