73 lines
5.5 KiB
Markdown
73 lines
5.5 KiB
Markdown
# 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/`.
|