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