Config Parameters synced

This commit is contained in:
Alexey
2026-11-07 23:06:12 +03:00
parent c42ef876be
commit 82baf0dda4
3 changed files with 46 additions and 11 deletions
+17 -4
View File
@@ -2228,10 +2228,23 @@ Generationsreload übernimmt `whitelist`, `gray_action`, `auth_header`,
`enabled`, `listen` und `runtime_edge_events_capacity` erfordern einen
Neustart des Prozesses.
Ändern Sie die zuständige TOML-Datei und rufen Sie für Felder, die ein
Generationsreload übernehmen kann, `POST /v1/system/reload` auf.
`PATCH /v1/config` erlaubt unter `server` derzeit nur `server.listeners` und
kann `server.api.*` nicht ändern. `GET /v1/config/schema` beschreibt für jedes
`GET /v1/config`, `PATCH /v1/config` und `POST /v1/config/validate` stellen unter
`server.api` nur `minimal_runtime_enabled`, `minimal_runtime_cache_ttl_ms`,
`runtime_edge_enabled`, `runtime_edge_cache_ttl_ms` und `runtime_edge_top_n`
bereit, zusätzlich zu `server.listeners`. GET enthält die Standardwerte;
PATCH erhält benachbarte API-Einstellungen. Beide TTLs erlauben `0..60000` ms
(`0` deaktiviert das Caching), top-N erlaubt `1..1000`. Ausgelassene Felder und
zulässige Felder mit `null` behalten ihre Werte. Verbotene Felder werden auch
bei `null` abgelehnt. Ein server-Patch ohne konkreten bearbeitbaren Wert wird
abgelehnt. Speichern allein aktiviert diese Einstellungen nicht: Verwenden Sie
`?reload=instant`, `?reload=drain` oder `POST /v1/system/reload` und warten Sie
auf die Aktivierung der Generation. Auch bei gemischten Änderungen behält der
Dateiwächter die bisherigen Werte bei. API-Listener und Ereignispufferkapazität
bleiben an den Prozess gebunden; verspätete Cache-Schreibvorgänge können einer
Anfrage keine Daten einer anderen Generation liefern. Andere API-Einstellungen
müssen weiterhin in der zuständigen TOML-Datei geändert werden. Siehe
[API-Diagnoseeinstellungen](../Architecture/API/API.md#api-observability-settings).
`GET /v1/config/schema` beschreibt für jedes
Feld die API-Verfügbarkeit und das Übernahmeverhalten. `GET /v1/config/state`
zeigt Unterschiede zwischen Sollzustand und veröffentlichtem Zustand, ohne zu
bestätigen, dass alle Verbraucher die Einstellungen bereits übernommen haben.
+13 -3
View File
@@ -2227,9 +2227,19 @@ active API settings. Explicit generation reload applies `whitelist`,
`read_only`. `enabled`, `listen`, and `runtime_edge_events_capacity` require a
process restart.
Edit the owning TOML source, then use `POST /v1/system/reload` for fields that a
generation reload can apply. `PATCH /v1/config` currently permits only
`server.listeners` under `server`; it cannot write `server.api.*`.
`GET /v1/config`, `PATCH /v1/config`, and `POST /v1/config/validate` expose only
`minimal_runtime_enabled`, `minimal_runtime_cache_ttl_ms`, `runtime_edge_enabled`,
`runtime_edge_cache_ttl_ms`, and `runtime_edge_top_n` under `server.api`, alongside
`server.listeners`. GET includes defaults; sparse PATCH preserves API siblings.
Both TTLs accept `0..60000` ms (`0` disables caching); top-N accepts `1..1000`.
Omission and allowed `null` members retain values. Forbidden fields are rejected
even when `null`. A server patch without a concrete editable value is rejected.
Saving alone leaves these settings pending: use `?reload=instant`, `?reload=drain`,
or `POST /v1/system/reload` and wait for activation. The watcher retains them even
in mixed changes. The API listener and event-ring capacity remain process-owned;
late cache writes cannot cross request-generation boundaries. Other API settings
still require editing the owning TOML source. See
[API observability settings](../Architecture/API/API.md#api-observability-settings).
`GET /v1/config/schema` describes each field's exposure and application policy.
`GET /v1/config/state` reports desired/published differences without claiming
complete consumer convergence. See the [API reference](../Architecture/API/API.md)
+16 -4
View File
@@ -2233,10 +2233,22 @@
`read_only`. Для `enabled`, `listen` и `runtime_edge_events_capacity` нужен
перезапуск процесса.
Измените TOML-файл, которому принадлежит настройка, затем вызовите
`POST /v1/system/reload` для полей, применяемых через reload поколения.
`PATCH /v1/config` сейчас допускает только `server.listeners` внутри `server`
и не позволяет менять `server.api.*`. `GET /v1/config/schema` описывает
`GET /v1/config`, `PATCH /v1/config` и `POST /v1/config/validate` открывают внутри
`server.api` только `minimal_runtime_enabled`, `minimal_runtime_cache_ttl_ms`,
`runtime_edge_enabled`, `runtime_edge_cache_ttl_ms` и `runtime_edge_top_n`,
в дополнение к `server.listeners`. GET включает значения по умолчанию; PATCH
сохраняет соседние настройки API. Оба TTL допускают `0..60000` мс (`0` отключает
кэширование), top-N — `1..1000`. Пропущенные поля и допустимые поля со значением
`null` сохраняют прежние значения. Запрещённые поля отклоняются даже при `null`.
PATCH объекта server без конкретного редактируемого значения отклоняется.
Одного сохранения недостаточно: используйте `?reload=instant`, `?reload=drain`
или `POST /v1/system/reload` и дождитесь активации поколения. Watcher сохраняет
прежние значения этих полей даже при смешанных изменениях. Listener API и ёмкость
кольцевого буфера событий остаются общими для процесса; поздняя запись в кэш
не позволяет выдать запросу данные другого поколения. Остальные настройки API
по-прежнему меняются в TOML-файле-владельце. См.
[настройки диагностики API](../Architecture/API/API.md#api-observability-settings).
`GET /v1/config/schema` описывает
доступность и способ применения каждого поля. `GET /v1/config/state` показывает
различия между желаемым и опубликованным состоянием, без обещания, что все
потребители уже применили настройки. См. [справочник API](../Architecture/API/API.md)