Neste post vamos aprender a colocar nossas aplicações Phoenix em contêineres e a gerenciar vários deles utilizando Docker Compose.

Para começar, vamos criar uma aplicação sem banco de dados para entender bem como funciona, e depois sim, vamos criar uma aplicação com banco de dados e usando docker-compose.

• ⚙️ Criando o Projeto sem Ecto
  • 🐳 Criando a Imagem Docker sem Ecto
• ⚙️ Criando o Projeto com Ecto
  • 🐳 Criando a Imagem Docker com Ecto
  • 🐳 Criando o arquivo docker-compose
  • 📜 Criando o arquivo SH
  • 🗃 Configurando o banco de dados no docker-compose

⚙️ Criando o Projeto sem Ecto (sem Banco de Dados)

• Versões usadas neste projeto:
  • elixir 1.13.3-otp-24
  • erlang 24.1.5

Crie uma aplicação Phoenix com o comando:

$ mix phx.new dockerizando_sem_ecto --app blog --no-ecto

link do projeto no github: https://github.com/maiquitome/dockerizando_sem_ecto

🐳 Criando a Imagem Docker sem Ecto

Vamos configurar o contêiner da nossa aplicação Phoenix, criando um arquivo com o nome Dockerfile na raiz do projeto com o seguinte conteúdo:

# imagem base
# Alpine é uma imagem mínima do Docker baseada no Alpine Linux com um índice de pacotes completo e apenas 5 MB de tamanho!
FROM elixir:1.13.3-alpine

# instalando o gerenciar de pacotes do elixir
RUN mix local.hex --force && \
    mix local.rebar --force

# também funciona essa sintaxe:
# RUN mix do local.hex --force, local.rebar --force

# copiar tudo da raiz do projeto para o contêiner docker
COPY . .

# instalar as dependencias
RUN mix do deps.get, deps.compile

# executar o servidor
CMD ["mix", "phx.server"]

.dockerignore

Agora podemos criar um arquivo também na raiz do projeto chamado .dockerignore para colocarmos os arquivos que devem ser ignorados pelo Docker, ou seja, não vão ir para dentro do contêiner.

Vamos colocar alguns arquivos que podemos querer ignorar, mesmo que alguns deles não estejam no nosso projeto, vamos colocar para exemplo, pois algum dia você pode querer colocar um arquivo semelhante:

_build/
deps/
.elixir_ls/
.git
.github
.gitignore
.editorconfig
.circleci
helm/*
terragrunt.hcl
README.md
docker-compose*

Construindo a Imagem

$ docker build -t app/blog .

Executando o comando docker images no terminal, podemos constatar que a nossa imagem foi criada:

$ docker images         
REPOSITORY   TAG      IMAGE ID       CREATED         SIZE
app/blog     latest   eae5a6582cdd   3 minutes ago   105MB

ou no Docker Desktop:

Criando um Contêiner

$ docker run app/blog

Executando o comando docker container ls ou o comando antigo docker ps no terminal, podemos constatar que o nosso contêiner foi criado:

No Docker Desktop:

Após, podemos constatar que a aplicação está rodando na porta 4000:

Então, vamos tentar acessar a aplicação:

E recebemos a mensagem que este site não pode ser acessado. Isso acontece, pois, a nossa aplicação está na porta 4000 dentro do contêiner. Para acessar precisamos executar o comando abaixo passando uma porta, neste caso a porta 8000:

$ docker run -p 8000:4000 app/blog 

E agora conseguimos acessar a nossa aplicação dentro do contêiner:

Caso você receba a mensagem This page ins't working:

Altere o arquivo config/dev.exs trocando {127, 0, 0, 1} para {0, 0, 0, 0}

Adicionando um diretório de trabalho (WORKDIR)

Se executarmos o comando docker run -it app/blog sh e depois um ls podemos notar que os arquivos do contêiner estão misturados com os arquivos da aplicação:

Vamos adicionar no aquivo Dockerfile o comando WORKDIR:

FROM elixir:1.13.3-alpine

WORKDIR /app

...

Vamos verificar que agora ficou mais organizado:

⚙️ Criando o Projeto com Ecto (com Banco de Dados)

Agora vamos criar uma aplicação Phoenix com banco de dados:

$ mix phx.new dockerizando_com_ecto --app blog

Link do projeto no github: https://github.com/maiquitome/dockerizando_com_ecto

🐳 Criando a Imagem Docker com Ecto

Vamos usar o mesmo Dockerfile do projeto anterior, criar a nossa imagem e subir um contêiner da nossa aplicação:

Após isso, recebemos um erro, informando que a conexão com o banco de dados falhou. Para resolvermos isso vamos aprender a usar o docker-compose.

🐳 Criando o Arquivo docker-compose

O Docker Compose serve para iniciar vários conteiners.

Crie um arquivo na raiz do projeto chamado docker-compose.yml.

version: "3" # versão do docker-compose
services: # serviços que precisamos colocar em conteiner
  # e um desses serviços é a nossa aplicação.
  app: # nome da nossa aplicação, pode ser qualquer nome, nesse caso vamos dar o nome de app
    build: 
      context: . # context é o diretório onde a gente está
    ports: # pra executar o docker run precisamos passar a porta
      - "8080:4000" # o `-` no yml significa que é um array

Este código do arquivo docker-compose.yml irá executar o Dockerfile e, para isso, vamos executar no terminal o comando docker-compose up:

$ docker-compose up

Mesmo com o erro do banco de dados, acesse a porta 8080:

No momento, o docker-compose está servindo apenas para fazer o build da imagem do nosso projeto.

📜 Criando o arquivo SH

Remova o comando CMD ["mix", "phx.server"] do arquivo Dockerfile.

Crie um arquivo na raiz do projeto chamado docker_dev_start.sh.

mix ecto.drop # destrói o banco de dados
mix ecto.setup # cria o banco de dados e executa o arquivo seeds
exec mix phx.server # sobe o servidor

Agora vamos fazer executar este script dentro do docker-compose.yml. Como estamos em uma máquina Alpine, adicione o seguinte comando command: /bin/sh docker_dev_start.sh. Se a máquina fosse um Windows, por exemplo, o comando seria diferente.

version: "3" # versão do docker-compose
services: # serviços que precisamos colocar em conteiner
  # e um desses serviços é a nossa aplicação.
  app: # nome da nossa aplicação, pode ser qualquer nome, nesse caso vamos dar o nome de app
    build: 
      context: . # context é o diretório onde a gente está
    command: /bin/sh docker_dev_start.sh # executa o script do arquivo docker_dev_start.sh
    ports: # pra executar o docker run precisamos passar a porta
      - "8080:4000" # o `-` no yml significa que é um array

Ao executarmos docker-compose up recebemos um erro:

Para funcionar, precisamos construir novamente a imagem e, para isso, pode usar o comando:

$ docker-compose up --build

🗃 Configurando o banco de dados no docker-compose

Mas ainda temos o erro de conexão com o banco de dados, por isso, precisamos incluir o contêiner do postgres e configurar ele:

version: "3"
services:
  app:
    build: 
      context: .
    command: /bin/sh docker_dev_start.sh
    ports:
      - "8080:4000"
  # adicione a configuração abaixo
  db: 
    image: postgres
    environment:
      POSTGRES_PASSWORD: postgres
      POSTGRES_USER: postgres
    ports:
      - "5432:5432"

Altere de localhost para db no arquivo config/dev.exs:

E, como alteramos os arquivos, precisamos fazer o build novamente:

$ docker-compose up --build

Agora funciona, mas ainda temos um problema:

Precisamos fazer com o db execute totalmente primeiro e, pra isso, vamos colocar uns comandos:

version: "3"
services:
  app:
    build: 
      context: . 
    command: /bin/sh docker_dev_start.sh
    ports:
      - "8080:4000"
    # adicione o depends_on e o links
    depends_on:
      - db # nosso app depende do db para funcionar
    links:
      - db
  db: 
    image: postgres
    environment:
      POSTGRES_PASSWORD: postgres
      POSTGRES_USER: postgres
    ports:
      - "5432:5432"

E, como alteramos os arquivos, precisamos fazer o build novamente:

$ docker-compose up --build

E, agora sim, o db executou primeiro:

DICA: Podemos executar também em background usando o comando:

$ docker-compose up -d