Skip to content

Latest commit

 

History

History
261 lines (201 loc) · 7.15 KB

05-docker-compose.md

File metadata and controls

261 lines (201 loc) · 7.15 KB
Raw

Capítulo 05 - Docker Compose

O que é o Compose

Compose é uma ferramenta para definir e executar aplicações multi-containers em Docker. Com m simples comando é possível inicar todos os serviços através de sua configuração.

O Compose funciona em todos os ambientes: produção, homologação, desenvolvimento, teste e fluxos de integração contínua.

Etapas de um Compose

Utilizar o Compose é um processo de três etapas:

  1. Definir seu ambiente com um Dockerfile para que ele possa ser reproduzido em qualquer lugar.
  2. Definir os serviços que serão executados em um arquivo docker-compose.yml
  3. Executar o comando docker-compose up

docker-compose.yml

O arquivo docker-compose.yml define a estrutura e como serão executados os containers.

É importante notar que as versões do arquivo docker-compose podem não ser compatíveis com determinados parâmetros e até mesmo versões diferentes da Docker Engine.

Podemos visualizar as referências do arquivo compose diretamente na documentação oficial do Docker na seção Compose File Reference

O docker-compose.yml é apresentado da seguinte maneira:

version: '3'

volumes:
  logvolume01: {}

networks:
  app-net:

services:
  web:
    build: .
    ports:
      - 5000:5000
    volumes:
      - logvolume01:/var/log
    network:
      - app_net

  redis:
    image: redis
    network:
      - app_net

Obrigatóriamente o docker-compose.yml deve começar indicando qual a versão do compose a ser utilizada, em seguida podemos definir os serviços, volumes e redes não importando a ordem. Cada container a ser executado é uma nova seção do grupo services.

Instalando o Docker Compose

Para instalar o Docker Compose basta executar os comandos da documentação

sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
docker-compose --version

Criando Composes

Crie um diretório para armazenarmos nosso compose

mkdir ~/compose
cd ~/compose

Copie o Dockerfile do nosso webserver para a pasta compose e crie o arquivo docker-compose.yml

cp ~/dockerfiles/webserver/Dockerfile .
vim docker-compose.yml
version: '3'

services:
  webserver:
    build: .
    hostname: webserver
    ports:
      - 80:80
    restart: always

Parâmetros do docker-compose.yml

  • version - define a versão do arquivo compose
  • services - define a seção de serviços
  • build - define o local do Dockerfile
  • hostname - define o hostname do container
  • ports - define quais portas serão publicadas
  • restart - define a politica de restart

Execute a criação do ambiente

docker-compose up -d

O comando docker-compose up com o parâmetro -d inicia o compose de forma detached

IMPORTANTE: por padrão o comando docker-compose procura por um arquivo docker-compose.yml no diretório em que o comando foi executado, é possível informar o arquivo compose a ser utilizado através da opção -f <caminho_do_compose>

Podemos acessar a aplicação no navegador pelo endereço http://node01.docker-dca.example

Para listar os containers criados pelo compose podemos utilizar o parametro ps

docker-compose ps

Caso seja necessário parar o container criado com o compose podemos utilizar o parâmetro stop

docker-compose stop
docker-compose ps

Para iniciar novamente o compose podemos utilizar o parâmetro start

docker-compose start
docker-compose ps

Para destruir o ambiente criado através do docker-compose utilizamos o parâmetro down

docker-compose down
docker-compose ps

Vamos agora criar uma página web para ser exibida em nosso container através do docker-compose, crie a pasta html e o arquivo index.html

mkdir /html
echo "<h1> Curso Docker DCA 100% Gratuito - youtube.com/caiodelgadonew </h1>" > html/index.html

Edite o compose e adicione o mapeamento de volume:

vim docker-compose.yml
version: '3'

services:
  webserver:
    build: .
    hostname: webserver
    ports:
      - 80:80
    restart: always
    volumes:
      - $PWD/html:/var/www/html

O parâmetro $PWD referencia o Parent Working Directory (diretório atual)

Através deste mapeamento de volumes estamos substituindo o conteúdo do caminho /var/www/html por /root/compose/

Execute a criação do ambiente

docker-compose up -d

Acesse a aplicação no navegador pelo endereço http://node01.docker-dca.example

Para destrua o ambiente criado

docker-compose down

Compose Multi-containers

A principal funcionalidade de um compose é subir serviços multi-containers como, por exemplo, um serviço de wordpressm onde será executado um container para a aplicação e um segundo container para o banco de dados. Isto é possível com a definição de múltiplos segmentos dentro de um docker-compose

Crie o arquivo wordpress-compose.yml

vim wordpress-compose.yml
version: '3'

volumes:
  mysql_db:

services:
  wordpress:
    image: wordpress
    restart: always
    ports:
      - 80:80
    environment:
      WORDPRESS_DB_HOST: db
      WORDPRESS_DB_USER: wpuser
      WORDPRESS_DB_PASSWORD: caiodelgadonew@youtube
      WORDPRESS_DB_NAME: wordpress
  db:
    image: mysql:5.7
    restart: always
    volumes:
      - mysql_db:/var/lib/mysql
    environment:
      MYSQL_DATABASE: wordpress
      MYSQL_USER: wpuser
      MYSQL_PASSWORD: caiodelgadonew@youtube
      MYSQL_RANDOM_ROOT_PASSWORD: '1'

Execute a criação do ambiente

docker-compose -f wordpress-compose.yml up -d
docker-compose -f wordpress-compose.yml ps

O parâmetro -f especifica o arquivo .yml a ser utilizado com o compose

Acesse o endereço http://node01.docker-dca.example e configure o wordpress

Titulo do Site: Wordpress - caiodelgadonew
Nome de Usuário: caiodelgadonew
Senha: caiodelgadonew@youtube
email: [email protected]

Vamos alterar o tema do Wordpress, para isto clique em Aparência e em seguida em Temas

Selecione um tema e clique em Ativar

Para visualizar o tema clique em Wordpress - caiodelgadonew

Podemos verificar os logs do compose

docker-compose -f wordpress-compose.yml logs

Para visualizar os logs em tempo real podemos utilizar o parâmetro -f

docker-compose -f wordpress-compose.yml logs -f

Pressione <CTRL> + <C> para sair

Destrua o ambiente

docker-compose -f wordpress-compose.yml down

Note que ao destruir o compose os volumes continuam persistentes no disco, sendo possível recriar a aplicação com o mesmo conteúdo

Tente acessar o website e verifique que o mesmo está indisponível

Execute a criação do ambiente novamente

docker-compose -f wordpress-compose.yml up -d

Acesse o endereço http://node01.docker-dca.example/ e verifique que os dados persistiram na aplicação

Destrua o ambiente e remova o volume criado

docker-compose -f wordpress-compose.yml down
docker volume rm compose_mysql_db