Перейти к содержанию

Обзор развертывания 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.

Процесс установки приложения

Процесс развертывания включает несколько этапов:

  1. Подготовка системы: Обновление списков пакетов APT и установка системных зависимостей (python3, python3-pip, libpq-dev, python3-venv, python3-pexpect).

  2. Настройка окружения Python:

  3. Создание виртуального окружения в директории /root/django_client/venv.

  4. Установка пакетов django и pexpect внутри виртуального окружения.

  5. Развертывание проекта:

  6. Создание структуры каталогов проекта.

  7. Инициализация нового проекта Django через команду django-admin startproject.

  8. Настройка конфигурационного файла settings.py: установка параметров BASE_DIR, STATIC_ROOT, ALLOWED_HOSTS и CSRF_TRUSTED_ORIGINS.

  9. Подготовка статических файлов:

  10. Создание директории для статики.

  11. Выполнение команды сбора статических файлов (collectstatic).

  12. База данных: Применение миграций базы данных через manage.py migrate.

  13. Настройка безопасности: Создание суперпользователя Django (username: root).

  14. Установка прокси-сервера: Развертывание контейнера 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.

Инструкция по обновлению приложения

Для обновления основного приложения необходимо:

  1. Перейти в директорию проекта.

  2. Выполнить обновление кода (если применимо).

  3. Применить миграции базы данных:

    /root/django_client/venv/bin/python /root/django_client/project/manage.py migrate --noinput
    

  4. Собрать статические файлы:

    /root/django_client/venv/bin/python /root/django_client/project/manage.py collectstatic --noinput
    

  5. Перезапустить сервис приложения:

    systemctl restart django.service
    

Расположение конфигурационных файлов и данных

  • Конфигурация 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

question_mark
Я могу вам чем-то помочь?
question_mark
ИИ Помощник ×