Home

Guia de Uso de Docker do ejplatform

Resumo das mudanças

• O diretório compose foi atualizado e substituido para docker;

• Todos os .yml de configuração do docker-compose foram atualizads e movidas para seus respectivos contextos no diretório docker;

• ej-server agora possui a seguinte herança de imagens Docker:

  1. ej-server:base: Possui todas as dependências definidas em requirements/base.txt e todos os scripts definidos em docker/base/script (ex: runserver.sh, gunicorn.sh, test.sh, run_celery.sh, etc) na raíz do docker (/);

     1. ej-server:base-test: Além dos recursos de ej-server:base, possui todas as dependências definidas em requirements/test.txt. Essa imagem é utilizada para executar os testes locais e para o ambiente de desenvolvimento;

     2. ej-server:base-production: Além dos recursos de ej-server:base, possui todas as dependências definidas em requirements/production.txt;

        1. ej-server:develop: Além dos recursos de ej-server:base-production, possui o ambiente de homologação devidamente configurado;

           1. ej-nginx:develop: Copia os arquivos estáticos de ej-server:develop para seu ambiente nginx.

        2. ej-server:latest: Além dos recursos de ej-server:base-production, possui o ambiente de produção devidamente configurado;

           1. ej-nginx:latest: Copia os arquivos estáticos de ej-server:latest para seu ambiente nginx.

Ambiente Local

Subir ambiente sem iniciar serviços django

sudo docker-compose -f docker/local/idle.yml up -d

Subir ambiente iniciando todos os serviços

sudo docker-compose -f docker/local/start.yml up -d

Lidando com Atualizações

Atualizações nos Scripts

1. Confirme o desejo de modificação com o time de desenvolvimento, visto que as atualizações irão perpetuar em todos os ambientes quando estes forem atualizados;

2. Garanta que esteja na última versão da branch build:

   git fetch origin
   git checkout build
   git pull origin build

3. Crie o commit com a mudança no script;

4. Opte por testar o(s) script(s) atualizando localmente as imagens que este(s) script(s) são utilizados. Exemplo: Alterei o script runserver.sh e ele utilizado no ambiente local, portanto:

   sudo docker-compose -f docker/base/base.build.yml build
   sudo docker-compose -f docker/base/test.build.yml build
   sudo docker-compose -f docker/local/start.yml up

5. Dê push na branch build com a modificação.

Atualizações no requirements/base.txt

1. Confirme o desejo de modificação com o time de desenvolvimento, visto que as atualizações irão perpetuar em todos os ambientes quando estes forem atualizados;

2. Garanta que esteja na última versão da branch build:

   git fetch origin
   git checkout build
   git pull origin build

3. Crie o commit com a mudança nas dependências;

4. Verifique a instalação da(s) nova(s) dependência(s):

   sudo docker-compose -f docker/base/base.build.yml build

5. Dê push na branch build com a modificação.

Atualizações no requirementes/test.txt

1. Confirme o desejo de modificação com o time de desenvolvimento, visto que as atualizações irão perpetuar em todos os ambientes locais quando estes forem atualizados;

2. Garanta que esteja na última versão da branch build_test:

   git fetch origin
   git checkout build_test
   git pull origin build_test

3. Crie o commit com a mudança nas dependências;

4. Verifique a instalação da(s) nova(s) dependência(s):

   sudo docker-compose -f docker/base/test.build.yml build

5. Dê push na branch build_test com a modificação.

Atualizações no requirementes/production.txt

1. Confirme o desejo de modificação com o time de desenvolvimento, visto que as atualizações irão perpetuar em todos os ambientes de produção/homologação quando estes forem atualizados;

2. Garanta que esteja na última versão da branch build_production:

   git fetch origin
   git checkout build_production
   git pull origin build_production

3. Crie o commit com a mudança nas dependências;

4. Verifique a instalação da(s) nova(s) dependência(s):

   sudo docker-compose -f docker/base/production.build.yml build

5. Dê push na branch build_production com a modificação.