O Docker Compose é uma ferramenta para executar aplicações multi-containers, conforme a documentação do site oficial do Docker (https://docs.docker.com/compose/overview/).

Imagine que você tem 4 Dockerfiles, um para cada aplicação que irá usar um container diferente. Você teria que “rodar” os 4 Dockerfiles para subir essas aplicações. Com o Docker Compose você define tudo isso em um único arquivo, o docker-compose.yml, ou seja, você cria e inicia todos os seus serviços com a configuração que você definiu para cada serviço com um único comando.

Para fazer a instalação do Docker Compose é necessário fazer o download no Github oficial do docker compose: https://github.com/docker/compose/releases . No momento dessa postagem, a versão mais atual é a v1.13.0

O comando para instalar/atualizar para essa versão é:

# curl -L https://github.com/docker/compose/releases/download/1.13.0/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose

# chmod +x /usr/local/bin/docker-compose

Depois de instalado, como exemplo, vamos fazer um docker-compose.yml que irá subir 2 containers: Um container com o MySQL 5.7 e o outro container com o WordPress mais atual disponível no Docker Hub. Vamos criar um arquivo .env com as variáveis utilizadas nas configurações desses dois serviços. Lembre-se de criar um diretório para esse dois arquivos.

Nome do arquivo: docker-compose.yml

version: ‘3’

services:
db:
image: mysql:5.7
volumes:
– db_data:/var/lib/mysql
restart: always
env_file:
– .env
wordpress:
    depends_on:
– db
image: wordpress:latest
ports:
– “8000:80”
restart: always
env_file:
– .env
volumes:
db_data:

Agora vamos criar o arquivo com as variáveis de ambiente dentro do arquivo .env

Nome do arquivo: .env

#Variáveis MYSQL
MYSQL_ROOT_PASSWORD=wordpress
MYSQL_DATABASE=wordpress
MYSQL_USER=wordpress
MYSQL_PASSWORD=wordpress

#Variáveis WORDPRESS
WORDPRESS_DB_HOST=db:3306
WORDPRESS_DB_PASSWORD=wordpress

Com os dois arquivos prontos, vamos executar o docker compose:

# docker-compose up -d

Esse comando executará o arquivo docker-compose, baixar as imagens base, subir dois containers, um com o wordpress e outro com mysql.

A imagem abaixo é um resumo do que foi feito até agora com o Docker Compose e verificando se as imagens e containers estão funcionando.

Agora vamos detalhar o que foi usado no Docker Compose acima.

• VERSION: é onde definimos qual a versão do Docker Compose File que estamos usando. A versão mais atual é a versão 3;
• SERVICES: é o nome do serviços que vamos criar. Serve para diferenciar quais containers estarão no docker-compose.yml;
• IMAGE: Determina imagem será usada como base para a criação do container. Semelhante ao FROM do Dockerfile;
• VOLUME: Faz a montagem dos volumes no container;
• RESTART: Determina quando o container será reiniciado. No nosso caso, será sempre reiniciado independente do status da saída do container. Para ler sobre as outras opções, clique aqui para ler ir ao Docker Docs.
• ENV_FILE: Informa que há um arquivo com as variáveis de ambiente que serão usadas nos serviços executados nos containers;
• DEPENDS_ON: Informa a ordem de dependência dos containers. Por exemplo, o container do wordpress só será iniciado após a criação do container do banco de dados;
• PORTS: Expõe as portas do host e do container, em ordem;

Outras opções para utilização no docker-compose.yml:

• BUILD: São opções para aplicar no momento da compilação do compose. Também é possível definir um diretório e compilar os arquivos dentro desse diretório, incluindo Dockerfiles;
• COMMAND: Semelhante ao CMD do Dockerfile, executa um comando dentro do container;
• CONTAINER_NAME: Informa o nome do container;
• DNS: Informa o endereço do servidor DNS;
• DNS_SEARCH: Informa o Search Domain;
• DOCKERFILE: Deve ser usado no BUILD para informar a utilização de um Dockerfile;
• ENTRYPOINT: Informa qual o processo principal do container;
• ENVIRONMENT: Adiciona variáveis de ambiente. Semelhante ao ENV_FILE, mas sem criar o arquivo .env;
• EXPOSE: Expõe a porta do container;
• EXTERNAL_LINKS: Cria links com containers criados fora do arquivo do Docker Compose;
• EXTRA_HOSTS: Adiciona o mapeamento de hostnames dentro do arquivo /etc/hosts do container;
• HEALTHCHECK: Define como será testado o estado do container. É preciso determinar o teste que será realizado, o período, o timeout da resposta do teste e o número de tentativas;
• LABELS: Adiciona informações de metadados no container;
• LINKS: Cria links com containers que estão dentro do Docker Compose;
• LOGGING: Configura os logs para um serviço de logs;
• NETWORK_MODE: Define qual o modo de rede o container irá usar;
• SYSCTLS: Configura informações relacionadas no Kernel para o container;

Para uma relação completa de todos os argumentos e como utilizá-los, basta ir à página oficial da documentação do docker.

Espero que tenham gostado das postagens e em breve postarei mais informações sobre Docker.

Ao som de: Primus – Wynona’s Big Brown Beaver

Até agora explicamos como o Docker funciona, como instalar, criar um container e administrá-lo. Agora veremos como colocar todas as informações de uma imagem em um único arquivo chamado Dockerfile.

Vamos fazer uma imagem para subir um container com o Debian 8.7 e instalar o NGINX.
Primeiramente devemos criar, no host Docker, um diretório onde ficará esse Dockerfile.

cd ~

mkdir Docker && cd Docker && mkdir Nginx && cd Nginx

Após isso, vamos criar um arquivo chamado Dockerfile. Atentar para a grafia com a primeira letra maiúscula. Dentro desse arquivo, vamos colocar as seguintes informações:

FROM debian:8.7

MAINTAINER contato@161.35.238.43

RUN apt-get update && apt-get install -y nginx

EXPOSE 80

Ao colocar essa informação, salve e feche o arquivo. Feito isso, vamos agora executar o Dockerfile com o seguinte comando:

# docker build .

O Docker Build não trabalha com o caminho do arquivo, apenas com o seu diretório, então é necessário informar o caminho do diretório ou, no nosso caso, como estamos no diretório onde se localiza o Dockerfile, apenas um ponto para identificar que o Dockerfile está no diretório atual.

Caso todas as informações estejam corretas, sua imagem será criada e podemos atestar isso com o “docker images”.

A imagem está criada, mas sem o REPOSITORY e a TAG, pois não repassamos essa informação. Caso queira preencher os campos, basta usar o parâmetro “-t”.

# docker build -t brunoizidorio/nginx:1.0

Utilizamos a nomenclatura repositório/nome e tag. Agora vamos detalhar o nosso primeiro Dockerfile:

• O Dockerfile funciona no formato: INSTRUÇÃO argumento.
• O campo FROM é o nome da imagem que utilizamos, nesse caso o Debian 8.7.
• MAINTAINER é a informação de quem criou o Dockerfile.
• RUN são os comandos que queremos executar na imagem que escolhemos. Aqui informamos a instalação do Nginx. Lembre-se de sempre colocar o parâmetro para aceitar automaticamente a instalação, caso contrário o Dockerfile apresentará erro, pois estará esperando uma interação.
• Como o Nginx funciona na porta 80, vamos expor essa porta do container usando o EXPOSE.

O primeiro argumento do Dockerfile deve ser sempre o FROM, seguido da imagem e versão que será utilizada. Caso não seja informada a versão, o Docker vai procurar a mais atual do seu repositório oficial. Abaixo, outros argumento utilizados no Dockerfile:

• MAINTAINER: quem escreve o dockerfile;
  Ex: MAINTAINER contato@161.35.238.43
  
• RUN: executa os comandos dentro do container;
  Ex: apt-get update && apt-get install -y nginx
• ADD: adiciona arquivos, diretórios do host ou de uma url para dentro de um diretório do container, mas não funciona com arquivos compactados;
  Ex: ADD arquivo.txt /home/bruno/
• CMD: informa os parâmetros que serão usados no ENTRYPOINT. Também pode ser utilizado para informar qual comando será executado após a criação do container, mas pode ser sobrescrito caso seja passada algum parâmetro de execução de algum comando na hora de executar o container;
  Ex: CMD [“nginx”, “-g”, “daemon off;”]
• LABEL: coloca um metadado para o container;
  Ex: LABEL description=”Container do Nginx”
• COPY: copia arquivos e diretórios do host para dentro de um diretório do container. Funciona com com arquivos compactados;
  Ex: COPY arquivo.txt /home/bruno/
• ENTRYPOINT: informa qual será a aplicação principal do container, sendo executada após a inicialização do container. Diferente do CMD, não será sobrescrita. Caso a seja finalizada a execução do programa definido no ENTRYPOINT, o container será encerrado;
  Ex: ENTRYPOINT [“nginx”, “-D”, “FOREGROUND”]
• ENV: cria uma variável de ambiente;
  Ex: meunome=”Bruno Izidório”
• EXPOSE: expõe a porta informada do container;
  Ex: EXPOSE 80
• USER: define qual será o usuário padrão para o container. Caso não seja definido, o padrão é o usuário root;
  Ex: USER bruno
• WORKDIR: determina qual diretório será o padrão ao fazer o login;
  Ex: WORKDIR /home/bruno/downloads
• VOLUME: permite a criação de um diretório no host onde fica armazenado os dados do container;
  Ex: VOLUME /home/docker/nginx:/usr/share/nginx/html

Ao som de The Neal Morse Band – So Far Gone