PLBA2-2. Архивация спек
This commit is contained in:
+106
@@ -0,0 +1,106 @@
|
||||
# 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.
|
||||
|
||||
##### Основной поток
|
||||
|
||||
1. Запрашиваем запуск приложения — runtime запускает workers, не отключённых в конфигурации, по [RT.WK-01.FR-01](../worker/spec.md#rtwk-01fr-01-имя-состояния-и-управление-worker).
|
||||
2. После запуска workers возвращаем `APPLICATION_STARTED` по [RT.AL-01.FR-01](#rtal-01fr-01-запуск-и-состояния-приложения).
|
||||
|
||||
##### Альтернативы и ошибки
|
||||
|
||||
- Запуск одного или нескольких workers завершился ошибкой — возвращаем `APPLICATION_START_FAILED`; состояние приложения становится `failed`.
|
||||
|
||||
##### Результат
|
||||
|
||||
Lifecycle приложения и результат запуска workers доступны приложению.
|
||||
|
||||
##### Коды завершения
|
||||
|
||||
| Код | Смысл | Связанные FR |
|
||||
| --- | --- | --- |
|
||||
| `APPLICATION_STARTED` | Все зарегистрированные и включённые workers запущены | [RT.AL-01.FR-01](#rtal-01fr-01-запуск-и-состояния-приложения) |
|
||||
| `APPLICATION_START_FAILED` | Не удалось запустить один или несколько workers | [RT.AL-01.FR-01](#rtal-01fr-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 зарегистрированы.
|
||||
|
||||
##### Основной поток
|
||||
|
||||
1. Запрашиваем остановку приложения с выбранным режимом — runtime останавливает workers по [RT.AL-02.FR-01](#rtal-02fr-01-режимы-остановки-приложения).
|
||||
2. Дожидаемся завершения workers и возвращаем `APPLICATION_STOPPED` по [RT.AL-02.FR-02](#rtal-02fr-02-ожидание-и-статус-остановки).
|
||||
|
||||
##### Альтернативы и ошибки
|
||||
|
||||
- Истёк заданный timeout ожидания — возвращаем status `stopping` и `APPLICATION_STOPPING`; runtime продолжает остановку по [RT.AL-02.FR-02](#rtal-02fr-02-ожидание-и-статус-остановки).
|
||||
|
||||
##### Результат
|
||||
|
||||
Lifecycle становится `stopped` только после остановки всех workers.
|
||||
|
||||
##### Коды завершения
|
||||
|
||||
| Код | Смысл | Связанные FR |
|
||||
| --- | --- | --- |
|
||||
| `APPLICATION_STOPPED` | Все workers приложения остановлены | [RT.AL-02.FR-02](#rtal-02fr-02-ожидание-и-статус-остановки) |
|
||||
| `APPLICATION_STOPPING` | Остановка продолжается после завершения ожидания API | [RT.AL-02.FR-02](#rtal-02fr-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](../worker/spec.md#rtwk-02fr-02-результат-остановки-группы). Health aggregator возвращает `stopped` по [HL.AG-01.FR-01](../../health/aggregation/spec.md#hlag-01fr-01-состав-и-приоритет-статусов). Runtime не завершает принадлежащий приложению OS process или HTTP host; их остановка остаётся решением приложения.
|
||||
|
||||
| Код | Текст сообщения | Дальнейшее поведение |
|
||||
| --- | --- | --- |
|
||||
| `APPLICATION_STOPPED` | Сообщение отсутствует | Runtime фиксирует lifecycle `stopped` |
|
||||
| `APPLICATION_STOPPING` | Сообщение отсутствует; lifecycle доступен в status | Runtime продолжает остановку workers |
|
||||
Reference in New Issue
Block a user