5.5 KiB
5.5 KiB
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.
На чём остановились
- Прод на RedOS через Docker работает, бэкап репозиториев идёт.
- Пользователь попросил документацию для следующего агента (этот каталог). Других фич в очереди нет.
- WSL-путь с Docker у пользователя был мучительный (нет демона, нет compose-плагина, permission denied, призрак контейнера). На RedOS compose уже собрал Alpine-образ. Предпочитать то, что работает на текущей машине.
- Не делали: алерты, 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/.