Обзор развертывания Django на сервере¶
Предварительные требования¶
Для успешного развертывания приложения требуются следующие параметры и системные компоненты:
-
Операционная система: Debian или Ubuntu.
-
Права доступа: права суперпользователя (
root). -
Доменное имя: используется поддомен на базе
hostkey.in. -
Порты:
-
Внутренний порт приложения:
8000(используется для работы сервиса). -
Внешний порт:
443(HTTPS через Nginx).
FQDN итоговой панели на домене hostkey.in¶
| Параметр | Значение |
|---|---|
| Префикс | django |
| Домен | hostkey.in |
| Полный шаблон | django{Server_ID_from_Invapi}.hostkey.in |
Структура файлов и каталогов¶
Основные директории, используемые в системе:
-
/root/django_client/project— рабочая директория проекта Django. -
/root/django_client/venv— виртуальное окружение Python. -
/etc/systemd/system/django.service— файл системной службы для управления приложением. -
/root/nginx/compose.yml— конфигурационный файл Docker Compose для прокси-сервера. -
/data/nginx/user_conf.d/— директория с пользовательскими конфигурациями Nginx. -
/data/nginx/letsencrypt/— директория для хранения SSL-сертификатов и проверок ACME.
Процесс установки приложения¶
Процесс развертывания включает несколько этапов:
-
Подготовка системы: Обновление списков пакетов APT и установка системных зависимостей (
python3,python3-pip,libpq-dev,python3-venv,python3-pexpect). -
Настройка окружения Python:
-
Создание виртуального окружения в директории
/root/django_client/venv. -
Установка пакетов
djangoиpexpectвнутри виртуального окружения. -
Развертывание проекта:
-
Создание структуры каталогов проекта.
-
Инициализация нового проекта Django через команду
django-admin startproject. -
Настройка конфигурационного файла
settings.py: установка параметровBASE_DIR,STATIC_ROOT,ALLOWED_HOSTSиCSRF_TRUSTED_ORIGINS. -
Подготовка статических файлов:
-
Создание директории для статики.
-
Выполнение команды сбора статических файлов (
collectstatic). -
База данных: Применение миграций базы данных через
manage.py migrate. -
Настройка безопасности: Создание суперпользователя Django (username:
root). -
Установка прокси-сервера: Развертывание контейнера Nginx с поддержкой автоматического получения SSL-сертификатов через Certbot.
Права доступа и безопасность¶
-
Приложение работает от имени пользователя
root. -
Для обеспечения безопасности используется виртуальное окружение Python, изолирующее зависимости приложения от системных библиотек.
-
Настройка брандмауэра должна разрешать входящий трафик на порты
80(для проверки SSL) и443.
Базы данных¶
Приложение использует базу данных PostgreSQL (требуется наличие установленного сервера БД или возможности подключения к внешнему). Конфигурация базы данных определяется в настройках проекта Django.
Контейнеры Docker и их запуск¶
Для обеспечения работы веб-сервера и автоматического обновления SSL-сертификатов используется контейнер:
| Имя образа | Порты | Тома (volumes) | Переменные окружения | Политика перезапуска |
|---|---|---|---|---|
jonasal/nginx-certbot:latest | host mode | nginx_secrets:/etc/letsencrypt, /data/nginx/user_conf.d:/etc/nginx/user_conf.d, /data/nginx/letsencrypt:/var/www/letsencrypt | CERTBOT_EMAIL=hkadm@hostkey.com, параметры из /data/nginx/nginx-certbot.env | unless-stopped |
Кастомные скрипты и дополнительные настройки¶
В процессе развертывания выполняется автоматизированная настройка конфигурации Nginx с помощью Python-скрипта, который:
-
Находит нужный блок
serverв конфигурационном файле пользователя. -
Вставляет директиву
location ^~ /.well-known/acme-challenge/для корректной работы проверки SSL-сертификатов. -
Перенаправляет корневой путь (
location /) на сервис приложения, заменяя стандартный путь/django_client.
Инструкция по обновлению приложения¶
Для обновления основного приложения необходимо:
-
Перейти в директорию проекта.
-
Выполнить обновление кода (если применимо).
-
Применить миграции базы данных:
-
Собрать статические файлы:
-
Перезапустить сервис приложения:
Расположение конфигурационных файлов и данных¶
-
Конфигурация Django:
/root/django_client/project/django_client/settings.py -
Конфигурация Nginx (пользовательская):
/data/nginx/user_conf.d/django{Server_ID_from_Invapi}.hostkey.in.conf -
Переменные окружения Certbot:
/data/nginx/nginx-certbot.env
Доступные порты для подключения¶
-
443(HTTPS) — основной доступ к приложению через веб-интерфейс. -
8000(HTTP) — внутренний порт приложения (доступен локально на сервере).
Запуск, остановка приложения¶
Управление приложением осуществляется через системную службу systemd:
-
Запуск:
systemctl start django -
Остановка:
systemctl stop django -
Перезапуск:
systemctl restart django -
Проверка статуса:
systemctl status django