Docker e Docker Compose — O curso

Guia 02 / 3

Comandos Docker e Docker Compose

Encontrar o comando adequado a uma situação e interpretar as suas opções.

Resultado esperado :

Construir, executar, diagnosticar e parar serviços sem perder dados.

Leitura
0%

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.

docker version

docker info

Apresenta a configuração do Engine, os seus recursos e as suas funcionalidades.

docker info

docker ps

Lista os contentores em execução. Com -a, inclui os que estão parados.

docker ps -a

docker inspect

Apresenta os detalhes estruturados de um objeto: endereço IP, montagens, estado, configuração, etc.

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.

docker logs -f web

docker stats

Apresenta a utilização de CPU e de memória dos contentores em tempo real.

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.

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.

docker pull nginx:alpine

docker image ls

Apresenta as imagens presentes localmente e as suas tags.

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.

docker build -t monsite:1.0 .

docker image rm

Elimina uma imagem local não utilizada, sem eliminar nada de um registo remoto.

docker image rm monsite:1.0
A reter :

Pode falhar se a imagem for utilizada por um contentor.

docker tag

Acrescenta uma nova referência (nome/tag) a uma imagem existente.

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.

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.

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

docker create

Cria um contentor sem o iniciar.

docker create --name test nginx:alpine

docker start

Inicia um contentor existente parado, sem criar um novo.

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.

docker stop web

docker restart

Reinicia um contentor existente.

docker restart web

docker rm

Elimina um contentor parado. Os volumes com nome não são normalmente eliminados com ele.

docker rm web
A reter :

Verificar os dados antes de eliminar.

docker cp

Copia ficheiros entre o anfitrião e um contentor.

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.

docker volume ls

docker volume create

Cria um volume com nome.

docker volume create donnees

docker volume inspect

Apresenta nomeadamente o ponto de montagem e o controlador de um volume.

docker volume inspect donnees

docker network ls

Lista as redes Docker.

docker network ls

docker network create

Cria uma rede utilizável para ligar contentores.

docker network create atelier

docker network inspect

Apresenta as características de uma rede e os seus contentores ligados.

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.

docker compose version

docker compose config

Verifica, funde e apresenta a configuração Compose resolvida. A utilizar antes de arrancar.

docker compose config

docker compose up

Cria e inicia os serviços. -d separa o terminal; --build pede para reconstruir as imagens em causa.

docker compose up -d --build

docker compose ps

Lista os contentores do projeto Compose atual e o seu estado.

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.

docker compose logs -f web

docker compose exec

Lança um comando no contentor já ativo de um serviço.

docker compose exec web sh

docker compose run

Cria um contentor pontual para executar um comando de um serviço.

docker compose run --rm web npm test

docker compose build

Constrói ou reconstrói as imagens dos serviços que possuem build.

docker compose build web

docker compose pull

Descarrega as imagens referenciadas na configuração.

docker compose pull

docker compose stop

Pára os serviços sem eliminar os contentores do projeto.

docker compose stop

docker compose start

Reinicia contentores existentes anteriormente parados.

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.

docker compose down
A reter :

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.

docker run --rm -it alpine sh

-p / -v / --name

-p publica uma porta; -v monta um volume ou pasta; --name atribui um nome.

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.

docker run --env NODE_ENV=production monsite:1.0

docker system df

Apresenta o espaço utilizado pelas imagens, contentores e volumes.

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

docker system prune
A reter :

Fazer um inventário antes de utilizar; -a alarga a limpeza e --volumes pode eliminar volumes não utilizados.