Guia 02 / 3
Comandos Docker e Docker Compose
Encontrar o comando adequado a uma situação e interpretar as suas opções.
Construir, executar, diagnosticar e parar serviços sem perder dados.
01 · Verificar e observar
Um comando atua sobre o cliente Docker; o daemon efetua depois a operação. Cada exemplo pressupõe o Docker instalado e acessível a partir do terminal.
docker version
Apresenta as versões do cliente e do servidor Docker. Permite verificar a comunicação com o Docker Engine.
Exemplo
docker version
docker info
Apresenta a configuração do Engine, os seus recursos e as suas funcionalidades.
Exemplo
docker info
docker ps
Lista os contentores em execução. Com -a, inclui os que estão parados.
Exemplo
docker ps -a
docker inspect
Apresenta os detalhes estruturados de um objeto: endereço IP, montagens, estado, configuração, etc.
Exemplo
docker inspect web
docker logs
Apresenta a saída padrão e os erros de um contentor. -f segue as novas linhas em tempo real.
Exemplo
docker logs -f web
docker stats
Apresenta a utilização de CPU e de memória dos contentores em tempo real.
Exemplo
docker stats
docker exec
Executa um comando num contentor já iniciado. A opção -it abre uma sessão interativa se a ferramenta estiver presente.
Exemplo
docker exec -it web sh
02 · Manipular as imagens
Uma imagem é um modelo: descarrega-se, constrói-se, dá-se-lhe nome e lança-se depois um contentor a partir dela.
docker pull
Descarrega uma imagem de um registo sem iniciar um contentor.
Exemplo
docker pull nginx:alpine
docker image ls
Apresenta as imagens presentes localmente e as suas tags.
Exemplo
docker image ls
docker build
Constrói uma imagem a partir de um Dockerfile. -t define o seu nome/tag; o ponto indica o contexto atual.
Exemplo
docker build -t monsite:1.0 .
docker image rm
Elimina uma imagem local não utilizada, sem eliminar nada de um registo remoto.
Exemplo
docker image rm monsite:1.0
Pode falhar se a imagem for utilizada por um contentor.
docker tag
Acrescenta uma nova referência (nome/tag) a uma imagem existente.
Exemplo
docker tag monsite:1.0 monsite:stable
docker push
Envia uma imagem para um registo para a tornar acessível noutro local; exige os direitos adequados.
Exemplo
docker push registry.example.com/monapp:1.0
03 · Ciclo de vida dos contentores
O ciclo corrente segue: criar → iniciar → observar → parar → recriar se necessário.
docker run
Cria e inicia um contentor a partir de uma imagem. -d lança em segundo plano; -p publica uma porta; --name dá nome ao contentor.
Exemplo
docker run -d --name web -p 8080:80 nginx:alpine
docker create
Cria um contentor sem o iniciar.
Exemplo
docker create --name test nginx:alpine
docker start
Inicia um contentor existente parado, sem criar um novo.
Exemplo
docker start web
docker stop
Pede a paragem limpa de um contentor e força depois a paragem após o prazo, se necessário.
Exemplo
docker stop web
docker restart
Reinicia um contentor existente.
Exemplo
docker restart web
docker rm
Elimina um contentor parado. Os volumes com nome não são normalmente eliminados com ele.
Exemplo
docker rm web
Verificar os dados antes de eliminar.
docker cp
Copia ficheiros entre o anfitrião e um contentor.
Exemplo
docker cp web:/usr/share/nginx/html/index.html ./index.html
04 · Armazenamento e redes
Os volumes sobrevivem à recriação de um serviço; as redes permitem a comunicação por nomes de serviço.
docker volume ls
Lista os volumes existentes.
Exemplo
docker volume ls
docker volume create
Cria um volume com nome.
Exemplo
docker volume create donnees
docker volume inspect
Apresenta nomeadamente o ponto de montagem e o controlador de um volume.
Exemplo
docker volume inspect donnees
docker network ls
Lista as redes Docker.
Exemplo
docker network ls
docker network create
Cria uma rede utilizável para ligar contentores.
Exemplo
docker network create atelier
docker network inspect
Apresenta as características de uma rede e os seus contentores ligados.
Exemplo
docker network inspect atelier
05 · Comandar uma aplicação Compose
Estes comandos devem ser lançados na pasta que contém compose.yaml, ou com -f para indicar o ficheiro.
docker compose version
Apresenta a versão do plugin Docker Compose.
Exemplo
docker compose version
docker compose config
Verifica, funde e apresenta a configuração Compose resolvida. A utilizar antes de arrancar.
Exemplo
docker compose config
docker compose up
Cria e inicia os serviços. -d separa o terminal; --build pede para reconstruir as imagens em causa.
Exemplo
docker compose up -d --build
docker compose ps
Lista os contentores do projeto Compose atual e o seu estado.
Exemplo
docker compose ps
docker compose logs
Apresenta os registos dos serviços. -f segue a saída; um nome de serviço visa um serviço específico.
Exemplo
docker compose logs -f web
docker compose exec
Lança um comando no contentor já ativo de um serviço.
Exemplo
docker compose exec web sh
docker compose run
Cria um contentor pontual para executar um comando de um serviço.
Exemplo
docker compose run --rm web npm test
docker compose build
Constrói ou reconstrói as imagens dos serviços que possuem build.
Exemplo
docker compose build web
docker compose pull
Descarrega as imagens referenciadas na configuração.
Exemplo
docker compose pull
docker compose stop
Pára os serviços sem eliminar os contentores do projeto.
Exemplo
docker compose stop
docker compose start
Reinicia contentores existentes anteriormente parados.
Exemplo
docker compose start
docker compose down
Pára e elimina os contentores e as redes criados para o projeto; os volumes com nome não são eliminados por omissão.
Exemplo
docker compose down
Com -v, elimina também volumes: risco de perda de dados.
06 · Opções e operações de risco
Identificar sempre o alcance de um comando antes de o executar.
-d / -it / --rm
-d separa o terminal; -it permite a interação; --rm elimina um contentor pontual quando pára.
Exemplo
docker run --rm -it alpine sh
-p / -v / --name
-p publica uma porta; -v monta um volume ou pasta; --name atribui um nome.
Exemplo
docker run --name demo -p 8080:80 nginx:alpine
--env / --env-file
Transmite variáveis de ambiente ao contentor; os ficheiros podem conter informações sensíveis.
Exemplo
docker run --env NODE_ENV=production monsite:1.0
docker system df
Apresenta o espaço utilizado pelas imagens, contentores e volumes.
Exemplo
docker system df
docker system prune
Elimina certos recursos não utilizados (nomeadamente contentores parados, redes não utilizadas e caches consoante as opções).
Exemplo
docker system prune
Fazer um inventário antes de utilizar; -a alarga a limpeza e --volumes pode eliminar volumes não utilizados.