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

59 lines
3.5 KiB
Markdown

# История работы (для контекста, не для повторения)
Проект создан с нуля в пустом репозитории. Пользователь с самого начала на русском, коммиты тоже.
## Хронология
1. **Запрос:** ежедневный бэкап всех репозиториев Gitea `192.168.1.9`.
Сделан Python-пакет: API → mirror → снимки, Docker Compose, systemd, README.
2. **`.env.example`:** `BACKUP_KEEP_DAYS` 14 → 30 (правка пользователя в diff-tab).
3. **«docker: command not found»** в WSL.
Добавлены `install.sh` (venv/cron) и запуск без Docker как основной путь в README. `BACKUP_DIR` по умолчанию `./backups`.
4. Пользователь всё же захотел Docker. Дальше серия чисто инфраструктурных сбоев на Ubuntu/WSL, не багов бэкапа:
- нет плагина Compose (`-d` уходит в `docker`);
- нет прав на `docker.sock`;
- нет `dockerd` / `service docker unrecognized`;
- README.md выкинут `.dockerignore`;
- призрак контейнера Compose после ручного `dockerd`.
`docker-up.sh` в итоге **не полагается на compose up**: `docker build` + `docker run`.
5. Проект **перенесён на RedOS**. Сборка Debian-slim упала на GPG apt. Dockerfile сменён на Alpine.
6. Пользователь прислал лог успешного fetch `Matvey/ChatService` и WARNING wiki. Подтверждено, что это норма; лог wiki смягчён.
7. Запрос: описание проекта/архитектуры для другого агента → этот каталог `docs/agent/`.
## Решения, которые нельзя откатывать без причины
| Решение | Почему |
|---|---|
| Mirror, не `gitea dump` | Просили репозитории, не всю инстанцию |
| Token в URL `oauth2:token@host` | HTTP clone приватных реп |
| `network_mode: host` | Gitea в LAN, не в Docker-сети |
| Alpine-образ | Debian apt на RedOS/старом seccomp лжёт про подписи |
| `coreutils` в Alpine | `cp -al` для дешёвых снимков |
| Wiki-ошибка ≠ fail backup | `has_wiki` не значит, что `.wiki.git` существует |
| Не веб-UI | Это джоба, не продукт с экраном |
## Коммиты на `main` (порядок)
```
feat: добавил ежедневный бэкап всех репозиториев Gitea
chore: увеличил срок хранения снимков до 30 дней
feat: добавил запуск бэкапа без Docker
fix: починил запуск через Docker Compose
docs: описал ошибку permission denied к docker.sock
fix: вернул README.md в Docker-контекст
docs: описал запуск демона Docker в WSL
fix: ставим и запускаем dockerd, а не только CLI
fix: пересоздаю контейнер после перезапуска dockerd
fix: запускаю бэкап через docker run, минуя сломанный Compose
fix: собираю образ на Alpine вместо Debian
fix: не пугаю WARNING, если wiki в Gitea ещё не создана
```