docker container run

O comando docker container run é uma das operações mais fundamentais do Docker. Ele é usado para criar e iniciar um novo container a partir de uma imagem especificada. Esse comando combina a criação (docker create) e a execução (docker start) de um container em um único passo, tornando-o muito útil para iniciar containers rapidamente.

Sintaxe

docker container run [OPTIONS] IMAGE [COMMAND] [ARG...]

• IMAGE: O nome da imagem Docker que você deseja usar para criar o container.

• COMMAND: (Opcional) O comando que você deseja executar dentro do container.

• ARG...: (Opcional) Argumentos adicionais para o comando executado no container.

Opções Comuns

• --name: Especifica um nome para o container. Se não for especificado, o Docker atribui um nome aleatório.

• -d, --detach: Executa o container em segundo plano (modo "detached").

• -i, --interactive: Mantém o STDIN aberto mesmo que o container não esteja anexado.

• -t, --tty: Aloca um pseudo-terminal TTY, que é útil para sessões interativas.

• -p, --publish: Mapeia portas da máquina host para o container no formato host_port:container_port.

• --rm: Remove automaticamente o container quando ele for parado.

• -v, --volume: Monta volumes para compartilhar dados entre o host e o container no formato host_dir:container_dir.

• -e, --env: Define variáveis de ambiente para o container.

• --network: Conecta o container a uma rede específica.

• --link: Conecta o container a outro container, permitindo comunicação direta.

• --restart: Define a política de reinício do container (ex: no, on-failure, always).

Exemplos

1. Executar um Container e Exibir a Saída:

   docker container run ubuntu echo "Hello, Docker!"

   Esse comando cria um container a partir da imagem ubuntu, executa o comando echo "Hello, Docker!", exibe a saída e, em seguida, remove o container.

2. Executar um Container em Segundo Plano (Detached Mode):

   docker container run -d nginx

   Isso executa um container usando a imagem nginx em segundo plano. O container continuará em execução até ser parado manualmente.

3. Executar um Container com uma Porta Publicada:

   docker container run -d -p 8080:80 nginx

   Este comando executa um container nginx em segundo plano, mapeando a porta 80 do container para a porta 8080 da máquina host.

4. Executar um Container Interativamente com um Terminal:

   docker container run -it ubuntu /bin/bash

   Isso cria um container ubuntu e fornece acesso interativo ao terminal Bash dentro do container.

5. Montar um Volume no Container:

   docker container run -v /host/data:/container/data ubuntu

   Esse comando monta o diretório /host/data do host no diretório /container/data dentro do container, permitindo compartilhar arquivos entre o host e o container.

6. Remover Automaticamente o Container Após a Execução:

   docker container run --rm ubuntu echo "This will be removed"

   O container será removido automaticamente após o comando echo ser executado.

7. Definir Variáveis de Ambiente no Container:

   docker container run -e MY_VAR=my_value ubuntu env

   Este comando define a variável de ambiente MY_VAR dentro do container e executa o comando env para exibir todas as variáveis de ambiente.

Considerações

• Persistência de dados: Se o container for removido após a execução, os dados não serão preservados a menos que sejam armazenados em volumes ou montagens de host.

• Networking: Ao usar --network, você pode conectar o container a redes Docker personalizadas, facilitando a comunicação entre múltiplos containers.

Exemplo de Documentação

## Executando Containers com `docker container run`

O comando `docker container run` é a maneira mais comum de criar e iniciar containers a partir de imagens Docker. Ele combina a criação e execução do container em uma única operação.

### Exemplo Básico: Executar um Container e Exibir a Saída

Para criar um container a partir da imagem `ubuntu` e executar o comando `echo`:

```bash
docker container run ubuntu echo "Hello, Docker!"

Executar em Segundo Plano (Detached Mode)

Para rodar um container em segundo plano usando a imagem nginx:

docker container run -d nginx

Publicar Portas entre o Host e o Container

Para mapear a porta 80 do container para a porta 8080 do host:

docker container run -d -p 8080:80 nginx

Sessão Interativa com Terminal

Para acessar interativamente um container ubuntu usando o terminal Bash:

docker container run -it ubuntu /bin/bash

Montagem de Volumes para Compartilhamento de Dados

Para montar um diretório do host no container:

docker container run -v /host/data:/container/data ubuntu

Remoção Automática Após a Execução

Para remover automaticamente o container após sua execução:

docker container run --rm ubuntu echo "This will be removed"

Definindo Variáveis de Ambiente

Para definir uma variável de ambiente e visualizar todas as variáveis dentro do container:

docker container run -e MY_VAR=my_value ubuntu env

Considerações Finais

O docker container run é um comando poderoso e versátil, essencial para iniciar containers com configurações personalizadas e controle total sobre sua execução e ambiente.

Essa estrutura pode ser usada para documentar o comando `docker container run` na sua documentação Docker.