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

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.
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.
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.
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.
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.
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.
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.

Previousnginx Nextdocker container run nginx

Last updated 9 months ago