Разработка веб-приложений — это только половина дела. Вторая, не менее важная часть — это их развертывание (деплой) на сервере. Если вы работаете с Django, то знаете, что процесс деплоя может быть сложным и трудоемким. Однако современные инструменты, такие как GitHub Actions , позволяют автоматизировать этот процесс, сделав его быстрым и надежным.

В этой статье мы рассмотрим, как настроить автоматический деплой Django-проекта на сервер с использованием GitHub Actions. Мы будем использовать популярный стек технологий: Nginx , Gunicorn и PostgreSQL , а также покажем, как настроить CI/CD для вашего проекта.

Что такое GitHub Actions?

GitHub Actions — это мощный инструмент для автоматизации рабочих процессов прямо в репозитории GitHub. С его помощью можно настроить непрерывную интеграцию (CI) и непрерывное развертывание (CD). Это означает, что при каждом коммите или пуше в определенную ветку ваш код будет автоматически тестироваться, собираться и разворачиваться на сервере.

Предварительные требования

Прежде чем начать, убедитесь, что у вас есть:

1. Django-проект в репозитории GitHub.
2. Сервер с Ubuntu (например, на AWS, DigitalOcean или другом хостинге).
3. Установленные на сервере:
   • Python
   • PostgreSQL
   • Nginx
   • Gunicorn
4. SSH-доступ к серверу.
5. Базовые знания работы с командной строкой.

Шаг 1: Настройка сервера

Перед тем как настраивать GitHub Actions, нужно подготовить сервер для развертывания Django-проекта.

1.1. Установка необходимых пакетов

Подключитесь к серверу через SSH и установите необходимые пакеты:

sudo apt update
sudo apt install python3-pip python3-venv nginx postgresql postgresql-contrib git

1.2. Настройка PostgreSQL

Создайте базу данных и пользователя для вашего проекта:

sudo -u postgres psql
CREATE DATABASE myproject;
CREATE USER myuser WITH PASSWORD 'mypassword';
ALTER ROLE myuser SET client_encoding TO 'utf8';
ALTER ROLE myuser SET default_transaction_isolation TO 'read committed';
ALTER ROLE myuser SET timezone TO 'UTC';
GRANT ALL PRIVILEGES ON DATABASE myproject TO myuser;
\q

1.3. Настройка Nginx

Создайте конфигурационный файл для Nginx:

sudo nano /etc/nginx/sites-available/myproject

Добавьте следующее содержимое:

server {
    listen 80;
    server_name your-domain.com;

    location = /favicon.ico { access_log off; log_not_found off; }
    location /static/ {
        root /path/to/your/project;
    }

    location / {
        include proxy_params;
        proxy_pass http://unix:/run/gunicorn.sock;
    }
}

Активируйте конфигурацию:

sudo ln -s /etc/nginx/sites-available/myproject /etc/nginx/sites-enabled
sudo nginx -t
sudo systemctl restart nginx

Шаг 2: Настройка GitHub Actions

Теперь перейдем к самому интересному — настройке автоматического деплоя с помощью GitHub Actions.

2.1. Создание файла workflow

В корне вашего репозитория создайте директорию .github/workflows/ и добавьте файл deploy.yml:

name: Deploy Django Project

on:
  push:
    branches:
      - main  # Выберите ветку, из которой будет происходить деплой

jobs:
  deploy:
    runs-on: ubuntu-latest

    steps:
    - name: Checkout code
      uses: actions/checkout@v3

    - name: Set up Python
      uses: actions/setup-python@v4
      with:
        python-version: '3.10'  # Укажите версию Python

    - name: Install dependencies
      run: |
        python -m pip install --upgrade pip
        pip install -r requirements.txt

    - name: Run tests
      run: |
        python manage.py test

    - name: Deploy to server
      uses: appleboy/ssh-action@master
      with:
        host: ${{ secrets.SERVER_HOST }}
        username: ${{ secrets.SERVER_USER }}
        key: ${{ secrets.SSH_PRIVATE_KEY }}
        port: 22
        script: |
          cd /path/to/your/project
          git pull origin main
          source venv/bin/activate
          pip install -r requirements.txt
          python manage.py migrate
          sudo systemctl restart gunicorn

2.2. Настройка секретов

Для безопасного подключения к серверу используйте секреты GitHub. Перейдите в настройки репозитория (Settings > Secrets and variables > Actions) и добавьте следующие переменные:

• SERVER_HOST: IP-адрес вашего сервера.
• SERVER_USER: Имя пользователя для SSH.
• SSH_PRIVATE_KEY: Приватный ключ SSH (сгенерируйте его с помощью ssh-keygen и добавьте публичный ключ на сервер).

Шаг 3: Тестирование деплоя

Теперь, когда все настроено, выполните следующие шаги:

1. Сделайте коммит в ветку main.
2. Проверьте выполнение workflow в разделе Actions вашего репозитория.
3. После успешного завершения деплоя откройте ваш сайт в браузере.

Заключение

Автоматизация деплоя с помощью GitHub Actions значительно упрощает процесс развертывания Django-проектов. Теперь вам не нужно вручную подключаться к серверу и выполнять команды — все происходит автоматически. Это экономит время, снижает вероятность ошибок и делает процесс более надежным.

Если у вас возникли вопросы или вы хотите углубиться в тему, напишите в комментариях! 🚀