4.9 KiB
Эксплуатация и грабли
Предпочитаемые способы запуска
На 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: что уже ломалось у этого пользователя
Идти по списку сверху вниз, не ставить всё подряд.
-
unknown shorthand flag: 'd' in -d
Естьdocker, нет плагина Compose.
sudo apt install docker-compose-v2
Проверка:docker compose version→Docker Compose version v2.x.
Запас: пакетdocker-composeи команда через дефис. -
permission denied ... docker.sock
Демон жив, пользователь не в группеdocker.
Сейчас:sudo docker compose …
Навсегда:sudo usermod -aG docker "$USER"и новая сессия /newgrp docker. -
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. -
Сборка ок,
No such container: ac8d23cfcfca…
Compose помнит ID после рестартаdockerd.compose down/--force-recreateу пользователя не помогли. Обход: не compose, аdocker runс уже собранным образом (см. README иdocker-up.sh). -
.dockerignoreи*.md
РаньшеCOPY README.mdпадал: README не попадал в контекст. Правило*.mdиз dockerignore убрано. Не возвращать. -
Debian bookworm:
At least one invalid signature was encountered
На RedOS/RHEL это почти всегда старыйlibseccomp(syscallfaccessat2) или кривые часы хоста, не «Debian unsigned».
Решение в коде: Dockerfile наpython:3.12-alpine+coreutils.
После pull:docker compose build --no-cache.
Если Alpine тоже не качается:dnf update libseccomp, проверитьdate. -
Bake / buildx warning
Можно игнорировать.COMPOSE_BAKE=falseотключает. -
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