Files
specs/openspec/changes/versioned-deployment-bundle/proposal.md
T
ksv741 7f40372c3f
Conventional commits / commits (pull_request) Successful in 12s
Specs security / security (pull_request) Successful in 8s
Specs verify / verify (pull_request) Successful in 11s
Specs security / security (push) Successful in 7s
Specs verify / verify (push) Successful in 10s
spec: define versioned deployment bundle
2026-09-20 18:49:25 +03:00

2.9 KiB

Why

После выпуска компонентов оператор вручную выбирает совместимые версии и повторяет порядок обновления. Нужен один выбранный релиз всей установки и одна команда, сохраняющая данные и настройки существующего сервера.

What Changes

  • Версионируемый комплект закрепляет проверенную пару версий интерфейса и API.
  • Оператор явно выбирает релиз; публикация компонента не обновляет сервер.
  • Обновление выполняется одной командой с предварительными проверками, сохранением данных и диагностируемым результатом.
  • Обновление только интерфейса не прерывает работу API и не затрагивает базу.
  • Перед обновлением API создаётся согласованная резервная копия. Неудачное обновление не запускает автоматическое восстановление или откат.
  • Инструкция охватывает подготовку сервера, первую установку, подключение существующей установки, выпуск комплекта, обновление и ручное восстановление.

Non-goals: настройка серверной инфраструктуры командой развёртывания, автоматическое обновление по выходу компонента, непрерывная доступность, несколько экземпляров API, автоматическая очистка копий и внешнее backup-хранилище.

Capabilities

New Capabilities

  • specs/deployment-bundle/spec.md: выбор полного релиза, безопасная автоматизация обновления и сохранение существующей установки.

Modified Capabilities

Нет. Новый контракт дополняет контейнерную поставку; существующий active change containerized-application-delivery и его capability application-delivery не изменяются и не архивируются в рамках этой работы.

Impact

Основной пользователь — оператор одной установки WealthLedger. Изменяются комплект развёртывания, эксплуатационная документация и требования к обновлению. Прикладные функции интерфейса и API остаются прежними.