SHiNE-server/server-backup/AGENTS.md

AGENTS для server-backup

Назначение

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

Структура

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

Правила

• Полный бэкап складывать только в server-backup/archive/.
• server-backup/archive/** не коммитить.
• Любое изменение схемы восстановления фиксировать в git.
• После обновления схемы увеличивать backup.schema.version.
• После нового полного бэкапа увеличивать backup.full.version.

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

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

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

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