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

91 lines
4.9 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.
# Эксплуатация и грабли
## Предпочитаемые способы запуска
На **RedOS-сервере** (текущий прод пользователя): Docker Compose, образ Alpine.
```bash
# .env с GITEA_TOKEN и верным GITEA_URL
sudo docker compose build --no-cache # после смены Dockerfile
sudo docker compose up -d
sudo docker compose logs -f
sudo docker exec gitea-backup gitea-backup list
```
Сеть контейнера: `network_mode: host`, чтобы достучаться до `192.168.1.9`.
На **машине без Docker**: `./install.sh`, токен в `.env`, `.venv/bin/gitea-backup run`, ежедневно `./install.sh --cron`.
На **Ubuntu/WSL**, если Compose болеет: `./docker-up.sh` делает `docker build` + `docker run` (имя контейнера `gitea-backup`, образ `gitea-backup:latest`). Не путать с именем образа, которое даёт compose: `gitea-daily-backup-gitea-backup:latest`.
## Docker: что уже ломалось у этого пользователя
Идти по списку сверху вниз, не ставить всё подряд.
1. **`unknown shorthand flag: 'd' in -d`**
Есть `docker`, нет плагина Compose.
`sudo apt install docker-compose-v2`
Проверка: `docker compose version` → `Docker Compose version v2.x`.
Запас: пакет `docker-compose` и команда через дефис.
2. **`permission denied ... docker.sock`**
Демон жив, пользователь не в группе `docker`.
Сейчас: `sudo docker compose …`
Навсегда: `sudo usermod -aG docker "$USER"` и новая сессия / `newgrp docker`.
3. **`Cannot connect to the Docker daemon` + `service docker: unrecognized service`**
Установлен только CLI, нет `dockerd`.
`sudo apt install docker.io containerd`
В WSL без systemd: в одном терминале `sudo dockerd`, в другом compose/run.
Docker Desktop на Windows — отдельный движок: его надо запустить и включить WSL integration.
4. **Сборка ок, `No such container: ac8d23cfcfca…`**
Compose помнит ID после рестарта `dockerd`. `compose down` / `--force-recreate` у пользователя **не помогли**. Обход: не compose, а `docker run` с уже собранным образом (см. README и `docker-up.sh`).
5. **`.dockerignore` и `*.md`**
Раньше `COPY README.md` падал: README не попадал в контекст. Правило `*.md` из dockerignore убрано. Не возвращать.
6. **Debian bookworm: `At least one invalid signature was encountered`**
На RedOS/RHEL это почти всегда старый `libseccomp` (syscall `faccessat2`) или кривые часы хоста, не «Debian unsigned».
**Решение в коде:** Dockerfile на `python:3.12-alpine` + `coreutils`.
После pull: `docker compose build --no-cache`.
Если Alpine тоже не качается: `dnf update libseccomp`, проверить `date`.
7. **Bake / buildx warning**
Можно игнорировать. `COMPOSE_BAKE=false` отключает.
8. **`git rev-parse --is-inside-work-tree` при сборке**
Каталог без `.git` (копия файлов). Безвредно.
## Wiki в логах
Gitea часто отдаёт `has_wiki: true` до первой страницы. Клон `owner/repo.wiki.git` тогда:
```
fatal: Could not read from remote repository.
```
Это не фейл git-репозитория. Код продолжает и пишет «Готово». С коммита про смягчение лога — уровень INFO, не WARNING. Отключить wiki: `BACKUP_INCLUDE_WIKI=false`.
## Токен
Gitea → Настройки → Приложения. Для **всех** реп, включая чужие приватные, нужен **админ сайта**. Права: `read:repository`, `read:user`, `read:organization`.
## WSL и ночной бэкап
Сессия WSL без окон часто засыпает. Cron внутри WSL ночью может не сработать. Прод логичнее держать на всегда включённом сервере (у пользователя — RedOS) или на самой машине Gitea.
## systemd
Юниты в `systemd/` заточены под `/opt/gitea-backup`. `install.sh --systemd` пишет user-units с реальными путями к текущему клону. На WSL user-systemd часто нет.
## Проверки после изменений
```bash
python -m unittest discover -s tests -v
# на проде:
docker compose logs --tail 100
# или
cat backups/status.json
```