Skip to content

Latest commit

 

History

History
154 lines (87 loc) · 5.87 KB

docker.rst

File metadata and controls

154 lines (87 loc) · 5.87 KB

Implantação do SAAP com container Docker

Para implantar o SAAP utilizando o container docker, é necessário realizar os passos demonstrados nesse tutorial.

Algumas vezes, não é possível executar os comandos docker sem usar sudo antes.

1) Instalar pacotes

Atualize o sistema:

sudo apt-get update && sudo apt-get upgrade -y

Instale os pacotes:

sudo apt-get install docker docker-compose -y

2) Preparar docker-compose

Após a instalação do docker, é necessário preparar o arquivo de configuração que fará o procedimento de instalação e configuração, tanto do SAAP quanto do banco de dados.

Para isto, use o arquivo docker-compose.yml disponível aqui. O mesmo pode estar em qualquer localização que for desejada - nossa sugestão é mantê-lo em uma pasta /var/interlegis/docker

É importante verificar os seguintes itens:

  • Se os mapeamentos de volume estão corretos

  • Se a versão do SAAP referenciada no arquivo é a desejada. É possível utilizar o número da versão, ou se preferir usar a expressão latest

  • Se os dados da seção environment condizem com a Casa Legislativa.

    • O campo SITE_DOMAIN deve conter o endereço que será usado para acessar o SAAP
    • Os campos EMAIL_* devem conter os dados corretos do servidor de e-mail, incluindo usuário/senha para envio de mensagens
    • Os campos DADOS_* são usados no rodapé do site
    • O campo BRASAO_PROPRIO exibe ou não um brasão personalizado. Caso False, será usado o Brasão de Armas do Brasil. Caso True, deverá ser feita a cópia do arquivo do brasão, conforme mostra a seção correspondente logo abaixo.
    • Os campos ADMIN_* devem conter os dados do primeiro usuário que será criado, com permissão de administração. Posteriormente é possível alterar o e-mail e/ou senha do mesmo.

3) Instalar imagens

Com o docker-compose preparado, é necessário rodar o seguinte comando, dentro da pasta onde está localizado o arquivo.

sudo docker-compose up

O docker iniciará o download, instalação e configuração das imagens. Após alguns minutos, ao aparecer a palavra SAAP, o Ngnix e o Gunicorn iniciarão o serviço. Então, basta testar se o sistema está funcionando.

Para rodar as imagens em background, deve-se primeiramente abortar a execução das imagens, apertando Ctrl + C.

Então, basta rodar o docker-compose com a opção -d:

sudo docker-compose up -d

4) Atualizar o brasão

Se a opção BRASAO_PROPRIO está com True, é necessário atualizar a imagem do brasão. Para isto, basta colocar a imagem desejada, em formado PNG, com o nome de brasao-camara.png, e rodar o comando:

sudo docker cp brasao-camara.png saap:/var/interlegis/saap/saap/static/img/brasao-camara.png
sudo docker cp brasao-camara.png saap:/var/interlegis/saap/collected_static/img/brasao-camara.png

5) Preparar o banco de dados

Para que o sistema pronto, devemos carregar o banco com os dados iniciais, bem como as configurações de permissões. Para isto, deve-se rodar os comandos a seguir, na ordem:

sudo docker cp saap:/var/interlegis/saap/config/initial_data/django_content_type.sql .
sudo docker exec -i postgres psql -U saap -d saap < django_content_type.sql

sudo docker exec -it saap bash
./manage.py loaddata config/initial_data/auth_permission.json
./manage.py loaddata config/initial_data/auth_group.json
./manage.py loaddata config/initial_data/saap*.json
./manage.py loaddata config/initial_data/core*.json
exit

Para concluir, deve-se criar a função unaccent, que será usada em diversas consultas dentro do SAAP:

sudo docker exec -i postgres psql -U saap -c "CREATE EXTENSION unaccent;"

Parar imagens

Para interromper a execução das imagens rodando em background, basta rodar:

sudo docker-compose stop

Backup do banco Postgres

Para realizar o backup do banco do SAAP, basta rodar o seguinte comando:

sudo docker exec postgres pg_dump -U saap -v -Fc saap > ~/saap.dump

O destino e o nome do arquivo gerado são personalizáveis.

Restore do banco Postgres

Para realizar a restauraçao do banco, é necessário previamente limpar o banco atual:

sudo docker exec postgres psql -U saap -c 'DROP SCHEMA PUBLIC CASCADE;'
sudo docker exec postgres psql -U saap -c 'CREATE SCHEMA PUBLIC;'

Em seguida, basta copiar o arquivo para dentro da imagem e fazer a importação:

sudo docker cp saap.dump postgres:/tmp/
sudo docker exec postgres pg_restore -v -U saap -d saap /tmp/saap.dump

Atualizar imagem

Para atualizar a imagem, é necessário, primeiramente, fazer o backup do banco, conforme explicado acima. Então, basta rodar os comandos abaixo:

sudo docker-compose down
sudo docker pull ojonathacardoso/saap:latest
sudo docker-compose up

Por fim, restaurar o brasão, conforme passo 5. A princípio, a imagem estará atualizada, sem a necessidade de restaurar o banco.