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

41 lines
2.9 KiB
Markdown

## 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 остаются прежними.