Деплой на VPS¶

Пошаговая инструкция для Ubuntu/Debian VPS.

Требования¶

Ресурс	Минимум	Рекомендуется
RAM	2 GB	4 GB + swap
CPU	1 vCPU	2 vCPU
Disk	20 GB	40 GB SSD
OS	Ubuntu 22.04+

1. Подготовка сервера¶

sudo apt update && sudo apt upgrade -y
sudo apt install -y git docker.io docker-compose-plugin curl
sudo usermod -aG docker $USER

2. SSH-ключ для GitHub Actions¶

На локальной машине:

ssh-keygen -t ed25519 -f aima_deploy -N ""

Публичный ключ → ~/.ssh/authorized_keys на VPS.
Приватный → GitHub Secret VPS_SSH_KEY.

3. Клонирование¶

ssh user@your-vps
git clone https://github.com/valera7623/AI-medical-assistant.git ~/AI_medical_assistant
cd ~/AI_medical_assistant

4. Конфигурация¶

cp .env.example .env.production
nano .env.production

Обязательно:

SECRET_KEY — openssl rand -hex 32
ENVIRONMENT=production
POSTGRES_PASSWORD — надёжный пароль ( deploy.sh построит DATABASE_URL )
CORS_ORIGINS и FRONTEND_URL — ваш HTTPS-домен
MFA_ENFORCED=true (или false только временно для обслуживания)

После обновления репозитория синхронизируйте новые ключи:

python scripts/sync_env_from_example.py

5. Первый деплой¶

chmod +x deploy.sh scripts/*.sh
./deploy.sh production

6. Reverse proxy (Nginx)¶

server {
    listen 443 ssl http2;
    server_name aima.example.com;

    ssl_certificate     /etc/letsencrypt/live/aima.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/aima.example.com/privkey.pem;

    location / {
        proxy_pass http://127.0.0.1:8001;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

    location /ws/ {
        proxy_pass http://127.0.0.1:8001;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }

    client_max_body_size 500M;
}

Certbot:

sudo certbot --nginx -d aima.example.com

7. Swap (опционально)¶

sudo SWAP_SIZE_GB=4 ./scripts/setup_swap.sh

8. Cron¶

# Еженедельная очистка Docker (воскресенье 3:00)
0 3 * * 0 /home/user/AI_medical_assistant/scripts/docker_cleanup.sh weekly >> /var/log/aima-cleanup.log 2>&1

9. Проверка¶

curl -s localhost:8001/health/ready
curl -s https://aima.example.com/health/ready

Обновление¶

Автоматически через GitHub Actions (push в main) или вручную:

cd ~/AI_medical_assistant && git pull && ./deploy.sh production

Если меняли только .env без деплоя кода:

docker compose -f docker-compose.yml -f docker-compose.prod.yml up -d --force-recreate app celery_worker

Проверка, что переменная попала в контейнер:

docker compose exec app python -c "from app.config import settings; print(settings.MFA_ENFORCED)"

SSH alias¶

~/.ssh/config:

Host aima-vps
    HostName your-vps-ip
    User smdg
    IdentityFile ~/.ssh/aima_deploy