voidea/docs/runbook/05-update.md

Runbook: Обновление

Стандартное обновление

# 1. Забрать новую версию
cd /opt/voidea
git pull origin main

# 2. Активировать виртуальное окружение
source venv/bin/activate

# 3. Обновить зависимости
pip install -r requirements.txt

# 4. Применить миграции БД
alembic upgrade head

# 5. Перезапустить сервис
systemctl restart voidea

# 6. Проверить health
curl http://localhost:8020/api/v1/health

Обновление с минимальным даунтаймом

# 1. Запустить второй инстанс на другом порту
DATABASE_URL=... uvicorn app.main:app --port 8021 &

# 2. Проверить его health
curl http://localhost:8021/health

# 3. Переключить systemd или Nginx на новый порт
# 4. Остановить старый

Откат

# 1. Откатить код
cd /opt/voidea
git revert HEAD

# 2. Откатить БД (если была миграция)
alembic downgrade -1

# 3. Перезапустить
systemctl restart voidea

Миграция БД

# Сгенерировать новую миграцию
alembic revision --autogenerate -m "description"

# Применить
alembic upgrade head

# Откатить
alembic downgrade -1