sapl/docs/deploy.rst

==============================
Instruções para fazer o Deploy
==============================

Para efeitos deste doc, foram consideradas as tecnologias NGINX + GUNICORN para servir a aplicação Django SAPL.

O NGINX é o servidor WEB, e o GUNICORN é o servidor da aplicação para o servidor WEB.



É altamente recomendável que para produção o SAPL não seja executado em modo debug.
Para isso edite o arquivo ``.env`` criado anteriormente em::

   sudo nano /var/interlegis/sapl/sapl/.env

alterando o variável DEBUG para false::

    DEBUG = False

Entrar no ambiente virtual::

   workon sapl


Arquivos Estáticos
------------------
Com o ambiente em produção, os arquivos estáticos devem ser servidos pelo web service, em nosso caso o `NGINX`, logo para ter acesso aos arquivos primeiro devemos rodar o seguinte comando::

   ./manage.py compilescss

para que os arquivos SASS/SCSS sejam compilados em arquivos .css em ambiente de produção, e em seguida rode::

   ./manage.py collectstatic --no-input

para coletar todos os arquivos estáticos do projeto e guarda-los no diretório definido em `STATIC_ROOT`, que será também o diretório no qual o `NGINX` irá referenciar para a aplicação.

Instalando Pacotes
------------------

Instalar o NGINX::

  sudo apt-get install nginx


Instalar o Gunicorn::

  sudo pip3 install gunicorn


Preparando o NGINX
------------------
sudo nano /etc/nginx/sites-available/sapl31.conf::

   upstream ENDERECO_SITE {
      server unix:/var/interlegis/sapl/run/gunicorn.sock fail_timeout=0;
   }

   server {

       listen   80;
       server_name ENDERECO_SITE;

       client_max_body_size 4G;

       access_log /var/log/nginx-access.log;
       error_log /var/log/nginx-error.log;

       location /static/ {
           alias   /var/interlegis/sapl/collected_static/;
       }

       location /media/ {
           alias   /var/interlegis/sapl/media/;
       }

       location / {
           proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
           proxy_set_header Host $http_host;
           proxy_redirect off;
           if (!-f $request_filename) {
               proxy_pass http://ENDERECO_SITE;
               break;
           }
       }

       # Error pages
       error_page 500 502 503 504 /500.html;
       location = /500.html {
           root /var/interlegis/sapl/sapl/static/;
       }
   }


Criar link simbólico para ativar o site::

   sudo ln -s /etc/nginx/sites-available/sapl31.conf /etc/nginx/sites-enabled/sapl3

Reiniciar o nginx::

   sudo service nginx restart


Preparando o Gunicorn
---------------------
Na raiz do Projeto sapl, existe o arquivo chamado gunicorn_start.sh

Para definir o parametro NUM_WORKERS  utilize a seguinte fórmula: 2 * CPUs  1.
Para uma máquina de CPU única o valor seria 3


Para rodar o gunicorn::

   workon sapl

   /var/interlegis/sapl/.gunicorn_start.sh



#Referências.

http://michal.karzynski.pl/blog/2013/06/09/django-nginx-gunicorn-virtualenv-supervisor/

Para multiplas aplicações Django.

http://michal.karzynski.pl/blog/2013/10/29/serving-multiple-django-applications-with-nginx-gunicorn-supervisor/

Compilar arquivos SASS/SCSS

https://github.com/jrief/django-sass-processor#offline-compilation
https://github.com/jrief/django-sass-processor/issues/34#issuecomment-252611103

Deploy Arquivos Estáticos

https://docs.djangoproject.com/pt-br/1.11/howto/static-files/deployment/