Instalação do Django no Debian 8

• Instalar pacotes
• Bancos de dados de instalação
• Configurar o ambiente virtual
• Upload e configuração do projeto
• Configurar Gunicorn
• Nginx
• Conclusão

Este tutorial explica como configurar o Django no Debian 8 (jessie). Vou mostrar como usar o Python 2 e 3, bem como o Nginx e o PostgreSQL.

Tudo o que é feito neste tutorial é feito como raiz.

Instalar pacotes

Para começar, precisamos instalar alguns pacotes.

Para Python 2:

apt-get install python-pip python-dev virtualenv nginx postgresql postgresql-contrib libpq-dev sudo gcc

Para Python 3:

apt-get install python3-pip python3-dev virtualenv nginx postgresql postgresql-contrib libpq-dev sudo gcc

Bancos de dados de instalação

Primeiro, efetuamos login no usuário postgres.

sudo -u postgres -s

Em seguida, criamos um novo banco de dados. O nome do banco de dados pode ser o que você deseja ( dbnameé usado aqui), mas você deve ser consistente com o restante da configuração.

createdb dbname

Crie um usuário para o novo banco de dados. Novamente, isso pode ser o que você deseja que seja, mas eu usei dbuser. Isso também solicitará que você defina uma senha.

createuser -P dbuser

O usuário agora deve ter acesso ao banco de dados. Apenas certifique-se de usar o nome do banco de dados e o nome de usuário corretos.

psql
postgres=# GRANT ALL PRIVILEGES ON DATABASE dbname TO dbuser;
postgres=# \q

Sair para a raiz.

exit

Habilite e inicie o PostgreSQL:

systemctl enable postgresql
systemctl start postgresql

Configurar o ambiente virtual

Em vez de usar apenas os arquivos python globais, usaremos um ambiente virtual. Começamos criando um diretório para armazenar tudo.

mkdir -p /opt/project

Agora criamos o ambiente. Isso é diferente para usuários do python 2 e 3.

Para Python 2:

virtualenv . -p python

Para Python 3:

virtualenv . -p python3

Digite o ambiente virtual.

source bin/activate

Instale o Django, gunicorn e psycopg2.

pip install django
pip install gunicorn
pip install psycopg2

Se você precisar de uma versão específica do Django, altere o comando install para corresponder ao formato abaixo. Este exemplo instala 1.7.8.

pip install django==1.7.8

Agora já terminamos com isso, para que possamos desativar nosso ambiente virtual.

deactivate

Upload e configuração do projeto

Este é o momento em que carregamos o nosso projeto no servidor e garantimos que todas as suas configurações estejam corretas. Você pode usar qualquer método para fazer isso. FTP, SFTP, git, etc, são todas as formas de fazer isso. Se você estiver usando o git para rastrear o código do projeto, basta cloná-lo no servidor. Este comando git irá clonar o projeto para o servidor e colocá-lo em /opt/project/project/.

git clone http://example.com:project.git

Abra o settings.pyarquivo em qualquer navegador de texto.

Primeiramente, o modo de depuração precisa estar desativado. Procure a DEBUG = Truelinha e mude Truepara False. Depois disso, verifique se você ALLOWED_HOSTSdefiniu algum valor.

ALLOWED_HOSTS = ['*']

Procure o DATABASESdicionário e ele deve ficar assim:

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql_psycopg2',
        'NAME': 'dbname',
        'USER': 'dbuser',
        'PASSWORD': 'password you set',
        'HOST': 'localhost',
        'PORT': ''
    }
}

O último passo aqui é definir uma raiz estática. Coloque o seguinte diretamente abaixo STATIC_URL.

STATIC_ROOT = '/opt/project/static/'

Saia do arquivo e crie o diretório raiz estático.

mkdir -p /opt/project/static

Agora migre o banco de dados, crie um superusuário e colete todos os arquivos estáticos.

cd /opt/project/project
../bin/python manage.py makemigrations
../bin/python manage.py migrate
../bin/python manage.py createsuperuser
../bin/python manage.py collectstatic

Configurar Gunicorn

Gunicorn é o servidor WSGI que iremos usar. Como o Debian 8 vem com o systemd, tiraremos proveito do systemd para iniciar e parar o servidor.

Crie o arquivo /etc/systemd/system/django.servicee adicione o seguinte conteúdo.

[Unit]
Description=Django with Gunicorn
After=network.target

[Service]
User=root
Group=root
WorkingDirectory=/opt/project
ExecStart=/opt/project/bin/gunicorn --workers 3 --bind 127.0.0.1:8000 project.wsgi

[Install]
WantedBy=multi-user.target

Ative e inicie o serviço que criamos.

systemctl enable django.service
systemctl start django.service

Nginx

Você deve ter notado que ligamos o servidor gunicorn 127.0.0.1. Agora precisamos de uma maneira de acessá-lo de fora do servidor. É aqui que entra o Nginx.

Crie o novo arquivo /etc/nginx/sites-available/djangoe adicione o seguinte. A domain.example.compeça pode ser configurada para o que você precisar.

server {
        listen 80;
        server_name domain.example.com;
        access_log off;

        location /static/ {
                alias /opt/project/static/;
        }

        location / {
                proxy_pass http://127.0.0.1:8000;
        }
}

Crie um link simbólico para ativar este site.

ln -s /etc/nginx/sites-available/django /etc/nginx/sites-enabled/django

Habilite e inicie o Nginx.

systemctl enable nginx
systemctl start nginx

Conclusão

Parabéns, agora você tem um site Django em funcionamento no seu VPS Debian.