7.3 KiB
Spec Delta
Purpose
Управлять lifecycle всего приложения через runtime-контракт, сохраняя entrypoint и HTTP host в приложении.
ADDED Requirements
Requirement: Запуск приложения
ID: RT.AL-01
Runtime SHALL запускать все зарегистрированные и не отключённые workers и предоставлять состояние запуска приложения.
Scenario: Запуск приложения
Участники
- Приложение, runtime PLBA2 и зарегистрированные workers.
Предусловия
- Workers зарегистрированы с уникальными именами.
- Приложение подключило runtime control API.
Основной поток
- Запрашиваем запуск приложения — runtime запускает workers, не отключённых в конфигурации, по RT.WK-01.FR-01.
- После запуска workers возвращаем
APPLICATION_STARTEDпо RT.AL-01.FR-01.
Альтернативы и ошибки
- Запуск одного или нескольких workers завершился ошибкой — возвращаем
APPLICATION_START_FAILED; состояние приложения становитсяfailed.
Результат
Lifecycle приложения и результат запуска workers доступны приложению.
Коды завершения
| Код | Смысл | Связанные FR |
|---|---|---|
APPLICATION_STARTED |
Все зарегистрированные и включённые workers запущены | RT.AL-01.FR-01 |
APPLICATION_START_FAILED |
Не удалось запустить один или несколько workers | RT.AL-01.FR-01 |
Функциональные требования
RT.AL-01.FR-01: Запуск и состояния приложения
При запуске runtime переводит приложение в starting, запускает зарегистрированные workers, у которых workers.<worker_name>.disabled отсутствует или равно false, по их контракту и переводит приложение в running после их успешного старта. Ошибка запуска переводит lifecycle в failed. Состояния приложения: new, starting, running, stopping, stopped и failed.
| Код | Текст сообщения | Дальнейшее поведение |
|---|---|---|
APPLICATION_STARTED |
Сообщение отсутствует | Приложение доступно для control operations |
APPLICATION_START_FAILED |
Сообщение отсутствует; исходная ошибка доступна приложению | Lifecycle приложения остаётся failed |
Requirement: Остановка приложения
ID: RT.AL-02
Runtime SHALL останавливать все workers приложения в graceful или принудительном режиме и предоставлять актуальный lifecycle status.
Scenario: Остановка приложения
Участники
- Клиент control API, runtime PLBA2, supervisor и зарегистрированные workers.
Предусловия
- Приложение запущено и его workers зарегистрированы.
Основной поток
- Запрашиваем остановку приложения с выбранным режимом — runtime останавливает workers по RT.AL-02.FR-01.
- Дожидаемся завершения workers и возвращаем
APPLICATION_STOPPEDпо RT.AL-02.FR-02.
Альтернативы и ошибки
- Истёк заданный timeout ожидания — возвращаем status
stoppingиAPPLICATION_STOPPING; runtime продолжает остановку по RT.AL-02.FR-02.
Результат
Lifecycle становится stopped только после остановки всех workers.
Коды завершения
| Код | Смысл | Связанные FR |
|---|---|---|
APPLICATION_STOPPED |
Все workers приложения остановлены | RT.AL-02.FR-02 |
APPLICATION_STOPPING |
Остановка продолжается после завершения ожидания API | RT.AL-02.FR-02 |
Функциональные требования
RT.AL-02.FR-01: Режимы остановки приложения
По умолчанию runtime запрашивает graceful stop у всех workers: каждый worker завершает активный цикл и не начинает следующий. При force=true runtime принудительно прерывает активную обработку workers. После любого режима новые циклы не запускаются.
RT.AL-02.FR-02: Ожидание и статус остановки
Положительный необязательный timeout_seconds ограничивает только ожидание ответа на запрос остановки. Если timeout отсутствует, runtime ждёт завершения всех workers без ограничения по времени. По истечении timeout runtime возвращает status stopping, продолжая остановку в фоне; timeout не включает принудительный режим. Lifecycle становится stopped, когда supervisor подтвердил остановку всех workers по RT.WK-02.FR-02. Health aggregator возвращает stopped по HL.AG-01.FR-01. Runtime не завершает принадлежащий приложению OS process или HTTP host; их остановка остаётся решением приложения.
| Код | Текст сообщения | Дальнейшее поведение |
|---|---|---|
APPLICATION_STOPPED |
Сообщение отсутствует | Runtime фиксирует lifecycle stopped |
APPLICATION_STOPPING |
Сообщение отсутствует; lifecycle доступен в status | Runtime продолжает остановку workers |