feat(ops): у волта Obsidian появился автоматический бэкап #3090

Merged

lekss361 merged 1 commit from feat/3057-couchdb-backup into main

2026-08-25 05:44:17 +00:00

lekss361 commented

2026-08-25 05:37:33 +00:00

Owner

Summary

У волта Obsidian (CouchDB) не было автоматического бэкапа вообще — Site Finder, МЕРА и Forgejo закрыты, CouchDB не закрывал никто. Единственная копия — ручной месячный прогон на машине владельца.
ops/backup-couchdb.sh: останавливает контейнер (документация CouchDB требует file-level копию с остановленного узла), архивирует оба тома, поднимает обратно, проверяет целостность, выгружает в S3, пишет сентинел.
Подъём висит на trap EXIT — остановленный и не поднятый волт хуже отсутствия бэкапа. После старта проверяется /_up, иначе notify().
S3 обязателен и проверяется до остановки контейнера. Отдельный ключ не требуется: при пустых COUCHDB_S3_* берутся S3_* основного бэкапа под своим префиксом couchdb/.
Фолбэк читается в подоболочке — прямой source затёр бы LOCAL_BACKUP_DIR / SENTINEL_FILE / KEEP и обновил бы сентинел основного бэкапа, ослепив его сторожа свежести.
ops/*.cron добавлен в paths deploy-infra.yml: строка была только в deploy.yml, и после разъезда хостов правка crontab-beget.cron не доезжала бы до хоста, где живёт волт.

Test plan

bash -n, YAML валиден
на боевом Beget: без S3-настроек → rc=1, контейнер не тронут (Up 12 hours)
на боевом Beget, полный прогон ×2: снимок данных 53 219 001 байт (15 файлов), конфиг 788 байт (3 файла), контейнер поднят и healthy, сентинел записан, весь прогон 103 с
изоляция подоболочки на подставном конфиге: S3-значения подхвачены, LOCAL_BACKUP_DIR / SENTINEL_FILE / KEEP не затёрты
владелец архивов после правки — gendesign:gendesign (был root:root)
объекты в бакете подтверждены независимым читающим ключом: couchdb/couchdb-data_*.tar.gz 50.8 MiB, couchdb/couchdb-config_*.tar.gz
на хосте: crontab /opt/gendesign/ops/crontab-beget.cron (запись 04:45 + сторож)

Refs #3057, #3085

## Summary - У волта Obsidian (CouchDB) **не было автоматического бэкапа вообще** — Site Finder, МЕРА и Forgejo закрыты, CouchDB не закрывал никто. Единственная копия — ручной месячный прогон на машине владельца. - `ops/backup-couchdb.sh`: останавливает контейнер (документация CouchDB требует file-level копию с остановленного узла), архивирует оба тома, поднимает обратно, проверяет целостность, выгружает в S3, пишет сентинел. - Подъём висит на `trap EXIT` — остановленный и не поднятый волт хуже отсутствия бэкапа. После старта проверяется `/_up`, иначе `notify()`. - S3 обязателен и проверяется **до** остановки контейнера. Отдельный ключ не требуется: при пустых `COUCHDB_S3_*` берутся `S3_*` основного бэкапа под своим префиксом `couchdb/`. - Фолбэк читается в подоболочке — прямой `source` затёр бы `LOCAL_BACKUP_DIR` / `SENTINEL_FILE` / `KEEP` и обновил бы сентинел **основного** бэкапа, ослепив его сторожа свежести. - `ops/*.cron` добавлен в `paths` `deploy-infra.yml`: строка была только в `deploy.yml`, и после разъезда хостов правка `crontab-beget.cron` не доезжала бы до хоста, где живёт волт. ## Test plan - [x] `bash -n`, YAML валиден - [x] на боевом Beget: без S3-настроек → rc=1, контейнер не тронут (`Up 12 hours`) - [x] на боевом Beget, полный прогон ×2: снимок данных 53 219 001 байт (15 файлов), конфиг 788 байт (3 файла), контейнер поднят и `healthy`, сентинел записан, весь прогон 103 с - [x] изоляция подоболочки на подставном конфиге: S3-значения подхвачены, `LOCAL_BACKUP_DIR` / `SENTINEL_FILE` / `KEEP` не затёрты - [x] владелец архивов после правки — `gendesign:gendesign` (был `root:root`) - [x] объекты в бакете подтверждены **независимым читающим ключом**: `couchdb/couchdb-data_*.tar.gz` 50.8 MiB, `couchdb/couchdb-config_*.tar.gz` - [ ] на хосте: `crontab /opt/gendesign/ops/crontab-beget.cron` (запись 04:45 + сторож) Refs #3057, #3085

Rows
Columns