GitRiver GitRiver
EN
Навигация

Резервное копирование

Создание, восстановление и настройка бэкапов GitRiver

Управление бэкапами: Администрирование / Резервное копирование.

Создание бэкапа

  1. Откройте Администрирование / Резервное копирование
  2. Выберите компоненты для включения:
    • База данных - pg_dump (рекомендуется всегда)
    • Репозитории - Git bare-репозитории
    • Реестр - Container Registry / LFS blobs
    • CI-артефакты - артефакты и логи CI
    • Сайты - Pages деплойменты
  3. Опционально: включите инкрементальный режим (только изменённые файлы)
  4. Нажмите «Создать бэкап»

Бэкап создаётся асинхронно. Статус отображается в списке.

Формат

  • Архив: gitriver-backup-{дата-время}.tar.gz
  • Метаданные сохраняются рядом (состав, контрольная сумма SHA256, дата)

Шифрование

Для шифрования бэкапов задайте переменную окружения:

GITRIVER_BACKUP_ENCRYPTION_KEY=<base64-ключ-AES-256>

Скачивание

Нажмите кнопку «Скачать» в списке бэкапов. Для безопасности генерируется одноразовая ссылка с ограниченным временем жизни (по умолчанию 60 секунд).

Проверка целостности

Кнопка «Проверить» - сверяет SHA256 контрольную сумму архива с сохранённой в метаданных.

Восстановление

  1. Нажмите «Восстановить» напротив бэкапа
  2. Выберите компоненты для восстановления (каждый можно включить/выключить отдельно)
  3. Подтвердите действие

Расписание

Настройка автоматического резервного копирования: Администрирование / Резервное копирование / Расписание.

Решение проблем

Мастер настройки не появляется

Убедитесь, что database_url не указан в TOML и переменных окружения. Мастер запускается только при отсутствии подключения к БД.

JWT-ошибки после перезапуска

JWT-секрет хранится в файле .jwt_secret рядом с конфигом. Если файл удалён - все сессии станут недействительными.

CI-задачи не запускаются

  1. Docker socket доступен: -v /var/run/docker.sock:/var/run/docker.sock
  2. Пользователь gitriver в группе docker
  3. Проверьте ci_max_concurrent_jobs в конфигурации

Git push отклоняется

  • Проверьте защиту веток (Настройки / Защита веток)
  • Для LFS: установите client_max_body_size в nginx (минимум 512m)