Lifecycle и delivery

API проходит контролируемые состояния от разработки до вывода из эксплуатации. Ручная настройка в одном окружении не считается завершённой поставкой.

Рекомендуемый lifecycle

Фактические статусы должны соответствовать настроенному lifecycle WSO2. Переход в PUBLISHED требует доказательств, а не только действия в UI.

Publication gate

• OpenAPI review пройден;
• backend route доступен;
• security и scopes проверены;
• policies применены;
• direct/async/orchestrated flow протестирован;
• документация видна в Developer Portal;
• owner, support и rate limit указаны;
• rollback или disable procedure известна.

Новая версия

Создавайте новую major version при breaking change. Существующая опубликованная версия продолжает работать в течение согласованного migration window.

Новая версия не должна автоматически становиться default до проверки Consumer impact. Документируйте differences, migration steps и deprecation date.

API as Code

apictl используется для экспорта, версионирования и импорта API/API Product artifacts между окружениями. В репозитории хранятся безопасные артефакты и templates, а environment secrets подставляются pipeline-механизмом.

Promotion rules

• один и тот же versioned artifact продвигается вперёд;
• environment URLs, secrets и certificates не копируются из Dev;
• Stage/Prod поставка проходит через MTB GitLab и bank-side runners;
• pipeline сохраняет audit trail;
• после deployment выполняются smoke tests;
• failure приводит к остановке promotion или rollback.

Deprecation

Перед выводом версии:

1. определить replacement;
2. уведомить активных Consumers;
3. зафиксировать migration deadline;
4. контролировать остаточный трафик;
5. запретить новые subscriptions;
6. вывести версию только после согласованного gate.