Files
buryan-infra/docs/UPDATE-MANAGER-COVERAGE.md
T
root 915de56603 Обновления из бота: реестр расширен с 28 до 50 служб
Жалоба владельца: обновление из бота не работает на многие сервисы.
Проверил — причина простая: скрипт работает только по реестру
services.yaml, а в нём было 28 служб при 97 работающих контейнерах.

НЕ ОБНОВЛЯЛИСЬ (22 службы), в том числе важные:
  adguard (DNS всего дома), loki (журналы), alertmanager (тревоги),
  mautrix-telegram (мост в Telegram), livekit (звонки), homeassistant,
  nextcloud, duplicati (копии), firefly, paperless в CT 110,
  nats, swarm-redis, element-web, coturn, zigbee2mqtt, mosquitto.

ЧТО СДЕЛАНО:
1. Добавлены все 22 службы. В реестре теперь 50.
2. Каждый адрес проверки здоровья проверен вручную перед записью.
   Правило жёсткое: адрес добавляется только если реально отвечает.
   Неверный адрес хуже отсутствующего — скрипт счёл бы службу сломанной
   и ОТКАТИЛ исправное обновление.
3. Службы с паролем не потеряли проверку: adguard и paperless-web
   ответили 401, я сначала убрал у них проверку — это было неправильно,
   401 означает ЖИВУЮ службу. Вернул с флагом auth_required.
4. ИСПРАВЛЕНА ОШИБКА В САМОМ СКРИПТЕ: если контейнер создан вручную и
   метки compose у него нет, скрипт запускал «docker compose up -d» БЕЗ
   имени службы — то есть пересоздавал весь проект вместе с соседями.
   Для /opt/smart-lxc это значило: обновляя homeassistant, он пересоздал
   бы ещё mosquitto и zigbee2mqtt. Теперь служба ищется в compose-файле
   по container_name. Проверено на homeassistant.

ПРОВЕРКА: добавлен validate-registry.sh — для каждой службы проверяет,
что контейнер существует, каталог compose на месте, адрес здоровья
отвечает ожидаемым кодом.
  служб в реестре: 50, полностью обновляемы: 49.

ОСТАЛОСЬ ОГРАНИЧЕНИЕМ (честно):
  * openclaw — контейнер снят сегодня (падал, диск был полон), ждёт
    решения владельца;
  * duplicati, alertmanager, buryan-alert-webhook — работают БЕЗ compose:
    скрипт скачает образ, но пересоздать контейнер не сможет и скажет
    об этом прямо, а не изобразит успех;
  * mosquitto/redis/nats/coturn — порты не HTTP, проверки здоровья нет;
  * 12 контейнеров oauth2-proxy-* не внесены: вспомогательные.

МОЯ ОШИБКА В ПРОВЕРКЕ: первая версия дала 6 ложных тревог, считая
401/403 сбоем. Пришлось учитывать auth_required — то же правило, что уже
было в скрипте обновления. Урок: проверка должна знать те же правила,
что и проверяемое.

РЕШЕНИЕ ВЛАДЕЛЬЦА УЧТЕНО: postgres-rbac не трогаем.
2026-10-17 12:36:43 +03:00

91 lines
5.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Обновления: почему «не работало на многие сервисы»
**17.10.2026.** Жалоба владельца: обновление из бота работает не для всех
служб. Проверил — и причина оказалась простой и обидной.
## Причина
Скрипт обновления (`safe-update.sh`) работает **только по реестру**
`ops/update-manager/services.yaml`. Если службы нет в реестре, скрипт
честно отказывается: «сервис не найден в реестре».
**А в реестре было 28 служб при 97 работающих контейнерах.**
То есть почти две трети хозяйства обновить из бота было нельзя — не
из-за поломки, а из-за неполного списка.
## Что было не покрыто
Проверка нашла 22 службы, которых в реестре не было:
| CT | Службы |
|---|---|
| 105 | `paperless_redis_files` |
| 106 | **homeassistant**, mosquitto, zigbee2mqtt — умный дом целиком |
| 107 | **adguard** — DNS всего дома |
| 108 | tg-admin-bot |
| 109 | **nextcloud**, files_db |
| 110 | firefly, paperless_web, paperless_worker, paperless_redis_office |
| 111 | **duplicati** — резервные копии |
| 113 | **loki** — сбор журналов |
| 115 | nats, swarm-redis |
| 134 | **alertmanager**, buryan-alert-webhook |
| 155 | **mautrix-telegram**, element-web, **livekit**, matrix-coturn |
Особенно заметно: не обновлялись **adguard** (без него домен не
разрешается), **loki** и **alertmanager** (без них нет журналов и
тревог), **mautrix-telegram** (мост в Telegram) и **livekit** (звонки).
## Что сделано
1. **Добавлены все 22 службы.** В реестре теперь **50**.
2. **Адреса проверки здоровья проверены по одному** перед записью.
Правило было жёсткое: адрес добавляется только если реально отвечает.
Неверный адрес хуже отсутствующего — скрипт посчитает службу сломанной
и **откатит** исправное обновление.
3. **Службы с паролем не потеряли проверку.** AdGuard и paperless-web
ответили `401`. Первая версия проверки сочла это сбоем, и я убрал
проверку — это было неправильно: `401` означает **живую** службу.
Вернул проверку с флагом `auth_required: true`: скрипт знает, что
`401` для таких служб — норма.
4. **Исправлена ошибка в самом скрипте.** Если контейнер создан вручную
(`docker run`) и метки compose у него нет, скрипт запускал
`docker compose up -d` **без имени службы** — то есть пересоздавал весь
проект вместе с соседями. Для `/opt/smart-lxc` это значит: обновляя
homeassistant, он пересоздал бы ещё mosquitto и zigbee2mqtt.
Теперь, если метки нет, скрипт ищет службу в compose-файле по
`container_name`. Проверено на homeassistant: служба определяется.
## Результат проверки
```
служб в реестре: 50
полностью обновляемы: 49
с известным ограничением: 1
```
Проверка идёт по трём пунктам для каждой службы: контейнер существует,
каталог compose существует, адрес здоровья отвечает ожидаемым кодом.
Скрипт проверки: `ops/update-manager/validate-registry.sh`.
## Что осталось ограничением (честно)
| Служба | Ограничение |
|---|---|
| `openclaw` | контейнер снят 17.10 (падал, диск был полон). Ждёт решения владельца: переименовать работающий `openclaw-old` или поднять заново |
| `duplicati`, `alertmanager`, `buryan-alert-webhook` | работают **без compose** (запущены вручную). Скрипт скачает новый образ, но пересоздать контейнер не сможет — скажет об этом прямо, а не изобразит успех |
| mosquitto, redis, nats, coturn | порты не HTTP, проверки здоровья нет — скрипт её пропускает |
| `oauth2-proxy-*` (12 штук) | не внесены: это вспомогательные прокси, обновляются вместе с основным стеком |
## Моя ошибка в проверке
Первая версия проверки дала **6 ложных тревог**: она считала `401` и
`403` сбоем. На деле это ответы служб, требующих пароль. Пришлось
учитывать `auth_required` — то же правило, что уже было в скрипте
обновления. Напоминание себе: проверка должна знать те же правила, что и
проверяемое.