Инсталирайте 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.