Files
gitea-daily-backup/docs/agent/HANDOFF.md
T
2026-11-08 17:06:04 +03:00

73 lines
5.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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, это тот же самый безобидный случай.
Проверка зеркала:
```bash
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/`.