Files
buryan-infra/docs/UPDATE-MANAGER-COVERAGE.md
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

5.7 KiB
Raw Permalink Blame History

Обновления: почему «не работало на многие сервисы»

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 — то же правило, что уже было в скрипте обновления. Напоминание себе: проверка должна знать те же правила, что и проверяемое.