Налаштуйте Django на Debian 8

У цьому посібнику пояснюється, як налаштувати Django на Debian 8 (jessie). Я покажу, як використовувати Python 2 і 3, а також Nginx і PostgreSQL.

Все, що зроблено в цьому посібнику, виконується як root.

Встановити пакети

Для початку нам потрібно встановити деякі пакунки.

Для Python 2:

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

Для Python 3:

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

Налаштування баз даних

Спочатку ми входимо в систему користувача postgres.

sudo -u postgres -s

Далі створюємо нову базу даних. Ім’я бази даних може бути будь-яким, як ви хочете ( dbnameтут використовується), але ви повинні відповідати решті налаштування.

createdb dbname

Створіть користувача для нової бази даних. Знову ж таки, це може бути все, що ви хочете, але я використовував dbuser. Це також попросить вас встановити пароль.

createuser -P dbuser

Тепер користувачеві потрібно надати доступ до бази даних. Просто не забудьте використовувати правильне ім’я бази даних та ім’я користувача.

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

Вихід до root.

exit

Увімкніть і запустіть PostgreSQL:

systemctl enable postgresql
systemctl start postgresql

Налаштуйте віртуальне середовище

Замість того, щоб просто використовувати глобальні файли Python, ми будемо використовувати віртуальне середовище. Ми починаємо зі створення каталогу, щоб зберігати все це.

mkdir -p /opt/project

Зараз ми створюємо середовище. Це відрізняється для користувачів python 2 і 3.

Для Python 2:

virtualenv . -p python

Для Python 3:

virtualenv . -p python3

Увійдіть у віртуальне середовище.

source bin/activate

Встановіть Django, gunicorn і psycopg2.

pip install django
pip install gunicorn
pip install psycopg2

Якщо вам потрібна конкретна версія Django, змініть команду встановлення відповідно до формату нижче. Цей приклад встановлює 1.7.8.

pip install django==1.7.8

Наразі ми закінчили з цим, тому можемо деактивувати наше віртуальне середовище.

deactivate

Завантаження та налаштування проекту

Це час, коли ми завантажуємо наш проект на сервер і перевіряємо, чи всі його налаштування правильні. Для цього можна використовувати будь-який спосіб. FTP, SFTP, git тощо – це всі способи зробити це. Якщо ви використовуєте git для відстеження коду проекту, ви можете просто клонувати його на сервер. Ця команда git клонує проект на сервер і розміщує його в /opt/project/project/.

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

Відкрийте settings.pyфайл у будь-якому текстовому браузері.

Перш за все, потрібно вимкнути режим налагодження. Знайдіть DEBUG = Trueрядок і перейдіть Trueна False. Після цього переконайтеся, що ви ALLOWED_HOSTSвстановили певне значення.

ALLOWED_HOSTS = ['*']

Знайдіть DATABASESсловник, і він має виглядати так:

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

Останнім кроком тут є встановлення статичного кореня. Розмістіть наступне безпосередньо нижче STATIC_URL.

STATIC_ROOT = '/opt/project/static/'

Вийдіть з файлу та створіть статичний кореневий каталог.

mkdir -p /opt/project/static

Тепер перенесіть базу даних, створіть суперкористувача та зберіть усі статичні файли.

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

Налаштувати Gunicorn

Gunicorn — це сервер WSGI, який ми будемо використовувати. Оскільки Debian 8 постачається разом із systemd, ми скористаємося перевагами systemd для запуску та зупинки сервера.

Створіть файл /etc/systemd/system/django.serviceі додайте наступний вміст.

[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

Увімкніть і запустіть створену нами службу.

systemctl enable django.service
systemctl start django.service

Nginx

Можливо, ви помітили, що ми прив’язали сервер gunicorn до 127.0.0.1. Тепер нам потрібен спосіб отримати до нього доступ з-за меж сервера. Тут на допомогу приходить Nginx.

Створіть новий файл /etc/nginx/sites-available/djangoі додайте наступне. domain.example.comЧастина може бути встановлена на всі , що потрібно, щоб це було.

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;
        }
}

Створіть символічне посилання, щоб увімкнути цей сайт.

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

Увімкніть і запустіть Nginx.

systemctl enable nginx
systemctl start nginx

Висновок

Вітаємо, тепер у вас є робочий сайт Django на вашому Debian VPS.