Files
2026-11-08 17:06:04 +03:00

5.5 KiB
Raw Permalink Blame History

Handoff: gitea-daily-backup

Дата снимка: 2026-10-31 (Europe/Moscow). Ветка: main (последний коммит fix: не пугаю WARNING, если wiki в Gitea ещё не создана).

Задача пользователя

Есть локальный Gitea на 192.168.1.9. Нужен ежедневный бэкап всех репозиториев.

Это сделано. Проект — Python-CLI gitea-backup + Docker (Alpine) / venv+cron / systemd.

Кто и где это крутит

  • Пользователь: Max Pro. Десктоп Windows, сначала пробовал в WSL (max@SheinovM:~/gitea-daily-backup).
  • Потом перенёс на сервер RedOS (root@redos) и там поднял docker compose. Это текущий прод, насколько известно из чата.
  • Gitea в LAN: 192.168.1.9. В .env.example порт :3000, но в боевых логах clone URL без порта (http://oauth2:***@192.168.1.9/Matvey/ChatService.git) — на проде Gitea, скорее всего, на 80 (nginx) или в GITEA_URL указан хост без порта. Главное: clone с того URL, что отдаёт API, работает.

Публичное имя репозитория кода: max-pro/gitea-daily-backup (Origin, private).
Страница: https://cursor.com/codebase/max-pro/gitea-daily-backup

Что считается «готово»

  • Список репозиториев через Gitea API (search + user + orgs + admin users, без дублей).
  • git clone --mirror / дальше git fetch --all --prune --tags.
  • Git LFS (git lfs fetch --all), если включено.
  • Wiki (.wiki.git), если Gitea отдала has_wiki и git-репозиторий wiki реально существует.
  • Ежедневные снимки cp -al (hardlink) с хранением BACKUP_KEEP_DAYS (сейчас 30).
  • status.json после прогона, flock чтобы два бэкапа не пересеклись.
  • Демон gitea-backup schedule: сразу при старте (RUN_ON_START=true) и каждый день в BACKUP_AT (03:00, TZ=Europe/Moscow).
  • Docker-образ CMD ["schedule"].

Чего в бэкапе нет (и это сознательно)

Тикеты, PR, пользователи, настройки инстанса — это БД Gitea. Для полного дампа на самом сервере Gitea: gitea dump. Пользователь просил репозитории.

Последний подтверждённый прогон

Лог с RedOS (контейнер gitea-backup), репозиторий Matvey/ChatService:

  • fetch --all --prune --tags — зеркало уже было, инкремент ок.
  • lfs fetch --all — ок.
  • Клон ChatService.wiki.git упал: wiki в настройках включена, git-репо wiki не создано (нет страниц). Код это пропускает, пишет «Готово: Matvey/ChatService».
  • Пользователь спросил, нормально ли это. Ответ: да, код в порядке. После этого смягчили лог (INFO вместо WARNING для «wiki ещё нет»). На проде этот коммит мог быть ещё не задеплоен — если виден старый WARNING, это тот же самый безобидный случай.

Проверка зеркала:

git -C backups/mirrors/<owner>/<repo>.git rev-list --all --count
git -C backups/mirrors/<owner>/<repo>.git fsck

В objects/ у зеркала часто только info/ и pack/ — так и должно быть у --mirror.

На чём остановились

  1. Прод на RedOS через Docker работает, бэкап репозиториев идёт.
  2. Пользователь попросил документацию для следующего агента (этот каталог). Других фич в очереди нет.
  3. WSL-путь с Docker у пользователя был мучительный (нет демона, нет compose-плагина, permission denied, призрак контейнера). На RedOS compose уже собрал Alpine-образ. Предпочитать то, что работает на текущей машине.
  4. Не делали: алерты, UI, бэкап БД Gitea, restore-playbook сверх git clone из зеркала, CI.

Если продолжать работу — разумные следующие шаги (не запрошены)

  • Убедиться, что на RedOS после git pull пересобран Alpine-образ (docker compose build --no-cache один раз после смены Dockerfile).
  • Если wiki не нужны: BACKUP_INCLUDE_WIKI=false.
  • Restore-инструкция / проверка status.json после ночного прогона.
  • Если понадобится полный инстанс: документировать gitea dump на 192.168.1.9, это другой инструмент.

Правила репозитория

  • Коммиты на русском, формат тип: описание.
  • PR не создавать, пока пользователь не попросил.
  • Отвечать пользователю по-русски.
  • Не коммитить .env и backups/.