Перейти к содержанию

Релиз 0.11.3

Дата выхода: 21 октября 2026.

Релиз 0.11.3 — про эксплуатацию Synth: метрики и готовность инстанса, единый слой доверия к сети, поставка в закрытый контур, отчётность и переработанное окно настроек. Ниже — что изменилось для пользователя и для администратора.

Что входит в релиз

В заметки включены все изменения после версии 0.10.1. Полный список коммитов и исправлений — в релизах репозитория (зеркало GitVerse: gitverse.ru/itphx/synth/releases).

Наблюдаемость и метрики

  • Экспорт метрик Prometheus. Инстанс отдаёт /metrics в формате Prometheus 0.0.4. По умолчанию выключено; включается в конфиге (metrics.enabled) или переменной SYNTH_METRICS_ENABLED.
  • Готовность и живость. /ready сообщает состояние хранилища и версию, /health остаётся проверкой живости сервиса.
  • Дашборды и алерты. Helm-чарт поставляет Grafana-дашборды и правила алертов, а /metrics можно вынести на отдельный Ingress.
  • Управление из интерфейса. В админке появился раздел «Метрики»: статус экспорта, тумблер включения и write-only токен доступа к /metrics.

Настройки — в разделе Конфигурация.

Сеть: адресная политика, доверие TLS и прокси

  • Политика адресов. Списки разрешённых и запрещённых адресов с исключениями применяются ко всем исходящим запросам. Проверка URL работает офлайн — без самого запроса к цели.
  • Единый источник доверия TLS/CA. CA-бандл и клиентские сертификаты настраиваются в одном месте и применяются ко всем исходящим соединениям; для отдельных хостов задаются свои профили.
  • Прокси с профилями и host-правилами. HTTP, HTTPS и SOCKS5, аутентификация Basic, TLS/mTLS к прокси, список noProxy. Правила выбирают профиль по хосту: первое совпадение побеждает.
  • Раздел «Сеть». Настройки TLS и прокси вынесены из встроенных инструментов в отдельный раздел настроек.

Там же — защита периметра: единая политика исходящих запросов, проверка доступа к сессии на границе API, CSP для интерфейса и ограничение размера загружаемого файла.

Подробнее — Конфигурация и Безопасность.

Закрытый контур: portable-бандлы и multi-arch образы

  • Portable-бандлы для Linux, macOS и Windows: встроенный Node.js, установщик и bin/synth — установка без npm-реестра и без интернета.
  • Multi-arch образы (amd64 и arm64) и готовые архивы для docker load — образы собираются под несколько архитектур сразу.
  • Режим API-key без Keycloak в Helm-чарте — для контуров, где OIDC не нужен.

Подробнее — Закрытый контур / Offline и Docker.

Хранение и обслуживание инстанса

  • PostgreSQL как хранилище. Файловый бэкенд остаётся по умолчанию, но появился опциональный драйвер PostgreSQL: выбор — storage.backend (file | memory | postgres), перенос данных — synth storage migrate.
  • Деградация без потери доступа. Если база недоступна, инстанс уходит в безопасный режим: storage.degradedMode задаёт поведение (fallback-file или halt), а вернуться в нормальный режим можно только перезапуском.
  • Бэкап, восстановление и диагностика. synth backup / synth restore (с шифрованием архива), synth doctor и раздел «Обслуживание» в админке.
  • Перенос проекта. Портативный экспорт и импорт проекта — из CLI и по HTTP API.

Аналитика и отчётность

  • Суточные отчёты по использованию, активности и решениям агентов.
  • Экспорт в CSV и JSON.
  • Роли. ADMIN и LEAD видят сводку по инстансу, AUDITOR — читает, USER — только свои строки.

Публичный API, внешние события и автоматизация

Сервисные ключи со scopes и проектной проекцией, исходящие webhooks и публичный OpenAPI с типизированным SDK доступны начиная с 0.10. В 0.11.3 этот контур доведён:

  • ключи сервисов и ключи привязок переносятся вместе с данными при переходе на PostgreSQL;
  • внешние сессии в standalone получают локального владельца, а уведомление о новых сессиях приходит в хаб подписчиков;
  • изменения общеинстансных настроек оставлены за ролью ADMIN.

Подробнее — Публичный API и интеграции, События и автоматизация и Расписания.

Интерфейс

  • Окно настроек переработано: группы, поиск по настройкам, подсказки к полям.
  • Единая высота контролов — 30 px на десктопе и 40 px на сенсорных экранах.
  • Адаптивность и PWA сохранены, дизайн-система и темы — без изменений.

Подробнее — Дизайн-система и темы и Мобильный интерфейс и PWA.

Как обновиться

Релиз не требует ручной правки конфигурации. Порядок зависит от способа установки:

npm install -g @itphx/synth@latest
synth --version

docker pull gitverse.ru/itphx/synth:0.11.3
docker rm -f synth
# затем запустите контейнер заново

Тома с данными не затрагиваются — история и настройки сохраняются.

helm upgrade synth synth/synth -f my-values.yaml --namespace synth

Данные backend хранятся на PVC и переживают обновление.

Обновление — не synth update (команда обращается к npm-реестру), а замена бандля: остановить сервис, распаковать новую версию, выполнить synth migrate --yes, запустить и проверить.

Проверка после обновления

Убедитесь, что инстанс отвечает на /ready, а интерфейс открывается без ошибок. Если обновление идёт на версии с PostgreSQL, заранее проверьте доступность базы и режим деградации.

Подробнее — FAQ, Docker, Kubernetes / Helm и Эксплуатация (офлайн).

Что дальше