Skip to main content

Docker Compose

Docker Compose é uma ferramenta escrita em Python para definir e rodar aplicações multi-contêineres Docker. Através do Docker Compose, você define a configuração dos serviços da sua aplicação. Em um arquivo yml, é descrita a configuração de cada um dos serviços, bem como o relacionamento entre eles. Através de um comando, você pode criar, atualizar ou remover todos os serviços.

Arquivo YML

Para este exemplo, criaremos uma aplicação blog composta de 2 serviços:

  • Servidor web: ghost (Ghost)
  • Banco de dados: postgres (PostgreSQL)

Crie um diretório chamado blog para armazenar a configuração:

# acessando o home do usuário
$ cd ~

# criando o diretório
$ mkdir blog

# entrando no diretório
$ cd blog

Crie um arquivo chamado docker-compose.yml com o seguinte conteúdo:

version: '2'
services:
  ghost:
    image: ghost:ghost:5.87.0
    ports:
      - 2368:2368
    restart: always
    environment:
      database__client: mysql
      database__connection__host: "ghost-db"
      database__connection__user: "ghostuser"
      database__connection__password: "pass"
      database__connection__database: "ghostdb"
    links:
      - ghost-db:ghost-db
    depends_on:
      - ghost-db
    volumes:
      - ~/blog/ghost:/var/lib/ghost/content
  ghost-db:
    image: mariadb:10.3
    ports:
      - 3306:3306
    restart: always
    environment:
      MYSQL_DATABASE: "ghostdb"
      MYSQL_PASSWORD: "pass"
      MYSQL_RANDOM_ROOT_PASSWORD: 'true'
      MYSQL_USER: "ghostuser"
    volumes:
      - ~/blog/ghost-db:/var/lib/mysql

Detalhando o arquivo docker-compose.yml

  • version: versão do docker-compose
  • services: descrição dos serviços
    • ghost
    • ghost-db
  • image: imagem utilizada pelo serviço
  • ports: porta em que o serviço executará (lado esquerdo: host, lado direito: contêiner)
  • restart: configuração de reinicialização do serviço
  • environment: variáveis de ambiente dentro do contêiner
  • links: link um contêiner em um outro serviço através do apelido fornecido
  • volumes: o mapeamento da pasta no host e a respectiva pasta dentro do contêiner (lado esquerdo: host, lado direito: contêiner)

Comandos básicos

Para os exemplos abaixo, os comandos foram executados no diretório em que se encontra o arquivo docker-compose.yml:

Criando a aplicação

Criar a aplicação descrita no arquivo docker-compose.yml, a tela exibirá o log:

docker-compose up

Note que o terminal ficará travado neste execução. Os logs dos serviços da stack será exibidos no terminal. Para finalizar, utilize o atalho CONTROL + C. A execução da stack será finalizada.

Vamos criar a aplicação novamente, desta vez com a sua execução em background (-d Detached mode).

docker-compose up -d

Visualizar os logs:

$ docker-compose logs

Visualizar os logs e travar e tela na exibição neles:

$ docker-compose logs -f

Para visualizar a stack:

$ docker-compose ps

Se tudo ocorreu como esperado, você visualizará algo como:

NAME COMMAND STATE PORTS
blog_ghost-db_1 docker-entrypoint.sh mysqld Up 0.0.0.0:3306->3306/tcp
blog_ghost_1 docker-entrypoint.sh node,... Up 0.0.0.0:2368->2368/tcp
  • O servidor web pode ser acessado no navegador no seguinte endereço: http://localhost:2368
  • O servidor de banco de dados está acessível na porta 3306
Removendo a aplicação

Remover os contêiners da aplicação:

$ docker-compose down

Referências

https://docs.docker.com/compose/