Início·Comandos de terminal

docker run

Pacotes e runtimes

Uso

docker run [-d] [-p <host>:<container>] <image> [command]

Cria e inicia um contêiner novo a partir da imagem toda vez, então rodar duas vezes deixa dois contêineres e reiniciar um existente é docker start; sem -p nada é alcançável do host, e sem -v o que for escrito morre com o contêiner.

Opções comuns

OpçãoSignificado
-drun in the background and print the id
-p 8080:80publish a container port on the host
-itinteractive with a terminal, for a shell
--rmdelete the container when it exits
-v <host>:<path>mount a host folder or named volume
-e KEY=valueset an environment variable
--name <name>give it a name instead of a random one
--network <net>attach it to a network

Exemplos

docker run --rm -it ubuntu bash

a throwaway shell in a container

docker run -d -p 8080:80 --name web nginx

nginx in the background, reachable on localhost:8080

docker run --rm -v "$PWD":/app -w /app node:22 npm test

runs your tests in a container without installing node

A pergunta é sempre o que vai onde: dentro deste projeto ou na máquina toda.

Como ler

  • Os colchetes [ ] marcam uma parte que você pode omitir.
  • As reticências … indicam que você pode listar vários.
  • As opções diferenciam maiúsculas: em alguns comandos -r e -R fazem coisas diferentes.

Perguntas

Q. O que docker run faz?

Cria e inicia um contêiner novo a partir da imagem toda vez, então rodar duas vezes deixa dois contêineres e reiniciar um existente é docker start; sem -p nada é alcançável do host, e sem -v o que for escrito morre com o contêiner.

Q. Como se digita?

docker run [-d] [-p <host>:<container>] <image> [command] — os colchetes marcam o que você pode omitir.

Q. Quantas opções vale a pena saber?

Aqui estão 8; a lista completa está em man docker. Este comando fica em Pacotes e runtimes.

Comandos relacionados

página man: man docker-run