Операция ДЕПЛОЙ

infra/@{имя}.service/
├── AI.md                  ← роль, правила
├── CLAUDE.md              ← навигация
├── index.yaml             ← class: ServiceComponent
├── docker-compose.yml     ← точка входа
├── .env.example           ← переменные без значений
└── config/                ← конфиги сервиса

bash /opt/scripts/check_resources.sh
# GREEN → продолжай / YELLOW → cleanup / RED → СТОП

# пометить текущую версию
docker tag {service}:latest {service}:backup-$(date +%Y%m%d-%H%M)
git branch backup/$(date +%Y%m%d-%H%M)

git pull origin main
# или для конкретной ветки:
git checkout feature/my-feature && git pull

cd infra/@{имя}.service/
docker compose build --no-cache

docker compose run --rm app alembic upgrade head
# проверить:
docker compose run --rm app alembic current

docker compose up -d

# статус контейнеров
docker compose ps

# health check
curl -s -o /dev/null -w "%{http_code}" http://localhost:{port}/health
# ожидаем: 200

# логи первых 30 секунд
docker compose logs --tail=50 -f app &
sleep 30 && kill %1

ЗАДЕПЛОЕНО:
• Сервис: {имя}
• Окружение: {dev/staging/prod}
• Версия: {git commit hash}
• Статус: 200 OK
ОТКАТ: docker tag {service}:backup-{date} {service}:latest && docker compose up -d

✅  Прошло staging
✅  QA проверено
✅  Бэкап БД сделан
✅  .env для prod — актуален
✅  Оператор явно написал "деплоим в прод"

⚠️ L4 ДЕПЛОЙ В PROD
Сервис: {имя}
Версия: {hash}
Бэкап БД: СДЕЛАН ✅
Откат: docker rollback + pg_restore

Напиши явно "да" для продолжения.

# /etc/nginx/sites-available/{домен}.conf
server {
    listen 80;
    server_name {домен};

    location / {
        proxy_pass http://localhost:{port};
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

ln -s /etc/nginx/sites-available/{домен}.conf /etc/nginx/sites-enabled/
nginx -t && nginx -s reload

nginx -t                                              # синтаксис
curl -s -o /dev/null -w "%{http_code}" http://{домен}  # статус

# system/scheduler/tasks/{имя}.yaml
id: nocodb-backup
schedule: "0 3 * * *"
command: bash /opt/scripts/backup-nocodb.sh
service: nocodb
on_failure: notify_telegram

# пометить ПЕРЕД деплоем (делается в §3 Шаг 2)
docker tag {service}:latest {service}:backup-$(date +%Y%m%d-%H%M)

# откат
docker compose down
docker tag {service}:backup-YYYYMMDD-HHmm {service}:latest
docker compose up -d

# проверка
docker compose ps
curl -s -o /dev/null -w "%{http_code}" http://localhost:{port}/health

# 1. остановить сервис
docker compose stop app

# 2. восстановить из дампа
gunzip -c $DATASPACE/backups/db/YYYYMMDD_HHmm_pre-deploy.sql.gz | \
  psql -U $DB_USER -d $DB_NAME

# 3. проверить
psql -U $DB_USER -d $DB_NAME -c "SELECT COUNT(*) FROM key_table;"

# 4. запустить
docker compose start app

# посмотреть текущую версию
docker compose run --rm app alembic current

# откат на 1 версию назад
docker compose run --rm app alembic downgrade -1

# откат до конкретной ревизии
docker compose run --rm app alembic downgrade {revision_id}

# проверка
docker compose run --rm app alembic current

# посмотреть статус модулей
docker compose exec app drush pm-list --status=enabled

# откат последнего обновления через drush
docker compose exec app drush updb --rollback

# если не помогло — восстановить БД из дампа (см. PostgreSQL)

# откат через git
git checkout HEAD -- /etc/nginx/sites-available/{домен}.conf
nginx -t && nginx -s reload

# проверка
curl -s -o /dev/null -w "%{http_code}" https://{домен}/

# восстановить volume из архива
docker compose stop app
docker run --rm \
  -v {volume_name}:/data \
  -v $DATASPACE/backups/volumes:/backup \
  alpine sh -c "cd /data && tar xzf /backup/YYYYMMDD_HHmm_vol_{name}.tar.gz"
docker compose start app

# безопасный откат (создаёт новый коммит)
git revert HEAD

# откат к конкретному коммиту
git revert {commit-hash}

# проверить
git log --oneline -5

1. СТОП — остановить все изменения
2. ОЦЕНИТЬ — что именно сломалось (код / данные / конфиг)
3. ВЫБРАТЬ метод из матрицы выше
4. УВЕДОМИТЬ оператора перед откатом БД (L4)
5. ОТКАТИТЬ — выполнить команды
6. ПРОВЕРИТЬ — сервис отвечает, данные целы
7. ЗАФИКСИРОВАТЬ → system/monitor/alerts/CRITICAL/

L0 → Автоматическая (monitor при disk >= 90%) — безопасно, без уведомления
L1 → С подтверждением (вручную или при disk >= 95%) — умеренный риск
L2 → Только вручную через SSH (критическая ситуация) — удаляет prod данные

find /tmp -type f -mtime +7 -delete
apt-get clean -y
docker image prune -f && docker volume prune -f
journalctl --vacuum-size=500M
find /var/log -name "*.gz" -mtime +7 -delete

docker system prune -a --volumes -f
find $INFRA/backups -type f -mtime +30 -delete
find $WORKSPACE -name "node_modules" -type d -mtime +60 -exec rm -rf {} \;
git gc --aggressive

df -h /                          # общий % диска
du -sh $WORKSPACE/* | sort -hr | head -10   # топ папок
docker system df                 # Docker потребление