init repo

This commit is contained in:
SheinovM committed 2026-11-08 17:06:04 +03:00
commit 6c63a20d8d
24 files changed
+2010

No files matched your search

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