Skip to content

Бэкап: сделать архив самодостаточным для восстановления (.env, compose, конфиг фронта) + restore #133

Open

Description

@Buzzer107

Привет!

Дата-центры сейчас довольно уязвимы, и даже если у админа есть бэкап, созданный панелью, доступа к самому серверу может уже не быть — а значит .env, docker-compose*.yml и конфиг фронта достать неоткуда. Без них дамп базы — половина пазла: панель поднимется, но без ENCRYPTION_KEY из .env не расшифрует SSH-креды нод, без compose-файла не соберётся стек, без конфига фронта не поднимется фронт. Сам недавно прогонял восстановление при переезде на другой хостинг — панель поднялась, но файлы окружения собирал по старым бекапам самих файлов и потом ещё пару раз к этому возвращался. Хочется, чтобы архив был самодостаточным.

Что сейчас

Архив панели — логический дамп базы (mongodump). Основа правильная, но для восстановления на новом сервере руками приходится собирать:

  1. .env — PANEL_DOMAIN, ENCRYPTION_KEY, SESSION_SECRET, MONGO_USER/PASSWORD, UPDATER_SECRET, ACME_EMAIL. Без того же ENCRYPTION_KEY панель не расшифрует зашифрованные поля (SSH-креды нод, токены);
  2. docker-compose*.yml — стек (backend/mongo/redis/updater), у нас docker-compose.hub.yml;
  3. Конфиг фронта — /etc/caddy/Caddyfile для хостового Caddy, смонтированный конфиг для контейнерного, nginx.conf для Nginx.

Сценарий реальный: ДЦ погиб полностью, сервер недоступен, есть только вчерашний архив в облаке. Восстановление возможно, но это сборка пазла по памяти.

Расширяем состав архива

При создании архива (Дашборд → Бэкап → Скачать) дополнительно собирать:

  1. .env из директории стека (для Docker-инсталляций обычно лежит рядом с docker-compose*.yml);
  2. сам docker-compose*.yml — все найденные в директории стека варианты;
  3. Конфиг фронта, если найден: /etc/caddy/Caddyfile (хостовой Caddy), Caddyfile/nginx.conf в папке стека (контейнерный), nginx.conf из /etc/nginx/ (Nginx).

Опционально чекбокс «включить хостовые файлы» — на случай, если оператор не хочет тащить .env в архив, который уедет в облако/S3.

Про шифрование — вижу три варианта:

  1. Пароль админа панели — привычно, ничего нового запоминать не надо; минус: сменил пароль после создания архива — архив не расшифруешь;
  2. Отдельный пароль архива — безопаснее, но его надо ещё сохранить;
  3. Чекбокс «зашифровать архив» + поле пароля; не задан — архив без шифрования.

На ваш выбор, как проще по архитектуре. Шифровать логично именно файлы окружения, дамп можно оставить как есть — админ сам решает, куда его класть.

Restore при первичной настройке

Кнопка на первом экране визарда (на пустой БД): если визард не предлагает восстановление из архива — добавить, чтобы не требовалось создавать фиктивного админа ради попадания на страницу Бэкапов. В UI восстановление уже есть (Бэкап → Restore БД) — не хватает именно стартовой точки до создания пользователя.

Сноска под кнопкой:

Распакуйте архив, положите .env и docker-compose*.yml в директорию стека, конфиг фронта — в /etc/caddy/ (или /etc/nginx/), перезапустите докер, войдите в панель. Затем загрузите этот же архив сюда — панель сверит состав, запросит пароль, восстановит базу и подчистит за собой.

Логика после загрузки:

  1. Проверка версии архива, если хранятся метаданные: архив от старой версии — предупреждение «архив от версии X, возможны проблемы, продолжить?»;
  2. Запрос пароля, если архив зашифрован;
  3. Сверка .env и docker-compose*.yml с базовым шаблоном: если в архиве поля заполнены или добавлены новые относительно свежеустановленного — считаем архив валидным, это защита от «закинул не тот файл»;
  4. Восстановление базы (mongorestore). Вложенные .env/.yml/конфиг фронта панель сама не применяет — она не должна переписывать окружение контейнера и хостовой Caddy, оператор уже положил их руками по инструкции выше. Временные копии после успешного деплоя удаляются, чтобы секреты не валялись в файловой системе панели;
  5. Готово: админ логинится — юзеры, ноды, каскады и правила на месте.

Почему это безопасно

  1. Пароль админа и так ключ чувствительных операций (при обновлении запрашивается) — переиспользуем привычный механизм, ничего нового запоминать не надо;
  2. Вложенные файлы панель сама не применяет, оператор кладёт руками — границы не нарушаются;
  3. Временные копии удаляются после деплоя — секреты не остаются в файловой системе панели.

Future:

В целом если есть вариант такой DR-пакет просто при стартовом визарде подгрузить, а панель сама раскинет все файлы по нужным директориям с нужными правами, а при перезапуске docker compose down && docker compose up -d всё применится, будет полная автоматизация без участия пользователя, что в духе панели, прекрасно раскрывающей механизмы установки нод, с откатами при фронте, при обновлениях и восстановлением работоспособности без ошибок)

Спасибо Вам за панель, день ото дня краше!

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions