SHiNE-server/deploy/backup/AGENTS.md

AGENTS для deploy/backup

Назначение

• Папка deploy/backup/ хранит:
  • тяжёлые локальные бэкапы сервера (НЕ в git);
  • лёгкую схему восстановления (в git), чтобы можно было поднять сервер даже без полного архива.

Структура

• archive/YYYY-MM-DD/ — полный бэкап конкретной даты.
• scheme/shineup.me/ — схема восстановления и ключевые конфиги.
• backup-version.properties — версия контура бэкапа.

Правила

• Полный бэкап складывать только в deploy/backup/archive/.
• deploy/backup/archive/** не коммитить, кроме .gitkeep.
• Перед production deploy проверить, что свежий бэкап скопирован в deploy/backup/archive/<дата>/ и есть MANIFEST.txt.
• Любое изменение схемы восстановления фиксировать в git.
• После обновления схемы увеличивать backup.schema.version.
• После нового полного бэкапа увеличивать backup.full.version.

Как обновлять бэкап

1. Обновить схему:
   • bash deploy/backup/scheme/shineup.me/scripts/refresh_scheme.sh
2. Сделать новый полный бэкап:
   • bash deploy/backup/scheme/shineup.me/scripts/backup_full.sh
3. Проверить deploy/backup/archive/<дата>/MANIFEST.txt.
4. Поднять версии в deploy/backup/backup-version.properties.

Как восстанавливать

• Смотреть deploy/backup/scheme/shineup.me/docs/RESTORE.md.