# Эксплуатация и грабли ## Предпочитаемые способы запуска На **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 ```