Files
2026-11-08 17:06:04 +03:00

4.9 KiB
Raw Permalink Blame History

Эксплуатация и грабли

Предпочитаемые способы запуска

На RedOS-сервере (текущий прод пользователя): Docker Compose, образ Alpine.

# .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 часто нет.

Проверки после изменений

python -m unittest discover -s tests -v
# на проде:
docker compose logs --tail 100
# или
cat backups/status.json