From 7f8ff74d641aa22f975d88fd56b97f2a43787625 Mon Sep 17 00:00:00 2001 From: Richard McDaniel <1130888+rmcdaniel@users.noreply.github.com> Date: Fri, 13 Nov 2026 22:14:12 +0000 Subject: [PATCH 1/6] Prepare pending native fired-timer redrive guidance --- docs/failures-and-recovery.md | 2 +- docs/polyglot/server-api-reference.md | 23 +++++++++++++++++++++++ 2 files changed, 24 insertions(+), 1 deletion(-) diff --git a/docs/failures-and-recovery.md b/docs/failures-and-recovery.md index 4fc6805c793..07d06809675 100644 --- a/docs/failures-and-recovery.md +++ b/docs/failures-and-recovery.md @@ -264,7 +264,7 @@ Workflow releases before 2.18.0 accept a narrower set of runs. Every step before Releases before 2.19.0 ignore `reused_recorded_at` on reused signal, memo and search-attribute steps. After a Workflow 2.19.0 or later successor reuses those steps, keep 2.19.0 or later workers, or confirm that no such history can replay, before you roll back. In embedded mode, Workflow 2.19.0 replays, imports and resumes a 2.20.0 successor that reused an update or a chained signal wait the same way 2.20.0 does ([qualification receipt](https://github.com/durable-workflow/workflow/issues/864#issuecomment-6617902412)). -From 3.7.0, native Server redrive carries memos and search attributes set at start to the successor, and `describe()` reports `can_redrive` and `redrive_blocked_reason` under `actions`. From 3.8.0 it also reuses side effects and version markers before the failed step, recording each with its original payload, `reused_from_run_id` and `reused_recorded_at`, so workflow time after them matches the failed run. A 3.8.0 Server refuses to redrive a run whose workflow code upserted a memo or search attribute (`service_redrive_history_not_qualified`) or whose side effect result is stored externally (`external_side_effect_result_not_supported`). Otherwise it still applies the rules from before 2.18.0, so a fired timer is still refused with `unsupported_history`. Native Server support for the remaining rules is tracked in [server#980](https://github.com/durable-workflow/server/issues/980). +From 3.7.0, native Server redrive carries memos and search attributes set at start to the successor, and `describe()` reports `can_redrive` and `redrive_blocked_reason` under `actions`. From 3.8.0 it also reuses side effects and version markers before the failed step, recording each with its original payload, `reused_from_run_id` and `reused_recorded_at`. Native 3.8.0–3.10.x retains existing reuse timestamp strings but writes whole-second fallbacks for new reuse clocks, so those writes do not establish fractional replay-clock equality. These releases refuse workflow-code memo/search-attribute upserts (`service_redrive_history_not_qualified`), externally stored side-effect results (`external_side_effect_result_not_supported`) and fired timers (`unsupported_history`). The [pending native plain-timer and clock-precision correction](./polyglot/server-api-reference.md#native-redrive-timers) has separate publication and installed-SDK gates. Core's precision/reference follow-through and remaining native parity stay tracked in [server#980](https://github.com/durable-workflow/server/issues/980). ## Service Entry Refusal and Recovery {#service-entry-recovery} diff --git a/docs/polyglot/server-api-reference.md b/docs/polyglot/server-api-reference.md index 9ba5b802165..4159caab05f 100644 --- a/docs/polyglot/server-api-reference.md +++ b/docs/polyglot/server-api-reference.md @@ -499,6 +499,29 @@ encode them for you. A direct HTTP caller must use the official Avro encoder's `{codec, blob}` envelope or the runtime external reference below. The surrounding HTTP document is JSON; raw business JSON is not an alternative payload codec. +### Native fired-timer redrive and replay clocks {#native-redrive-timers} + +:::note Pending native publication and consumer qualification + +The plain-timer extension and fractional-clock correction are merged in [Server source 5221ed82](https://github.com/durable-workflow/server/pull/1215), with native 3.11.0 [release preparation](https://github.com/durable-workflow/server/pull/1218) still pending. The selected published Server retains its earlier timer refusal and clock-writing behavior. This source description does not establish a published producer, SDK replay result or stable selection. + +::: + +For an otherwise eligible run that failed at an activity, the new source accepts a completed plain timer before that failure. Its unique step must contain exactly one ordered `TimerScheduled` / `TimerFired` pair with matching source `timer_id`. The successor writes the pair with one fresh shared timer ID, creates no timer row or timer task, and resumes at the failed activity without waiting for that timer again. Source history stays unchanged. + +The reused `TimerFired` names the immediate predecessor in `reused_from_run_id`. Its `reused_recorded_at` retains the original timer event time across repeated redrives. Reused activities and markers also retain full available fractional precision when a fallback clock is first written. The initial replay anchor comes from the persisted source run start and is carried in `replayed_started_at`; consumed steps use their event-time authority. Repeated redrives preserve already-recorded clock strings and the existing initial anchor. Fractions omitted by an older producer cannot be reconstructed. Deadline formatting is unchanged. + +| Refusal | Timer boundary retained by the new source | +| --- | --- | +| `unsupported_timer` | A scope, parallel-group, cancellation-cleanup, condition or signal-timeout timer is outside the plain-timer slice. | +| `incomplete_timer_step` | The pair is missing, reversed, duplicated, or has absent/non-string/mismatched source timer IDs. | + +Cancelled timers remain `unsupported_history`. Step collisions, gaps and invalid failure boundaries keep their existing explicit refusals. Definition/fingerprint, parent/local-activity, external-payload and workflow-code-upsert limits still apply. Signals, updates and child workflows gain no native redrive support from this slice. Describe and redrive share structural eligibility; the existing worker-fingerprint comparison still applies when redrive is requested. + +The [actual PHP/Python/Rust cold-worker cohort](https://github.com/durable-workflow/server/issues/980#issuecomment-6865541932) must retain the same workflow definition/fingerprint through cold replacement and repeated redrive. It compares parsed full-precision UTC instants against an observed nonzero-fraction source `TimerFired`, preserves source history, and checks original callback counts, fresh timer identity and absence of repeated timer work. Whole-second rendering cannot establish that precision result, and installed history must not be rewritten to supply it. Source-controlled timestamp tests are separate evidence. + +Immutable producer/platform/source qualification, the applicable installed SDK receipts and actual Chart publication precede stable adoption. [Core's precision/reference follow-through](https://github.com/durable-workflow/workflow/issues/992) remains separate under [Server #980](https://github.com/durable-workflow/server/issues/980). The change adds no ordinary-entry clock support to an SDK that does not advertise it, and unchanged SDKs need no release solely to align version numbers. Protocol, OpenAPI and catalog shapes are unchanged. + ## Namespace And Storage Namespace routes require operator or admin roles. Mutating namespace and From 9f21e54a2e4b65ac9a9e302fafadb70f12d62c00 Mon Sep 17 00:00:00 2001 From: Richard McDaniel <1130888+rmcdaniel@users.noreply.github.com> Date: Fri, 13 Nov 2026 22:14:57 +0000 Subject: [PATCH 2/6] Clarify incomplete timer-step refusal wording --- docs/polyglot/server-api-reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/polyglot/server-api-reference.md b/docs/polyglot/server-api-reference.md index 4159caab05f..963a9193f76 100644 --- a/docs/polyglot/server-api-reference.md +++ b/docs/polyglot/server-api-reference.md @@ -514,7 +514,7 @@ The reused `TimerFired` names the immediate predecessor in `reused_from_run_id`. | Refusal | Timer boundary retained by the new source | | --- | --- | | `unsupported_timer` | A scope, parallel-group, cancellation-cleanup, condition or signal-timeout timer is outside the plain-timer slice. | -| `incomplete_timer_step` | The pair is missing, reversed, duplicated, or has absent/non-string/mismatched source timer IDs. | +| `incomplete_timer_step` | A timer step has a missing event, reversed or duplicate events, or absent/non-string/mismatched source timer IDs. | Cancelled timers remain `unsupported_history`. Step collisions, gaps and invalid failure boundaries keep their existing explicit refusals. Definition/fingerprint, parent/local-activity, external-payload and workflow-code-upsert limits still apply. Signals, updates and child workflows gain no native redrive support from this slice. Describe and redrive share structural eligibility; the existing worker-fingerprint comparison still applies when redrive is requested. From c986eeba56ccca104dee7757928f047008850dde Mon Sep 17 00:00:00 2001 From: Richard McDaniel <1130888+rmcdaniel@users.noreply.github.com> Date: Sat, 14 Nov 2026 11:38:46 +0000 Subject: [PATCH 3/6] Complete native timer guidance translations and refresh release status --- docs/polyglot/server-api-reference.md | 2 +- .../current/failures-and-recovery.md | 2 +- .../current/polyglot/server-api-reference.md | 23 +++++++++++++++++++ i18n/de/source-hashes.json | 4 ++-- .../current/failures-and-recovery.md | 2 +- .../current/polyglot/server-api-reference.md | 23 +++++++++++++++++++ i18n/es/source-hashes.json | 4 ++-- .../current/failures-and-recovery.md | 2 +- .../current/polyglot/server-api-reference.md | 23 +++++++++++++++++++ i18n/fr/source-hashes.json | 4 ++-- .../current/failures-and-recovery.md | 2 +- .../current/polyglot/server-api-reference.md | 23 +++++++++++++++++++ i18n/ja/source-hashes.json | 4 ++-- .../current/failures-and-recovery.md | 2 +- .../current/polyglot/server-api-reference.md | 23 +++++++++++++++++++ i18n/pt-BR/source-hashes.json | 4 ++-- .../current/failures-and-recovery.md | 2 +- .../current/polyglot/server-api-reference.md | 23 +++++++++++++++++++ i18n/uk/source-hashes.json | 4 ++-- .../current/failures-and-recovery.md | 2 +- .../current/polyglot/server-api-reference.md | 23 +++++++++++++++++++ i18n/zh-Hans/source-hashes.json | 4 ++-- 22 files changed, 183 insertions(+), 22 deletions(-) diff --git a/docs/polyglot/server-api-reference.md b/docs/polyglot/server-api-reference.md index b2d469c6689..6f60fd59cdb 100644 --- a/docs/polyglot/server-api-reference.md +++ b/docs/polyglot/server-api-reference.md @@ -505,7 +505,7 @@ HTTP document is JSON; raw business JSON is not an alternative payload codec. :::note Pending native publication and consumer qualification -The plain-timer extension and fractional-clock correction are merged in [Server source 5221ed82](https://github.com/durable-workflow/server/pull/1215), with native 3.11.0 [release preparation](https://github.com/durable-workflow/server/pull/1218) still pending. The selected published Server retains its earlier timer refusal and clock-writing behavior. This source description does not establish a published producer, SDK replay result or stable selection. +The plain-timer extension and fractional-clock correction are merged in [Server source 5221ed82](https://github.com/durable-workflow/server/pull/1215). Native 3.11.0 [release preparation](https://github.com/durable-workflow/server/pull/1218) is also merged, while publication and consumer qualification remain pending. The selected published Server retains its earlier timer refusal and clock-writing behavior. This source description does not establish a published producer, SDK replay result or stable selection. ::: diff --git a/i18n/de/docusaurus-plugin-content-docs/current/failures-and-recovery.md b/i18n/de/docusaurus-plugin-content-docs/current/failures-and-recovery.md index 8bcf5ab0507..fb6027c8723 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/failures-and-recovery.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/failures-and-recovery.md @@ -261,7 +261,7 @@ Workflow-Releases vor 2.18.0 nehmen weniger Läufe an. Jeder Schritt vor der feh Releases vor 2.19.0 ignorieren `reused_recorded_at` bei wiederverwendeten Signal-, Memo- und Suchattribut-Schritten. Nachdem ein Nachfolger aus Workflow 2.19.0 oder später diese Schritte wiederverwendet hat, behalten Sie Worker ab 2.19.0 bei oder stellen Sie vor einem Rollback sicher, dass keine solche Historie per Replay verarbeitet werden kann. Im Embedded-Modus verarbeitet Workflow 2.19.0 einen 2.20.0-Nachfolger, der ein Update oder eine verkettete Signalwarteoperation wiederverwendet hat, beim Replay, Import und Fortsetzen genauso wie 2.20.0 ([Qualifizierungsnachweis](https://github.com/durable-workflow/workflow/issues/864#issuecomment-6617902412)). -Ab 3.7.0 übernimmt Redrive im nativen Server beim Start gesetzte Memos und Suchattribute auf den Nachfolger, und `describe()` meldet `can_redrive` und `redrive_blocked_reason` unter `actions`. Ab 3.8.0 verwendet er außerdem Seiteneffekte und Versionsmarker vor dem fehlgeschlagenen Schritt wieder und zeichnet jeden davon mit seinem ursprünglichen Payload, `reused_from_run_id` und `reused_recorded_at` auf, sodass die Workflow-Zeit nach diesen Schritten der des fehlgeschlagenen Laufs entspricht. Ein Server 3.8.0 lehnt den Redrive eines Laufs ab, dessen Workflow-Code ein Memo oder Suchattribut per Upsert gesetzt hat (`service_redrive_history_not_qualified`) oder dessen Seiteneffekt-Ergebnis extern gespeichert ist (`external_side_effect_result_not_supported`). Ansonsten wendet er weiterhin die Regeln von vor 2.18.0 an, daher wird ein ausgelöster Timer weiterhin mit `unsupported_history` abgelehnt. Die Unterstützung der übrigen Regeln im nativen Server wird in [server#980](https://github.com/durable-workflow/server/issues/980) verfolgt. +Seit 3.7.0 übernimmt natives Server-Redrive beim Start gesetzte Memos und Suchattribute in den Nachfolger, und `describe()` meldet `can_redrive` sowie `redrive_blocked_reason` unter `actions`. Seit 3.8.0 werden auch Side Effects und Versionsmarker vor dem fehlgeschlagenen Schritt mit ursprünglicher Payload, `reused_from_run_id` und `reused_recorded_at` wiederverwendet. Native 3.8.0–3.10.x erhalten vorhandene Wiederverwendungs-Zeitstempelstrings, schreiben aber neue Fallback-Uhren nur mit ganzen Sekunden. Diese Schreibvorgänge belegen keine Gleichheit von Sekundenbruchteilen beim Replay. Diese Releases verweigern Memo-/Suchattribut-Upserts aus Workflow-Code (`service_redrive_history_not_qualified`), extern gespeicherte Side-Effect-Ergebnisse (`external_side_effect_result_not_supported`) und ausgelöste Timer (`unsupported_history`). Die [ausstehende native Plain-Timer- und Uhrpräzisionskorrektur](./polyglot/server-api-reference.md#native-redrive-timers) hat separate Veröffentlichungs- und installierte SDK-Gates. Cores Präzisions-/Referenzarbeit und übrige native Parität bleiben in [server#980](https://github.com/durable-workflow/server/issues/980) erfasst. ## Ablehnung am Einstieg im Servicemodus und Wiederherstellung {#service-entry-recovery} diff --git a/i18n/de/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md b/i18n/de/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md index 5ce48c5bb52..38fa361032e 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md @@ -485,6 +485,29 @@ Laufbezogene Befehlsrouten lehnen historische oder falsche Laufziele explizit ab Befehle übertragen Geschäftswerte in Avro-Envelopes. Die offiziellen SDKs codieren sie automatisch. Direkte HTTP-Clients müssen den `{codec, blob}`-Envelope des offiziellen Avro-Encoders oder die unten beschriebene Runtime-Referenz verwenden. Das äußere HTTP-Dokument ist JSON; uncodiertes Geschäfts-JSON ist kein alternativer Nutzlast-Codec. +### Native Redrive ausgelöster Timer und Replay-Uhren {#native-redrive-timers} + +:::note Native Veröffentlichung und Consumer-Qualifikation ausstehend + +Die Plain-Timer-Erweiterung und Korrektur der Sekundenbruchteile sind in [Server-Quellstand 5221ed82](https://github.com/durable-workflow/server/pull/1215) zusammengeführt. Auch die [Release-Vorbereitung](https://github.com/durable-workflow/server/pull/1218) für native 3.11.0 ist zusammengeführt; Veröffentlichung und Consumer-Qualifikation stehen noch aus. Der ausgewählte veröffentlichte Server behält seine bisherige Timer-Ablehnung und Uhrschreibweise. Diese Quellbeschreibung belegt keinen veröffentlichten Producer, SDK-Replay-Erfolg oder stabile Auswahl. + +::: + +Für einen sonst geeigneten Lauf, der bei einer Activity scheiterte, akzeptiert der neue Quellstand einen davor abgeschlossenen einfachen Timer. Dessen eindeutiger Schritt muss genau ein geordnetes Paar `TimerScheduled` / `TimerFired` mit übereinstimmender Quell-`timer_id` enthalten. Der Nachfolger schreibt das Paar mit einer neuen gemeinsamen Timer-ID, erzeugt weder Timer-Zeile noch Timer-Task und setzt an der gescheiterten Activity fort, ohne erneut auf den Timer zu warten. Die Quellhistorie bleibt unverändert. + +Das wiederverwendete `TimerFired` nennt den unmittelbaren Vorgänger in `reused_from_run_id`. Sein `reused_recorded_at` erhält die ursprüngliche Timer-Ereigniszeit über wiederholte Redrives. Wiederverwendete Activities und Marker erhalten bei der ersten Fallback-Uhrschreibung ebenfalls die volle verfügbare Bruchteilpräzision. Der anfängliche Replay-Anker stammt aus dem gespeicherten Start des Quelllaufs und wird in `replayed_started_at` weitergegeben; konsumierte Schritte verwenden ihre Ereigniszeit als Autorität. Wiederholte Redrives erhalten vorhandene Uhrstrings und den bestehenden Anfangsanker. Von älteren Producern ausgelassene Bruchteile lassen sich nicht rekonstruieren. Die Deadline-Formatierung bleibt unverändert. + +| Ablehnung | Vom neuen Quellstand bewahrte Timer-Grenze | +| --- | --- | +| `unsupported_timer` | Ein Scope-, Parallelgruppen-, Cancellation-Cleanup-, Condition- oder Signal-Timeout-Timer liegt außerhalb des Plain-Timer-Umfangs. | +| `incomplete_timer_step` | Einem Timer-Schritt fehlt ein Ereignis, Ereignisse sind vertauscht oder doppelt, oder Quell-Timer-IDs fehlen, sind keine Strings oder stimmen nicht überein. | + +Abgebrochene Timer bleiben `unsupported_history`. Schritt-Kollisionen, Lücken und ungültige Fehlergrenzen behalten ihre expliziten Ablehnungen. Definition/Fingerprint-, Eltern-/Local-Activity-, externe Payload- und Workflow-Code-Upsert-Grenzen gelten weiter. Signals, Updates und Child-Workflows erhalten durch diesen Teil keine native Redrive-Unterstützung. Describe und Redrive teilen strukturelle Eignung; beim Redrive gilt weiterhin der Worker-Fingerprint-Vergleich. + +Die [tatsächliche PHP/Python/Rust-Cold-Worker-Kohorte](https://github.com/durable-workflow/server/issues/980#issuecomment-6865541932) muss bei kaltem Austausch und wiederholtem Redrive dieselbe Workflow-Definition und denselben Fingerprint erhalten. Sie vergleicht vollständig geparste UTC-Zeitpunkte mit einem beobachteten Quell-`TimerFired` mit nichtnull Sekundenbruchteil, erhält die Quellhistorie und prüft ursprüngliche Callback-Zahlen, neue Timer-Identität und ausbleibende erneute Timer-Arbeit. Eine Ganzsekundendarstellung belegt diese Präzision nicht; installierte Historie darf dafür nicht umgeschrieben werden. Quelltests mit kontrollierten Zeitstempeln sind separate Evidenz. + +Unveränderliche Producer-/Plattform-/Quellqualifikation, die jeweiligen installierten SDK-Belege und die tatsächliche Chart-Veröffentlichung gehen stabiler Übernahme voraus. [Cores Präzisions-/Referenzarbeit](https://github.com/durable-workflow/workflow/issues/992) bleibt unter [Server #980](https://github.com/durable-workflow/server/issues/980) separat. Die Änderung ergänzt keine Ordinary-Entry-Uhrunterstützung in einem SDK, das sie nicht meldet; unveränderte SDKs benötigen keine bloße Versionsangleichungs-Release. Protokoll-, OpenAPI- und Katalogstrukturen bleiben unverändert. + ## Namespace und Speicher {#namespace-and-storage} Namespace-Routen benötigen Operator- oder Admin-Rollen. Ändernde Namespace- diff --git a/i18n/de/source-hashes.json b/i18n/de/source-hashes.json index 7ef1a28e1e1..1af763ca1cf 100644 --- a/i18n/de/source-hashes.json +++ b/i18n/de/source-hashes.json @@ -29,7 +29,7 @@ "defining-workflows/workflow-status.md": "8e8cb27ff44c890d489d89bf166375acfdfaecabd990a2235e106fab1592d529", "defining-workflows/workflows.md": "f467bc73de32aa5d722c61ce085065460382ae7dd44cea4625847d9fcdc4c97c", "deployment.md": "1dd901213228a52e6222a15c6b85305098a4a4db06f198e319a7889c4562bddb", - "failures-and-recovery.md": "a240727af9539cca9cceb6ab3ddea545c95f21402813365442929ea05c09e70c", + "failures-and-recovery.md": "877e8ebafa056e78d2603e1d0339cc6f61fdffd6368f984ba043e1b752ee961c", "features/activity-execution-model.md": "e8c37520ae46a7efb30438f4fc06bf893c1df430cb1f92c48963697adaf09082", "features/cancel-and-terminate.md": "cedd1e6c51dfa551e00edc1d39739ff1f67d558d2a0be92143f478cb6111536b", "features/child-workflows.md": "30dd8e1a131654d6320641446b6bd661f27cd591353a60d007574955749cf8fb", @@ -88,7 +88,7 @@ "polyglot/runtime-migration.md": "5a78713bb8cb74aea58f6d5d826400d968a405f69c6ff17fdf2f7decb1d14b71", "polyglot/rust-cloud-quickstart.md": "2303434fc9302a81a8381ad4836423ef9952eb3201a4574c432254e3cb68c5f3", "polyglot/rust.md": "602f61be5ec561f27845d4ca0657d71c8f6cc3f08e30d1f657bd62c23dc53314", - "polyglot/server-api-reference.md": "d3f148fc8a12a315d695d47108ce658c80dea78c314b650a3b86f08727a20aee", + "polyglot/server-api-reference.md": "9d671a8c63682069f8c12b2ad71b50ca81900628643dec30bd70ee373b3388e0", "polyglot/server-config-reference.md": "aec241c0046f12a9d6efe2d6c1de443d7753bdf34135e06a6f83b3904ed1d429", "polyglot/server-role-topology.md": "3d048f0c6b5f179399622508f51e67fff8aa5a6d5b2492533fc720eeec2c27f2", "polyglot/server.md": "f24fd7ff4eebcc768ec8105e8689ab1a14cc08d98167090ebb84e3e26631132a", diff --git a/i18n/es/docusaurus-plugin-content-docs/current/failures-and-recovery.md b/i18n/es/docusaurus-plugin-content-docs/current/failures-and-recovery.md index 53af436b349..bd61b17aee4 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/failures-and-recovery.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/failures-and-recovery.md @@ -265,7 +265,7 @@ Las versiones de Workflow anteriores a 2.18.0 aceptan menos ejecuciones. Cada pa Las versiones anteriores a 2.19.0 ignoran `reused_recorded_at` en los pasos reutilizados de señal, memo y atributo de búsqueda. Después de que un sucesor de Workflow 2.19.0 o posterior reutilice esos pasos, mantenga workers de 2.19.0 o posteriores, o confirme que ningún historial así puede reproducirse, antes de volver atrás. En modo embebido, Workflow 2.19.0 reproduce, importa y reanuda un sucesor de 2.20.0 que reutilizó un update o una espera de señal encadenada igual que 2.20.0 ([comprobante de calificación](https://github.com/durable-workflow/workflow/issues/864#issuecomment-6617902412)). -Desde 3.7.0, el redrive en el Server nativo traslada a la sucesora los memos y atributos de búsqueda establecidos al inicio, y `describe()` informa `can_redrive` y `redrive_blocked_reason` dentro de `actions`. Desde 3.8.0 también reutiliza los efectos secundarios y los marcadores de versión anteriores al paso fallido, y registra cada uno con su carga útil original, `reused_from_run_id` y `reused_recorded_at`, así que la hora del workflow después de ellos coincide con la de la ejecución fallida. Un Server 3.8.0 rechaza el redrive de una ejecución cuyo código de workflow actualizó un memo o atributo de búsqueda (`service_redrive_history_not_qualified`) o cuyo resultado de efecto secundario se almacena externamente (`external_side_effect_result_not_supported`). Por lo demás, sigue aplicando las reglas anteriores a 2.18.0, así que un temporizador disparado se sigue rechazando con `unsupported_history`. La compatibilidad del Server nativo con las reglas restantes se sigue en [server#980](https://github.com/durable-workflow/server/issues/980). +Desde 3.7.0, el redrive del Server nativo transfiere al sucesor memos y atributos de búsqueda establecidos al inicio, y `describe()` informa `can_redrive` y `redrive_blocked_reason` bajo `actions`. Desde 3.8.0 también reutiliza efectos laterales y marcadores de versión previos al paso fallido, registrando payload original, `reused_from_run_id` y `reused_recorded_at`. Las versiones nativas 3.8.0–3.10.x conservan las cadenas de timestamps reutilizadas existentes, pero escriben respaldos de reloj nuevos con segundos enteros; esas escrituras no acreditan igualdad fraccionaria del reloj de replay. Rechazan upserts de memo/atributos desde el workflow (`service_redrive_history_not_qualified`), resultados de efectos laterales externos (`external_side_effect_result_not_supported`) y temporizadores disparados (`unsupported_history`). La [corrección pendiente de temporizadores simples y precisión del reloj](./polyglot/server-api-reference.md#native-redrive-timers) tiene sus propias condiciones de publicación y SDK instalado. El trabajo de precisión/referencia de Core y la paridad nativa restante siguen en [server#980](https://github.com/durable-workflow/server/issues/980). ## Rechazo de entrada y recuperación en modo servicio {#service-entry-recovery} diff --git a/i18n/es/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md b/i18n/es/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md index fc73846eac4..bd437bc4d8d 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md @@ -352,6 +352,29 @@ Los comandos dirigidos a ejecución rechazan explícitamente destinos histórico Los comandos llevan valores de negocio en sobres Avro. Los SDK oficiales los codifican automáticamente. Un cliente HTTP directo debe usar el sobre `{codec, blob}` del codificador Avro oficial o la referencia del runtime descrita abajo. El documento HTTP exterior es JSON; el JSON de negocio sin codificar no es un códec alternativo. +### Redrive nativo de temporizadores disparados y relojes de replay {#native-redrive-timers} + +:::note Publicación nativa y validación de consumidores pendientes + +La extensión de temporizadores simples y la corrección de precisión fraccionaria están integradas en el [código del Server 5221ed82](https://github.com/durable-workflow/server/pull/1215). También se integró la [preparación de versión](https://github.com/durable-workflow/server/pull/1218) nativa 3.11.0; la publicación y la validación de consumidores siguen pendientes. El Server publicado seleccionado conserva el rechazo de temporizadores y la escritura de relojes anteriores. Esta descripción de código no acredita un productor publicado, un resultado de replay del SDK ni una selección estable. + +::: + +Para una ejecución elegible que falló en una actividad, el código nuevo acepta un temporizador simple completado antes del fallo. Su paso único debe contener exactamente un par ordenado `TimerScheduled` / `TimerFired` con la misma `timer_id` de origen. El sucesor escribe el par con un ID de temporizador nuevo y compartido, no crea fila ni tarea de temporizador y continúa en la actividad fallida sin esperar otra vez ese temporizador. El historial de origen no cambia. + +El `TimerFired` reutilizado nombra al predecesor inmediato en `reused_from_run_id`. Su `reused_recorded_at` conserva el instante original del evento entre redrives repetidos. Las actividades y los marcadores reutilizados también conservan toda la precisión fraccionaria disponible al escribir por primera vez un reloj de respaldo. El anclaje inicial del replay procede del inicio persistido de la ejecución de origen y se transporta en `replayed_started_at`; los pasos consumidos usan la autoridad temporal de su evento. Redrives repetidos conservan las cadenas de reloj ya registradas y el anclaje inicial existente. No se pueden reconstruir fracciones omitidas por un productor anterior. El formato de deadlines no cambia. + +| Rechazo | Límite del temporizador conservado por el código nuevo | +| --- | --- | +| `unsupported_timer` | Un temporizador de scope, grupo paralelo, limpieza de cancelación, condición o timeout de señal queda fuera de los temporizadores simples. | +| `incomplete_timer_step` | Falta un evento del paso, los eventos están invertidos o duplicados, o los IDs de origen faltan, no son cadenas o no coinciden. | + +Los temporizadores cancelados siguen siendo `unsupported_history`. Colisiones, huecos y límites de fallo inválidos conservan sus rechazos explícitos. Siguen vigentes los límites de definición/fingerprint, padre/actividad local, payload externo y upserts desde el workflow. Este trabajo no añade redrive nativo para señales, actualizaciones o workflows hijos. Describe y redrive comparten elegibilidad estructural; al solicitar redrive sigue aplicándose la comparación de fingerprint del worker. + +La [cohorte real de workers fríos PHP/Python/Rust](https://github.com/durable-workflow/server/issues/980#issuecomment-6865541932) debe mantener la misma definición/fingerprint durante el reemplazo frío y redrives repetidos. Compara instantes UTC analizados con precisión completa contra un `TimerFired` de origen observado con fracción no nula, conserva el historial de origen y comprueba los conteos originales de callbacks, la identidad nueva del temporizador y la ausencia de trabajo repetido. Mostrar segundos enteros no acredita esa precisión; no se puede reescribir el historial instalado para producirla. Las pruebas de código con timestamps controlados son evidencia separada. + +La validación del productor/plataforma/código inmutables, los recibos instalados aplicables de SDK y la publicación real del Chart preceden a la adopción estable. El [trabajo de precisión/referencia de Core](https://github.com/durable-workflow/workflow/issues/992) sigue separado bajo [Server #980](https://github.com/durable-workflow/server/issues/980). El cambio no añade relojes en la entrada ordinaria a un SDK que no los anuncia; un SDK sin cambios no requiere una versión nueva solo para alinear números. Las formas de protocolo, OpenAPI y catálogo no cambian. + ## Espacios de nombres y almacenamiento {#namespace-and-storage} Estas rutas requieren operator o admin. Las que modifican espacios o almacenamiento externo requieren admin. diff --git a/i18n/es/source-hashes.json b/i18n/es/source-hashes.json index 7ef1a28e1e1..1af763ca1cf 100644 --- a/i18n/es/source-hashes.json +++ b/i18n/es/source-hashes.json @@ -29,7 +29,7 @@ "defining-workflows/workflow-status.md": "8e8cb27ff44c890d489d89bf166375acfdfaecabd990a2235e106fab1592d529", "defining-workflows/workflows.md": "f467bc73de32aa5d722c61ce085065460382ae7dd44cea4625847d9fcdc4c97c", "deployment.md": "1dd901213228a52e6222a15c6b85305098a4a4db06f198e319a7889c4562bddb", - "failures-and-recovery.md": "a240727af9539cca9cceb6ab3ddea545c95f21402813365442929ea05c09e70c", + "failures-and-recovery.md": "877e8ebafa056e78d2603e1d0339cc6f61fdffd6368f984ba043e1b752ee961c", "features/activity-execution-model.md": "e8c37520ae46a7efb30438f4fc06bf893c1df430cb1f92c48963697adaf09082", "features/cancel-and-terminate.md": "cedd1e6c51dfa551e00edc1d39739ff1f67d558d2a0be92143f478cb6111536b", "features/child-workflows.md": "30dd8e1a131654d6320641446b6bd661f27cd591353a60d007574955749cf8fb", @@ -88,7 +88,7 @@ "polyglot/runtime-migration.md": "5a78713bb8cb74aea58f6d5d826400d968a405f69c6ff17fdf2f7decb1d14b71", "polyglot/rust-cloud-quickstart.md": "2303434fc9302a81a8381ad4836423ef9952eb3201a4574c432254e3cb68c5f3", "polyglot/rust.md": "602f61be5ec561f27845d4ca0657d71c8f6cc3f08e30d1f657bd62c23dc53314", - "polyglot/server-api-reference.md": "d3f148fc8a12a315d695d47108ce658c80dea78c314b650a3b86f08727a20aee", + "polyglot/server-api-reference.md": "9d671a8c63682069f8c12b2ad71b50ca81900628643dec30bd70ee373b3388e0", "polyglot/server-config-reference.md": "aec241c0046f12a9d6efe2d6c1de443d7753bdf34135e06a6f83b3904ed1d429", "polyglot/server-role-topology.md": "3d048f0c6b5f179399622508f51e67fff8aa5a6d5b2492533fc720eeec2c27f2", "polyglot/server.md": "f24fd7ff4eebcc768ec8105e8689ab1a14cc08d98167090ebb84e3e26631132a", diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/failures-and-recovery.md b/i18n/fr/docusaurus-plugin-content-docs/current/failures-and-recovery.md index 2b220397484..d2bc0808ce6 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/failures-and-recovery.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/failures-and-recovery.md @@ -269,7 +269,7 @@ Les versions de Workflow antérieures à 2.18.0 acceptent un ensemble plus restr Les versions antérieures à 2.19.0 ignorent `reused_recorded_at` sur les étapes de signal, de mémo et d’attribut de recherche réutilisées. Une fois qu’un successeur de Workflow 2.19.0 ou ultérieur a réutilisé ces étapes, gardez des workers 2.19.0 ou ultérieurs, ou vérifiez qu’aucun historique de ce type ne peut être rejoué, avant de revenir en arrière. En mode embarqué, Workflow 2.19.0 rejoue, importe et reprend un successeur 2.20.0 qui a réutilisé un update ou une attente de signal enchaînée de la même façon que 2.20.0 ([preuve de qualification](https://github.com/durable-workflow/workflow/issues/864#issuecomment-6617902412)). -Depuis 3.7.0, le redrive du Server natif reporte sur le successeur les mémos et attributs de recherche définis au démarrage, et `describe()` indique `can_redrive` et `redrive_blocked_reason` sous `actions`. Depuis 3.8.0, il réutilise aussi les effets de bord et marqueurs de version antérieurs à l'étape échouée, en enregistrant chacun avec son payload d'origine, `reused_from_run_id` et `reused_recorded_at`, de sorte que le temps du workflow après ces étapes correspond à celui de l'exécution échouée. Un Server 3.8.0 refuse le redrive d’une exécution dont le code du workflow a défini un mémo ou un attribut de recherche par upsert (`service_redrive_history_not_qualified`) ou dont le résultat d’un effet de bord est stocké en externe (`external_side_effect_result_not_supported`). Pour le reste, il applique toujours les règles antérieures à 2.18.0 : un minuteur déclenché est donc toujours refusé avec `unsupported_history`. La prise en charge des règles restantes par le Server natif est suivie dans [server#980](https://github.com/durable-workflow/server/issues/980). +Depuis 3.7.0, le redrive du Server natif transmet au successeur les memos et attributs de recherche définis au démarrage, et `describe()` expose `can_redrive` et `redrive_blocked_reason` sous `actions`. Depuis 3.8.0, il réutilise aussi les effets de bord et marqueurs de version précédant l’étape échouée, avec leur payload original, `reused_from_run_id` et `reused_recorded_at`. Les versions natives 3.8.0–3.10.x conservent les chaînes d’horodatage réutilisées existantes, mais écrivent les nouvelles horloges de repli en secondes entières ; cela ne prouve pas l’égalité fractionnaire des horloges de relecture. Elles refusent les upserts de memo/attribut dans le workflow (`service_redrive_history_not_qualified`), les résultats d’effets de bord externes (`external_side_effect_result_not_supported`) et les temporisateurs déclenchés (`unsupported_history`). La [correction native en attente des temporisateurs simples et de la précision d’horloge](./polyglot/server-api-reference.md#native-redrive-timers) conserve ses propres conditions de publication et de SDK installé. Le suivi de précision/référence de Core et la parité native restante restent dans [server#980](https://github.com/durable-workflow/server/issues/980). ## Refus à l’entrée en mode service et récupération {#service-entry-recovery} diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md b/i18n/fr/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md index be8f2c49774..e4dce74f992 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md @@ -502,6 +502,29 @@ historiques ou les mauvaises exécutions : Les commandes transportent les valeurs métier dans des enveloppes Avro. Les SDK officiels les encodent automatiquement. Un client HTTP direct doit utiliser l’enveloppe `{codec, blob}` de l’encodeur Avro officiel ou la référence du runtime ci-dessous. Le document HTTP extérieur reste JSON ; le JSON métier brut n’est pas un autre codec de charge utile. +### Redrive natif des temporisateurs déclenchés et horloges de relecture {#native-redrive-timers} + +:::note Publication native et qualification des consommateurs en attente + +L’extension des temporisateurs simples et la correction de précision fractionnaire sont intégrées dans le [code Server 5221ed82](https://github.com/durable-workflow/server/pull/1215). La [préparation de version](https://github.com/durable-workflow/server/pull/1218) native 3.11.0 est aussi intégrée ; publication et qualification des consommateurs restent en attente. Le Server publié sélectionné conserve ses refus de temporisateurs et son écriture d’horloge précédents. Cette description source n’établit ni producteur publié, ni résultat de relecture SDK, ni sélection stable. + +::: + +Pour une exécution par ailleurs admissible ayant échoué dans une activité, le nouveau code accepte un temporisateur simple terminé avant cet échec. Son étape unique doit contenir exactement une paire ordonnée `TimerScheduled` / `TimerFired` avec la même `timer_id` source. Le successeur écrit la paire avec un nouvel ID de temporisateur partagé, ne crée ni ligne ni tâche de temporisateur, et reprend à l’activité échouée sans attendre à nouveau ce temporisateur. L’historique source reste inchangé. + +Le `TimerFired` réutilisé nomme le prédécesseur immédiat dans `reused_from_run_id`. Son `reused_recorded_at` conserve l’instant original de l’événement entre redrives répétés. Les activités et marqueurs réutilisés conservent aussi toute la précision fractionnaire disponible lors de la première écriture d’une horloge de repli. L’ancre initiale de relecture vient du début persisté de l’exécution source et passe dans `replayed_started_at` ; les étapes consommées utilisent l’autorité temporelle de leur événement. Les redrives répétés conservent les chaînes d’horloge enregistrées et l’ancre initiale existante. Les fractions omises par un ancien producteur ne peuvent pas être reconstruites. Le format des échéances reste inchangé. + +| Refus | Limite du temporisateur conservée par le nouveau code | +| --- | --- | +| `unsupported_timer` | Un temporisateur de scope, groupe parallèle, nettoyage d’annulation, condition ou délai de signal sort du périmètre des temporisateurs simples. | +| `incomplete_timer_step` | Un événement manque, les événements sont inversés ou dupliqués, ou les IDs source manquent, ne sont pas des chaînes ou diffèrent. | + +Les temporisateurs annulés restent `unsupported_history`. Collisions d’étapes, trous et frontières d’échec invalides gardent leurs refus explicites. Les limites de définition/empreinte, parent/activité locale, payload externe et upsert dans le code workflow s’appliquent toujours. Ce périmètre n’ajoute pas le redrive natif des signaux, mises à jour ou workflows enfants. Describe et redrive partagent l’admissibilité structurelle ; la comparaison d’empreinte du worker s’applique toujours à la demande de redrive. + +La [cohorte réelle de workers froids PHP/Python/Rust](https://github.com/durable-workflow/server/issues/980#issuecomment-6865541932) doit garder la même définition/empreinte lors du remplacement à froid et des redrives répétés. Elle compare des instants UTC analysés à pleine précision à un `TimerFired` source observé avec fraction non nulle, préserve l’historique source et vérifie les nombres originaux de callbacks, la nouvelle identité du temporisateur et l’absence de travail répété. Un affichage en secondes entières ne prouve pas cette précision ; l’historique installé ne doit pas être réécrit pour la fournir. Les tests source à horodatages contrôlés sont une preuve distincte. + +La qualification des producteur/plateforme/source immuables, les reçus SDK installés applicables et la publication réelle du Chart précèdent l’adoption stable. Le [suivi de précision/référence de Core](https://github.com/durable-workflow/workflow/issues/992) reste distinct sous [Server #980](https://github.com/durable-workflow/server/issues/980). Le changement n’ajoute pas de prise en charge de l’horloge d’entrée ordinaire à un SDK qui ne l’annonce pas ; les SDK inchangés n’ont pas besoin de nouvelle version pour simplement aligner les numéros. Les formes du protocole, d’OpenAPI et du catalogue restent inchangées. + ## Espaces de noms et stockage {#namespace-and-storage} Les routes des espaces de noms exigent les rôles operator ou admin. Leurs diff --git a/i18n/fr/source-hashes.json b/i18n/fr/source-hashes.json index 7ef1a28e1e1..1af763ca1cf 100644 --- a/i18n/fr/source-hashes.json +++ b/i18n/fr/source-hashes.json @@ -29,7 +29,7 @@ "defining-workflows/workflow-status.md": "8e8cb27ff44c890d489d89bf166375acfdfaecabd990a2235e106fab1592d529", "defining-workflows/workflows.md": "f467bc73de32aa5d722c61ce085065460382ae7dd44cea4625847d9fcdc4c97c", "deployment.md": "1dd901213228a52e6222a15c6b85305098a4a4db06f198e319a7889c4562bddb", - "failures-and-recovery.md": "a240727af9539cca9cceb6ab3ddea545c95f21402813365442929ea05c09e70c", + "failures-and-recovery.md": "877e8ebafa056e78d2603e1d0339cc6f61fdffd6368f984ba043e1b752ee961c", "features/activity-execution-model.md": "e8c37520ae46a7efb30438f4fc06bf893c1df430cb1f92c48963697adaf09082", "features/cancel-and-terminate.md": "cedd1e6c51dfa551e00edc1d39739ff1f67d558d2a0be92143f478cb6111536b", "features/child-workflows.md": "30dd8e1a131654d6320641446b6bd661f27cd591353a60d007574955749cf8fb", @@ -88,7 +88,7 @@ "polyglot/runtime-migration.md": "5a78713bb8cb74aea58f6d5d826400d968a405f69c6ff17fdf2f7decb1d14b71", "polyglot/rust-cloud-quickstart.md": "2303434fc9302a81a8381ad4836423ef9952eb3201a4574c432254e3cb68c5f3", "polyglot/rust.md": "602f61be5ec561f27845d4ca0657d71c8f6cc3f08e30d1f657bd62c23dc53314", - "polyglot/server-api-reference.md": "d3f148fc8a12a315d695d47108ce658c80dea78c314b650a3b86f08727a20aee", + "polyglot/server-api-reference.md": "9d671a8c63682069f8c12b2ad71b50ca81900628643dec30bd70ee373b3388e0", "polyglot/server-config-reference.md": "aec241c0046f12a9d6efe2d6c1de443d7753bdf34135e06a6f83b3904ed1d429", "polyglot/server-role-topology.md": "3d048f0c6b5f179399622508f51e67fff8aa5a6d5b2492533fc720eeec2c27f2", "polyglot/server.md": "f24fd7ff4eebcc768ec8105e8689ab1a14cc08d98167090ebb84e3e26631132a", diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/failures-and-recovery.md b/i18n/ja/docusaurus-plugin-content-docs/current/failures-and-recovery.md index 676f86d9432..107d899441c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/failures-and-recovery.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/failures-and-recovery.md @@ -261,7 +261,7 @@ Workflow 2.18.0 は、完了したアクティビティ、副作用、バージ 2.19.0 より前のリリースは、再利用されたシグナル、メモ、検索属性のステップの `reused_recorded_at` を無視します。Workflow 2.19.0 以降の後継実行がこれらのステップを再利用した後は、2.19.0 以降のワーカーを使い続けるか、ロールバックの前にそのような履歴がリプレイされないことを確認してください。組み込みモードでは、Workflow 2.19.0 は、更新または連鎖したシグナル待機を再利用した 2.20.0 の後継実行を、2.20.0 と同じようにリプレイ、インポート、再開します([検証記録](https://github.com/durable-workflow/workflow/issues/864#issuecomment-6617902412))。 -3.7.0 以降、ネイティブ Server の redrive は、開始時に設定されたメモと検索属性を後継実行に引き継ぎ、`describe()` は `actions` の下に `can_redrive` と `redrive_blocked_reason` を報告します。3.8.0 以降は、失敗したステップより前のサイドエフェクトとバージョンマーカーも再利用し、それぞれを元のペイロード、`reused_from_run_id`、`reused_recorded_at` とともに記録するため、それ以降のワークフロー時刻は失敗した実行と一致します。Server 3.8.0 は、ワークフローコードがメモや検索属性を upsert した実行(`service_redrive_history_not_qualified`)や、サイドエフェクトの結果が外部に保存されている実行(`external_side_effect_result_not_supported`)の redrive を拒否します。それ以外については現在も 2.18.0 より前の規則が適用されるため、発火済みのタイマーは引き続き `unsupported_history` で拒否されます。ネイティブ Server での残りの規則への対応は [server#980](https://github.com/durable-workflow/server/issues/980) で追跡しています。 +3.7.0 以降、native Server の redrive は開始時の memo と検索属性を後続へ引き継ぎ、`describe()` は `actions` 内に `can_redrive` と `redrive_blocked_reason` を返します。3.8.0 以降は失敗ステップ前の副作用とバージョンマーカーも再利用し、元のペイロード、`reused_from_run_id`、`reused_recorded_at` を記録します。native 3.8.0–3.10.x は既存の再利用タイムスタンプ文字列を保持しますが、新たなフォールバッククロックを秒単位で書くため、小数部を含むリプレイクロックの一致を示しません。これらのリリースはワークフロー内 memo/検索属性 upsert(`service_redrive_history_not_qualified`)、外部保存された副作用結果(`external_side_effect_result_not_supported`)、発火済みタイマー(`unsupported_history`)を拒否します。[保留中の単純タイマーとクロック精度の native 修正](./polyglot/server-api-reference.md#native-redrive-timers)には、公開とインストール済み SDK の別の条件があります。Core の精度/参照と残りの native 同等性は [server#980](https://github.com/durable-workflow/server/issues/980) で追跡します。 ## サービスモードのエントリ拒否と復旧 {#service-entry-recovery} diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md b/i18n/ja/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md index 178c3b379e4..ef19b36ecbf 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md @@ -352,6 +352,29 @@ Server は協調的な `request-cancellation` ルートも提供します。時 コマンドは業務値を Avro ペイロードエンベロープで運びます。公式 SDK が自動でエンコードします。直接 HTTP クライアントは、公式 Avro エンコーダーの `{codec, blob}` エンベロープか、以下のランタイム外部参照を使ってください。外側の HTTP 文書は JSON ですが、生の業務 JSON は別のペイロードコーデックとして使えません。 +### 発火済みタイマーの native redrive とリプレイクロック {#native-redrive-timers} + +:::note native 公開と利用側の資格検証は未完了 + +単純タイマーの拡張と小数精度の修正は [Server ソース 5221ed82](https://github.com/durable-workflow/server/pull/1215) にマージ済みです。native 3.11.0 の[リリース準備](https://github.com/durable-workflow/server/pull/1218)もマージ済みですが、公開と利用側の資格検証はまだ完了していません。選択中の公開 Server は以前のタイマー拒否とクロック書き込み動作を保持します。このソース説明は、公開済み producer、SDK のリプレイ結果、stable 選択を示しません。 + +::: + +他の条件を満たし、アクティビティで失敗した実行では、新しいソースはその失敗前に完了した単純タイマーを受け入れます。一意のステップに、元の `timer_id` が一致する順序どおりの `TimerScheduled` / `TimerFired` が正確に一組必要です。後続実行は新しい共通タイマー ID でペアを書き込み、タイマー行やタイマータスクを作らず、再度タイマーを待たずに失敗したアクティビティから再開します。元の履歴は変更されません。 + +再利用した `TimerFired` の `reused_from_run_id` は直接の前実行を指します。`reused_recorded_at` は繰り返しの redrive でも元のタイマーイベント時刻を保持します。再利用アクティビティやマーカーも、フォールバッククロックを初めて書く際に利用可能な小数精度をすべて保持します。初期リプレイアンカーは永続化した元実行の開始時刻で、`replayed_started_at` として引き継がれます。消費したステップはイベント時刻を基準にします。繰り返しの redrive は記録済みクロック文字列と既存の初期アンカーを保持します。古い producer が省略した小数部は復元できません。期限の書式は変わりません。 + +| 拒否 | 新しいソースが保持するタイマーの境界 | +| --- | --- | +| `unsupported_timer` | scope、並列グループ、キャンセル cleanup、条件、シグナルタイムアウトのタイマーは単純タイマーの対象外です。 | +| `incomplete_timer_step` | ステップのイベント不足、逆順、重複、または元タイマー ID の不在、文字列以外、不一致があります。 | + +キャンセル済みタイマーは引き続き `unsupported_history` です。ステップの衝突、欠落、無効な失敗境界は既存の明示的な拒否を維持します。定義/フィンガープリント、親/ローカルアクティビティ、外部ペイロード、ワークフロー内 upsert の制限も維持します。この範囲はシグナル、更新、子ワークフローの native redrive を追加しません。Describe と redrive は構造上の適格性を共有し、redrive リクエスト時には既存の Worker フィンガープリント比較も適用します。 + +[実際の PHP/Python/Rust コールド Worker コホート](https://github.com/durable-workflow/server/issues/980#issuecomment-6865541932)は、コールド置換と繰り返し redrive で同じワークフロー定義/フィンガープリントを維持する必要があります。非ゼロ小数部を持つ元の `TimerFired` の観測時刻と、完全精度で解析した UTC 時点を比較し、元履歴を保持して元の callback 数、新しいタイマー ID、タイマー処理の再実行がないことを確認します。秒単位の表示では精度を検証できず、その結果を作るためにインストール済み環境の履歴を書き換えてはいけません。制御した時刻を使うソーステストは別の証拠です。 + +不変の producer/platform/source の資格検証、対象となるインストール済み SDK の記録、実際の Chart 公開が stable 採用に先行します。[Core の精度/参照の追跡](https://github.com/durable-workflow/workflow/issues/992)は [Server #980](https://github.com/durable-workflow/server/issues/980) の下で別扱いです。この変更は通常エントリーのクロック対応を宣言しない SDK にその対応を追加しません。変更のない SDK は番号合わせだけのリリースを必要としません。プロトコル、OpenAPI、カタログの形は変わりません。 + ## 名前空間とストレージ {#namespace-and-storage} 名前空間ルートは operator または admin ロールが必要です。名前空間と外部ストレージの変更には admin ロールが必要です。 diff --git a/i18n/ja/source-hashes.json b/i18n/ja/source-hashes.json index 7ef1a28e1e1..1af763ca1cf 100644 --- a/i18n/ja/source-hashes.json +++ b/i18n/ja/source-hashes.json @@ -29,7 +29,7 @@ "defining-workflows/workflow-status.md": "8e8cb27ff44c890d489d89bf166375acfdfaecabd990a2235e106fab1592d529", "defining-workflows/workflows.md": "f467bc73de32aa5d722c61ce085065460382ae7dd44cea4625847d9fcdc4c97c", "deployment.md": "1dd901213228a52e6222a15c6b85305098a4a4db06f198e319a7889c4562bddb", - "failures-and-recovery.md": "a240727af9539cca9cceb6ab3ddea545c95f21402813365442929ea05c09e70c", + "failures-and-recovery.md": "877e8ebafa056e78d2603e1d0339cc6f61fdffd6368f984ba043e1b752ee961c", "features/activity-execution-model.md": "e8c37520ae46a7efb30438f4fc06bf893c1df430cb1f92c48963697adaf09082", "features/cancel-and-terminate.md": "cedd1e6c51dfa551e00edc1d39739ff1f67d558d2a0be92143f478cb6111536b", "features/child-workflows.md": "30dd8e1a131654d6320641446b6bd661f27cd591353a60d007574955749cf8fb", @@ -88,7 +88,7 @@ "polyglot/runtime-migration.md": "5a78713bb8cb74aea58f6d5d826400d968a405f69c6ff17fdf2f7decb1d14b71", "polyglot/rust-cloud-quickstart.md": "2303434fc9302a81a8381ad4836423ef9952eb3201a4574c432254e3cb68c5f3", "polyglot/rust.md": "602f61be5ec561f27845d4ca0657d71c8f6cc3f08e30d1f657bd62c23dc53314", - "polyglot/server-api-reference.md": "d3f148fc8a12a315d695d47108ce658c80dea78c314b650a3b86f08727a20aee", + "polyglot/server-api-reference.md": "9d671a8c63682069f8c12b2ad71b50ca81900628643dec30bd70ee373b3388e0", "polyglot/server-config-reference.md": "aec241c0046f12a9d6efe2d6c1de443d7753bdf34135e06a6f83b3904ed1d429", "polyglot/server-role-topology.md": "3d048f0c6b5f179399622508f51e67fff8aa5a6d5b2492533fc720eeec2c27f2", "polyglot/server.md": "f24fd7ff4eebcc768ec8105e8689ab1a14cc08d98167090ebb84e3e26631132a", diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/failures-and-recovery.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/failures-and-recovery.md index 01cc86d323b..8f81625d9a9 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/failures-and-recovery.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/failures-and-recovery.md @@ -266,7 +266,7 @@ Versões do Workflow anteriores à 2.18.0 aceitam um conjunto menor de execuçõ Versões anteriores à 2.19.0 ignoram `reused_recorded_at` em passos reutilizados de sinal, memo e atributo de busca. Depois que um sucessor do Workflow 2.19.0 ou posterior reutilizar esses passos, mantenha workers 2.19.0 ou posteriores, ou confirme que nenhum histórico assim pode ser reproduzido, antes de voltar de versão. No modo embarcado, o Workflow 2.19.0 reproduz, importa e retoma um sucessor do 2.20.0 que reutilizou um update ou uma espera de sinal encadeada do mesmo jeito que o 2.20.0 ([comprovante de qualificação](https://github.com/durable-workflow/workflow/issues/864#issuecomment-6617902412)). -A partir do 3.7.0, o redrive no Server nativo leva para a execução sucessora os memos e atributos de busca definidos no início, e `describe()` informa `can_redrive` e `redrive_blocked_reason` em `actions`. A partir do 3.8.0, ele também reutiliza efeitos colaterais e marcadores de versão anteriores ao passo com falha, registrando cada um com seu payload original, `reused_from_run_id` e `reused_recorded_at`, então o horário do workflow depois deles corresponde ao da execução com falha. Um Server 3.8.0 recusa o redrive de uma execução cujo código do workflow atualizou um memo ou atributo de busca (`service_redrive_history_not_qualified`) ou cujo resultado de efeito colateral é armazenado externamente (`external_side_effect_result_not_supported`). Fora isso, ele ainda aplica as regras anteriores à 2.18.0, então um timer disparado ainda é recusado com `unsupported_history`. O suporte do Server nativo às regras restantes é acompanhado em [server#980](https://github.com/durable-workflow/server/issues/980). +Desde 3.7.0, o redrive do Server nativo leva ao sucessor memos e atributos de busca definidos no início, e `describe()` informa `can_redrive` e `redrive_blocked_reason` em `actions`. Desde 3.8.0 também reutiliza efeitos colaterais e marcadores de versão anteriores ao passo que falhou, registrando payload original, `reused_from_run_id` e `reused_recorded_at`. As versões nativas 3.8.0–3.10.x preservam strings existentes de timestamps reutilizados, mas escrevem novos relógios de fallback em segundos inteiros; isso não comprova igualdade fracionária do relógio de replay. Essas versões recusam upserts de memo/atributo no código do workflow (`service_redrive_history_not_qualified`), resultados externos de efeitos colaterais (`external_side_effect_result_not_supported`) e temporizadores disparados (`unsupported_history`). A [correção pendente de temporizadores simples e precisão do relógio](./polyglot/server-api-reference.md#native-redrive-timers) tem condições próprias de publicação e SDK instalado. O trabalho de precisão/referência do Core e a paridade nativa restante continuam em [server#980](https://github.com/durable-workflow/server/issues/980). ## Recusa de entrada e recuperação no modo de serviço {#service-entry-recovery} diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md index 7e5111db3fd..fdec52174d6 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md @@ -481,6 +481,29 @@ Rotas por execução rejeitam explicitamente destinos históricos ou incorretos: Os comandos levam valores de negócio em envelopes Avro. Os SDKs oficiais os codificam automaticamente. Um cliente HTTP direto deve usar o envelope `{codec, blob}` do codificador Avro oficial ou a referência do runtime abaixo. O documento HTTP externo é JSON; JSON de negócio sem codificação não é um codec alternativo. +### Redrive nativo de temporizadores disparados e relógios de replay {#native-redrive-timers} + +:::note Publicação nativa e qualificação dos consumidores pendentes + +A extensão de temporizadores simples e a correção de precisão fracionária foram integradas no [código do Server 5221ed82](https://github.com/durable-workflow/server/pull/1215). A [preparação da versão](https://github.com/durable-workflow/server/pull/1218) nativa 3.11.0 também foi integrada; publicação e qualificação dos consumidores continuam pendentes. O Server publicado selecionado mantém a recusa de temporizadores e a escrita de relógios anteriores. Esta descrição de código não comprova produtor publicado, resultado de replay do SDK ou seleção estável. + +::: + +Para uma execução elegível que falhou em uma atividade, o novo código aceita um temporizador simples concluído antes da falha. Seu passo único deve conter exatamente um par ordenado `TimerScheduled` / `TimerFired` com a mesma `timer_id` de origem. O sucessor escreve o par com um novo ID compartilhado, não cria linha nem tarefa de temporizador e continua na atividade que falhou sem aguardar o temporizador novamente. O histórico de origem permanece intacto. + +O `TimerFired` reutilizado identifica o predecessor imediato em `reused_from_run_id`. Seu `reused_recorded_at` preserva o instante original do evento entre redrives repetidos. Atividades e marcadores reutilizados também preservam toda a precisão fracionária disponível na primeira escrita de um relógio de fallback. A âncora inicial de replay vem do início persistido da execução de origem e é transportada em `replayed_started_at`; passos consumidos usam a autoridade temporal de seus eventos. Redrives repetidos preservam as strings de relógio já gravadas e a âncora inicial existente. Frações omitidas por produtores antigos não podem ser reconstruídas. A formatação de deadlines não muda. + +| Recusa | Limite de temporizador mantido pelo novo código | +| --- | --- | +| `unsupported_timer` | Temporizadores de scope, grupo paralelo, limpeza de cancelamento, condição ou timeout de sinal estão fora do escopo de temporizadores simples. | +| `incomplete_timer_step` | Falta um evento, os eventos estão invertidos ou duplicados, ou IDs de origem estão ausentes, não são strings ou não correspondem. | + +Temporizadores cancelados continuam como `unsupported_history`. Colisões de passos, lacunas e limites de falha inválidos mantêm suas recusas explícitas. Limites de definição/fingerprint, pai/atividade local, payload externo e upserts no workflow continuam válidos. Este trabalho não adiciona redrive nativo a sinais, atualizações ou workflows filhos. Describe e redrive compartilham elegibilidade estrutural; a comparação de fingerprint do worker continua sendo aplicada ao solicitar redrive. + +A [coorte real de workers frios PHP/Python/Rust](https://github.com/durable-workflow/server/issues/980#issuecomment-6865541932) deve manter a mesma definição/fingerprint durante substituição fria e redrives repetidos. Ela compara instantes UTC analisados com precisão completa contra um `TimerFired` de origem observado com fração não nula, preserva o histórico de origem e verifica contagens originais de callbacks, nova identidade do temporizador e ausência de trabalho repetido. Renderizar segundos inteiros não comprova essa precisão; o histórico instalado não pode ser reescrito para fornecê-la. Testes de código com timestamps controlados são evidências separadas. + +A qualificação do produtor/plataforma/código imutáveis, os recibos instalados aplicáveis de SDK e a publicação real do Chart precedem a adoção estável. O [trabalho de precisão/referência do Core](https://github.com/durable-workflow/workflow/issues/992) continua separado sob [Server #980](https://github.com/durable-workflow/server/issues/980). A mudança não adiciona relógios de entrada comum a um SDK que não os anuncia; SDKs inalterados não precisam de versão nova só para alinhar números. As formas de protocolo, OpenAPI e catálogo permanecem iguais. + ## Namespace e armazenamento {#namespace-and-storage} Rotas de namespace exigem operator ou admin. Rotas que alteram namespace e diff --git a/i18n/pt-BR/source-hashes.json b/i18n/pt-BR/source-hashes.json index 7ef1a28e1e1..1af763ca1cf 100644 --- a/i18n/pt-BR/source-hashes.json +++ b/i18n/pt-BR/source-hashes.json @@ -29,7 +29,7 @@ "defining-workflows/workflow-status.md": "8e8cb27ff44c890d489d89bf166375acfdfaecabd990a2235e106fab1592d529", "defining-workflows/workflows.md": "f467bc73de32aa5d722c61ce085065460382ae7dd44cea4625847d9fcdc4c97c", "deployment.md": "1dd901213228a52e6222a15c6b85305098a4a4db06f198e319a7889c4562bddb", - "failures-and-recovery.md": "a240727af9539cca9cceb6ab3ddea545c95f21402813365442929ea05c09e70c", + "failures-and-recovery.md": "877e8ebafa056e78d2603e1d0339cc6f61fdffd6368f984ba043e1b752ee961c", "features/activity-execution-model.md": "e8c37520ae46a7efb30438f4fc06bf893c1df430cb1f92c48963697adaf09082", "features/cancel-and-terminate.md": "cedd1e6c51dfa551e00edc1d39739ff1f67d558d2a0be92143f478cb6111536b", "features/child-workflows.md": "30dd8e1a131654d6320641446b6bd661f27cd591353a60d007574955749cf8fb", @@ -88,7 +88,7 @@ "polyglot/runtime-migration.md": "5a78713bb8cb74aea58f6d5d826400d968a405f69c6ff17fdf2f7decb1d14b71", "polyglot/rust-cloud-quickstart.md": "2303434fc9302a81a8381ad4836423ef9952eb3201a4574c432254e3cb68c5f3", "polyglot/rust.md": "602f61be5ec561f27845d4ca0657d71c8f6cc3f08e30d1f657bd62c23dc53314", - "polyglot/server-api-reference.md": "d3f148fc8a12a315d695d47108ce658c80dea78c314b650a3b86f08727a20aee", + "polyglot/server-api-reference.md": "9d671a8c63682069f8c12b2ad71b50ca81900628643dec30bd70ee373b3388e0", "polyglot/server-config-reference.md": "aec241c0046f12a9d6efe2d6c1de443d7753bdf34135e06a6f83b3904ed1d429", "polyglot/server-role-topology.md": "3d048f0c6b5f179399622508f51e67fff8aa5a6d5b2492533fc720eeec2c27f2", "polyglot/server.md": "f24fd7ff4eebcc768ec8105e8689ab1a14cc08d98167090ebb84e3e26631132a", diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/failures-and-recovery.md b/i18n/uk/docusaurus-plugin-content-docs/current/failures-and-recovery.md index 2df60014881..f908f477e7d 100644 --- a/i18n/uk/docusaurus-plugin-content-docs/current/failures-and-recovery.md +++ b/i18n/uk/docusaurus-plugin-content-docs/current/failures-and-recovery.md @@ -266,7 +266,7 @@ Workflow 2.18.0 повторно використовує завершені act Релізи до 2.19.0 ігнорують `reused_recorded_at` на повторно використаних кроках signal, memo й атрибутів пошуку. Після того як наступник із Workflow 2.19.0 чи новішого повторно використав ці кроки, залиште worker 2.19.0 чи новіші або переконайтеся перед відкатом, що жодна така історія не може відтворюватися в replay. У вбудованому режимі Workflow 2.19.0 відтворює, імпортує й продовжує наступника з 2.20.0, який повторно використав update чи ланцюжкове очікування signal, так само як 2.20.0 ([звіт кваліфікації](https://github.com/durable-workflow/workflow/issues/864#issuecomment-6617902412)). -Починаючи з 3.7.0, redrive у нативному Server переносить до наступника memo та атрибути пошуку, задані під час старту, а `describe()` повідомляє `can_redrive` і `redrive_blocked_reason` в `actions`. Починаючи з 3.8.0, він також повторно використовує побічні ефекти та маркери версій до кроку зі збоєм, записуючи кожен із початковим payload, `reused_from_run_id` і `reused_recorded_at`, тож час workflow після них збігається з часом у run зі збоєм. Server 3.8.0 відхиляє redrive запуску, код workflow якого оновив memo або атрибут пошуку (`service_redrive_history_not_qualified`) або результат побічного ефекту якого зберігається зовні (`external_side_effect_result_not_supported`). В іншому він і далі застосовує правила, що діяли до 2.18.0, тому таймер, що спрацював, і далі відхиляється з `unsupported_history`. Підтримку решти правил у нативному Server відстежує [server#980](https://github.com/durable-workflow/server/issues/980). +Починаючи з 3.7.0 native Server redrive переносить задані при старті memo й атрибути пошуку до наступника, а `describe()` повертає `can_redrive` та `redrive_blocked_reason` у `actions`. З 3.8.0 він також повторно використовує side effects і маркери версій перед помилковим кроком, записуючи початковий payload, `reused_from_run_id` та `reused_recorded_at`. Native 3.8.0–3.10.x зберігає наявні рядки повторно використаних часових позначок, але записує нові fallback-годинники цілими секундами, тому ці записи не доводять дробову рівність годинника replay. Ці релізи відмовляють у memo/search-attribute upsert з workflow-коду (`service_redrive_history_not_qualified`), зовнішніх результатах side effect (`external_side_effect_result_not_supported`) і спрацьованих timer (`unsupported_history`). [Очікуване native-виправлення простих timer і точності годинника](./polyglot/server-api-reference.md#native-redrive-timers) має окремі умови публікації та встановленого SDK. Супровід точності/посилань Core і решта native-паритету залишаються в [server#980](https://github.com/durable-workflow/server/issues/980). ## Відмова входу та відновлення в сервісному режимі {#service-entry-recovery} diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md b/i18n/uk/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md index 9d52b280854..2f7f2a8c68f 100644 --- a/i18n/uk/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md +++ b/i18n/uk/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md @@ -458,6 +458,29 @@ Server також надає кооперативні маршрути `request- Команди передають бізнес-значення в Avro-конвертах. SDK першої сторони кодують їх автоматично. Прямий HTTP-клієнт має використовувати конверт `{codec, blob}` офіційного Avro-кодувальника або посилання runtime нижче. Зовнішній HTTP-документ є JSON; звичайний бізнес-JSON не є іншим кодеком даних. +### Native redrive спрацьованих timer і годинники replay {#native-redrive-timers} + +:::note Native-публікація та кваліфікація споживачів очікуються + +Розширення простих timer і виправлення дробової точності вже злиті в [Server-коді 5221ed82](https://github.com/durable-workflow/server/pull/1215). [Підготовка native-релізу 3.11.0](https://github.com/durable-workflow/server/pull/1218) також злита, але публікація та кваліфікація споживачів ще очікуються. Вибраний опублікований Server зберігає попередню відмову timer і поведінку запису годинника. Цей опис коду не доводить наявність опублікованого producer, SDK replay-результату чи stable-вибору. + +::: + +Для інакше придатного запуску, який завершився помилкою в activity, новий код приймає простий timer, завершений перед помилкою. Його унікальний крок повинен містити рівно одну впорядковану пару `TimerScheduled` / `TimerFired` з однаковим початковим `timer_id`. Наступник записує пару з одним новим спільним timer ID, не створює timer-рядка чи timer-завдання й продовжує з activity, що зазнала помилки, без повторного очікування timer. Початкова історія не змінюється. + +Повторно використаний `TimerFired` називає безпосереднього попередника в `reused_from_run_id`. Його `reused_recorded_at` зберігає початковий час timer-події під час повторних redrive. Повторно використані activity та маркери також зберігають усю доступну дробову точність при першому записі fallback-годинника. Початковий якір replay походить зі збереженого часу початку вихідного запуску й передається в `replayed_started_at`; спожиті кроки використовують авторитетний час своїх подій. Повторні redrive зберігають уже записані часові рядки й наявний початковий якір. Пропущені старим producer частки неможливо відновити. Формат deadline не змінюється. + +| Відмова | Межа timer, збережена новим кодом | +| --- | --- | +| `unsupported_timer` | Timer scope, паралельної групи, очищення скасування, умови чи timeout очікування signal не входить до цього обсягу простих timer. | +| `incomplete_timer_step` | У кроці timer бракує події, події переставлені або повторені, або початкові timer ID відсутні, не є рядками чи не збігаються. | + +Скасовані timer залишаються `unsupported_history`. Колізії кроків, пропуски й недійсні межі помилки зберігають свої явні відмови. Межі визначення/fingerprint, батьківського/local-activity, зовнішнього payload та upsert із workflow-коду залишаються чинними. Цей обсяг не додає native redrive для signal, update чи дочірніх workflow. Describe і redrive мають спільну структурну придатність; при запиті redrive також діє порівняння fingerprint worker. + +[Фактична когорта холодних PHP/Python/Rust worker](https://github.com/durable-workflow/server/issues/980#issuecomment-6865541932) має зберігати те саме визначення/fingerprint workflow під час холодної заміни й повторних redrive. Вона порівнює розібрані UTC-моменти повної точності зі спостереженим початковим `TimerFired` із ненульовою часткою, зберігає початкову історію та перевіряє початкову кількість callbacks, нову timer-ідентичність і відсутність повторної timer-роботи. Відображення цілих секунд не доводить такої точності; встановлену історію не можна переписувати заради результату. Source-тести з керованими часовими позначками є окремим доказом. + +Кваліфікація незмінних producer/platform/source, відповідні встановлені SDK-результати та фактична публікація Chart передують stable-адаптації. [Супровід точності/посилань Core](https://github.com/durable-workflow/workflow/issues/992) залишається окремим під [Server #980](https://github.com/durable-workflow/server/issues/980). Зміна не додає підтримки годинника ordinary-entry до SDK, який її не оголошує; незміненим SDK не потрібен реліз лише для вирівнювання номерів. Форми протоколу, OpenAPI й каталогу не змінюються. + ## Namespace і сховище {#namespace-and-storage} Маршрути namespace вимагають operator чи admin. Зміни namespace та diff --git a/i18n/uk/source-hashes.json b/i18n/uk/source-hashes.json index 7ef1a28e1e1..1af763ca1cf 100644 --- a/i18n/uk/source-hashes.json +++ b/i18n/uk/source-hashes.json @@ -29,7 +29,7 @@ "defining-workflows/workflow-status.md": "8e8cb27ff44c890d489d89bf166375acfdfaecabd990a2235e106fab1592d529", "defining-workflows/workflows.md": "f467bc73de32aa5d722c61ce085065460382ae7dd44cea4625847d9fcdc4c97c", "deployment.md": "1dd901213228a52e6222a15c6b85305098a4a4db06f198e319a7889c4562bddb", - "failures-and-recovery.md": "a240727af9539cca9cceb6ab3ddea545c95f21402813365442929ea05c09e70c", + "failures-and-recovery.md": "877e8ebafa056e78d2603e1d0339cc6f61fdffd6368f984ba043e1b752ee961c", "features/activity-execution-model.md": "e8c37520ae46a7efb30438f4fc06bf893c1df430cb1f92c48963697adaf09082", "features/cancel-and-terminate.md": "cedd1e6c51dfa551e00edc1d39739ff1f67d558d2a0be92143f478cb6111536b", "features/child-workflows.md": "30dd8e1a131654d6320641446b6bd661f27cd591353a60d007574955749cf8fb", @@ -88,7 +88,7 @@ "polyglot/runtime-migration.md": "5a78713bb8cb74aea58f6d5d826400d968a405f69c6ff17fdf2f7decb1d14b71", "polyglot/rust-cloud-quickstart.md": "2303434fc9302a81a8381ad4836423ef9952eb3201a4574c432254e3cb68c5f3", "polyglot/rust.md": "602f61be5ec561f27845d4ca0657d71c8f6cc3f08e30d1f657bd62c23dc53314", - "polyglot/server-api-reference.md": "d3f148fc8a12a315d695d47108ce658c80dea78c314b650a3b86f08727a20aee", + "polyglot/server-api-reference.md": "9d671a8c63682069f8c12b2ad71b50ca81900628643dec30bd70ee373b3388e0", "polyglot/server-config-reference.md": "aec241c0046f12a9d6efe2d6c1de443d7753bdf34135e06a6f83b3904ed1d429", "polyglot/server-role-topology.md": "3d048f0c6b5f179399622508f51e67fff8aa5a6d5b2492533fc720eeec2c27f2", "polyglot/server.md": "f24fd7ff4eebcc768ec8105e8689ab1a14cc08d98167090ebb84e3e26631132a", diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/failures-and-recovery.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/failures-and-recovery.md index 1197a8a2646..3d0c21d9092 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/failures-and-recovery.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/failures-and-recovery.md @@ -261,7 +261,7 @@ Workflow 2.18.0 会复用已完成的活动、副作用、版本标记和已触 2.19.0 之前的版本会忽略复用的信号、备忘录和搜索属性步骤上的 `reused_recorded_at`。在 Workflow 2.19.0 或更高版本的后继运行复用这些步骤之后,请继续使用 2.19.0 或更高版本的 Worker,或在回滚前确认没有这样的历史会被重放。在嵌入模式下,对于复用了更新或链式信号等待的 2.20.0 后继运行,Workflow 2.19.0 的重放、导入和恢复方式与 2.20.0 相同([验证记录](https://github.com/durable-workflow/workflow/issues/864#issuecomment-6617902412))。 -从 3.7.0 起,原生 Server 的 redrive 会将启动时设置的备忘录和搜索属性传递给后继运行,`describe()` 会在 `actions` 下报告 `can_redrive` 和 `redrive_blocked_reason`。从 3.8.0 起,它还会复用失败步骤之前的副作用和版本标记,并以原始负载、`reused_from_run_id` 和 `reused_recorded_at` 记录每一项,因此其后的工作流时间与失败的运行一致。如果运行的工作流代码 upsert 过备忘录或搜索属性(`service_redrive_history_not_qualified`),或其副作用结果存储在外部(`external_side_effect_result_not_supported`),Server 3.8.0 会拒绝对该运行执行 redrive。除此之外,它仍适用 2.18.0 之前的规则,因此已触发的计时器仍会以 `unsupported_history` 被拒绝。原生 Server 对其余规则的支持在 [server#980](https://github.com/durable-workflow/server/issues/980) 中跟踪。 +从 3.7.0 起,原生 Server 重驱动将启动时设置的 memo 和搜索属性传给后继运行,`describe()` 在 `actions` 下报告 `can_redrive` 与 `redrive_blocked_reason`。从 3.8.0 起还复用失败步骤之前的副作用与版本标记,记录原始载荷、`reused_from_run_id` 和 `reused_recorded_at`。原生 3.8.0–3.10.x 保留已有复用时间戳字符串,但写入新的回退时钟时只保留整秒,因此这些写入不能证明重放时钟的小数精度相等。这些版本拒绝工作流代码的 memo/搜索属性 upsert(`service_redrive_history_not_qualified`)、外部保存的副作用结果(`external_side_effect_result_not_supported`)以及已触发定时器(`unsupported_history`)。[等待中的原生简单定时器与时钟精度修复](./polyglot/server-api-reference.md#native-redrive-timers)有独立的发布和已安装 SDK 验证条件。Core 的精度/参考后续工作及剩余原生一致性仍在 [server#980](https://github.com/durable-workflow/server/issues/980) 跟踪。 ## 服务模式入口拒绝与恢复 {#service-entry-recovery} diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md index 47d345be764..b03688a0190 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md @@ -351,6 +351,29 @@ Server 也提供协作式 `request-cancellation` 路由。有时限清理契约 命令通过 Avro 负载封装传递业务值,官方 SDK 自动完成编码。直接 HTTP 客户端必须使用官方 Avro 编码器的 `{codec, blob}` 封装,或下述运行时外部引用。外围 HTTP 文档是 JSON,但原始业务 JSON 不是另一种负载编解码格式。 +### 原生已触发定时器重驱动与重放时钟 {#native-redrive-timers} + +:::note 等待原生发布与消费者资格验证 + +简单定时器扩展和小数精度修复已合入 [Server 源码 5221ed82](https://github.com/durable-workflow/server/pull/1215)。原生 3.11.0 的[发布准备](https://github.com/durable-workflow/server/pull/1218)也已合并,但发布与消费者资格验证仍未完成。当前选定的已发布 Server 保留此前的定时器拒绝和时钟写入行为。此源码说明不代表已有已发布生产者、SDK 重放结果或稳定选择。 + +::: + +对于其他条件合格、在活动处失败的运行,新源码接受失败之前已完成的简单定时器。其唯一的步骤必须恰好包含一对按顺序排列的 `TimerScheduled` / `TimerFired`,且源 `timer_id` 相同。后继运行用一个新的共享定时器 ID 写入这对事件,不创建定时器行或任务,并从失败活动处恢复,不再等待该定时器。源历史保持不变。 + +复用的 `TimerFired` 在 `reused_from_run_id` 中指向直接前驱。其 `reused_recorded_at` 在重复重驱动中保留原始定时器事件时刻。复用活动和标记在首次写入回退时钟时也保留全部可用小数精度。初始重放锚点来自持久化的源运行开始时刻,通过 `replayed_started_at` 传递;已消费步骤使用各自事件时间作为权威。重复重驱动保留已记录时钟字符串和已有初始锚点。旧生产者省略的小数部分无法重建。截止时间格式不变。 + +| 拒绝原因 | 新源码保留的定时器边界 | +| --- | --- | +| `unsupported_timer` | scope、并行组、取消清理、条件或信号超时定时器不属于简单定时器范围。 | +| `incomplete_timer_step` | 定时器步骤缺少事件、事件逆序或重复,或源定时器 ID 缺失、不是字符串或不匹配。 | + +已取消定时器仍为 `unsupported_history`。步骤冲突、缺口和无效失败边界继续使用现有明确拒绝。定义/指纹、父级/本地活动、外部载荷和工作流代码 upsert 限制仍适用。此范围不为信号、更新或子工作流增加原生重驱动支持。Describe 与重驱动共享结构资格;请求重驱动时仍执行现有 Worker 指纹比较。 + +[实际 PHP/Python/Rust 冷 Worker 验证组](https://github.com/durable-workflow/server/issues/980#issuecomment-6865541932)必须在冷替换和重复重驱动期间保持相同工作流定义/指纹。它将完整精度解析的 UTC 时刻与实际观察到的、含非零小数部分的源 `TimerFired` 比较,保留源历史,并检查原始回调次数、新定时器标识以及没有重复定时器工作。仅显示整秒不能证明该精度;不得改写已安装环境的历史来制造结果。使用受控时间戳的源码测试是独立证据。 + +稳定采用之前必须完成不可变生产者/平台/源码资格验证、适用的已安装 SDK 回执以及实际 Chart 发布。[Core 的精度/参考后续工作](https://github.com/durable-workflow/workflow/issues/992)在 [Server #980](https://github.com/durable-workflow/server/issues/980) 下单独跟踪。该变更不会给未声明支持的 SDK 增加普通入口时钟支持;未修改的 SDK 无须仅为版本号对齐而发布。协议、OpenAPI 和目录结构不变。 + ## 命名空间与存储 {#namespace-and-storage} 命名空间路由要求 operator 或 admin 角色。变更命名空间及外部存储的路由要求 admin 角色。 diff --git a/i18n/zh-Hans/source-hashes.json b/i18n/zh-Hans/source-hashes.json index 7ef1a28e1e1..1af763ca1cf 100644 --- a/i18n/zh-Hans/source-hashes.json +++ b/i18n/zh-Hans/source-hashes.json @@ -29,7 +29,7 @@ "defining-workflows/workflow-status.md": "8e8cb27ff44c890d489d89bf166375acfdfaecabd990a2235e106fab1592d529", "defining-workflows/workflows.md": "f467bc73de32aa5d722c61ce085065460382ae7dd44cea4625847d9fcdc4c97c", "deployment.md": "1dd901213228a52e6222a15c6b85305098a4a4db06f198e319a7889c4562bddb", - "failures-and-recovery.md": "a240727af9539cca9cceb6ab3ddea545c95f21402813365442929ea05c09e70c", + "failures-and-recovery.md": "877e8ebafa056e78d2603e1d0339cc6f61fdffd6368f984ba043e1b752ee961c", "features/activity-execution-model.md": "e8c37520ae46a7efb30438f4fc06bf893c1df430cb1f92c48963697adaf09082", "features/cancel-and-terminate.md": "cedd1e6c51dfa551e00edc1d39739ff1f67d558d2a0be92143f478cb6111536b", "features/child-workflows.md": "30dd8e1a131654d6320641446b6bd661f27cd591353a60d007574955749cf8fb", @@ -88,7 +88,7 @@ "polyglot/runtime-migration.md": "5a78713bb8cb74aea58f6d5d826400d968a405f69c6ff17fdf2f7decb1d14b71", "polyglot/rust-cloud-quickstart.md": "2303434fc9302a81a8381ad4836423ef9952eb3201a4574c432254e3cb68c5f3", "polyglot/rust.md": "602f61be5ec561f27845d4ca0657d71c8f6cc3f08e30d1f657bd62c23dc53314", - "polyglot/server-api-reference.md": "d3f148fc8a12a315d695d47108ce658c80dea78c314b650a3b86f08727a20aee", + "polyglot/server-api-reference.md": "9d671a8c63682069f8c12b2ad71b50ca81900628643dec30bd70ee373b3388e0", "polyglot/server-config-reference.md": "aec241c0046f12a9d6efe2d6c1de443d7753bdf34135e06a6f83b3904ed1d429", "polyglot/server-role-topology.md": "3d048f0c6b5f179399622508f51e67fff8aa5a6d5b2492533fc720eeec2c27f2", "polyglot/server.md": "f24fd7ff4eebcc768ec8105e8689ab1a14cc08d98167090ebb84e3e26631132a", From 48f9cfaa9e0ab3d8b3b87445bf0e520ffc0b96d6 Mon Sep 17 00:00:00 2001 From: Richard McDaniel <1130888+rmcdaniel@users.noreply.github.com> Date: Sat, 14 Nov 2026 11:48:52 +0000 Subject: [PATCH 4/6] Distinguish qualified native image from pending stable adoption --- docs/failures-and-recovery.md | 2 +- docs/polyglot/server-api-reference.md | 6 +++--- .../current/failures-and-recovery.md | 2 +- .../current/polyglot/server-api-reference.md | 6 +++--- i18n/de/source-hashes.json | 4 ++-- .../current/failures-and-recovery.md | 2 +- .../current/polyglot/server-api-reference.md | 6 +++--- i18n/es/source-hashes.json | 4 ++-- .../current/failures-and-recovery.md | 2 +- .../current/polyglot/server-api-reference.md | 6 +++--- i18n/fr/source-hashes.json | 4 ++-- .../current/failures-and-recovery.md | 2 +- .../current/polyglot/server-api-reference.md | 6 +++--- i18n/ja/source-hashes.json | 4 ++-- .../current/failures-and-recovery.md | 2 +- .../current/polyglot/server-api-reference.md | 6 +++--- i18n/pt-BR/source-hashes.json | 4 ++-- .../current/failures-and-recovery.md | 2 +- .../current/polyglot/server-api-reference.md | 6 +++--- i18n/uk/source-hashes.json | 4 ++-- .../current/failures-and-recovery.md | 2 +- .../current/polyglot/server-api-reference.md | 6 +++--- i18n/zh-Hans/source-hashes.json | 4 ++-- 23 files changed, 46 insertions(+), 46 deletions(-) diff --git a/docs/failures-and-recovery.md b/docs/failures-and-recovery.md index 07d06809675..849f64483c1 100644 --- a/docs/failures-and-recovery.md +++ b/docs/failures-and-recovery.md @@ -264,7 +264,7 @@ Workflow releases before 2.18.0 accept a narrower set of runs. Every step before Releases before 2.19.0 ignore `reused_recorded_at` on reused signal, memo and search-attribute steps. After a Workflow 2.19.0 or later successor reuses those steps, keep 2.19.0 or later workers, or confirm that no such history can replay, before you roll back. In embedded mode, Workflow 2.19.0 replays, imports and resumes a 2.20.0 successor that reused an update or a chained signal wait the same way 2.20.0 does ([qualification receipt](https://github.com/durable-workflow/workflow/issues/864#issuecomment-6617902412)). -From 3.7.0, native Server redrive carries memos and search attributes set at start to the successor, and `describe()` reports `can_redrive` and `redrive_blocked_reason` under `actions`. From 3.8.0 it also reuses side effects and version markers before the failed step, recording each with its original payload, `reused_from_run_id` and `reused_recorded_at`. Native 3.8.0–3.10.x retains existing reuse timestamp strings but writes whole-second fallbacks for new reuse clocks, so those writes do not establish fractional replay-clock equality. These releases refuse workflow-code memo/search-attribute upserts (`service_redrive_history_not_qualified`), externally stored side-effect results (`external_side_effect_result_not_supported`) and fired timers (`unsupported_history`). The [pending native plain-timer and clock-precision correction](./polyglot/server-api-reference.md#native-redrive-timers) has separate publication and installed-SDK gates. Core's precision/reference follow-through and remaining native parity stay tracked in [server#980](https://github.com/durable-workflow/server/issues/980). +From 3.7.0, native Server redrive carries memos and search attributes set at start to the successor, and `describe()` reports `can_redrive` and `redrive_blocked_reason` under `actions`. From 3.8.0 it also reuses side effects and version markers before the failed step, recording each with its original payload, `reused_from_run_id` and `reused_recorded_at`. Native 3.8.0–3.10.x retains existing reuse timestamp strings but writes whole-second fallbacks for new reuse clocks, so those writes do not establish fractional replay-clock equality. These releases refuse workflow-code memo/search-attribute upserts (`service_redrive_history_not_qualified`), externally stored side-effect results (`external_side_effect_result_not_supported`) and fired timers (`unsupported_history`). The [native plain-timer and clock-precision extension](./polyglot/server-api-reference.md#native-redrive-timers) has a qualified immutable producer. Stable adoption still requires applicable installed-SDK receipts and Chart/release gates. Core's precision/reference follow-through and remaining native parity stay tracked in [server#980](https://github.com/durable-workflow/server/issues/980). ## Service Entry Refusal and Recovery {#service-entry-recovery} diff --git a/docs/polyglot/server-api-reference.md b/docs/polyglot/server-api-reference.md index 6f60fd59cdb..b6ac19330b4 100644 --- a/docs/polyglot/server-api-reference.md +++ b/docs/polyglot/server-api-reference.md @@ -503,9 +503,9 @@ HTTP document is JSON; raw business JSON is not an alternative payload codec. ### Native fired-timer redrive and replay clocks {#native-redrive-timers} -:::note Pending native publication and consumer qualification +:::note Pending stable adoption and installed consumers -The plain-timer extension and fractional-clock correction are merged in [Server source 5221ed82](https://github.com/durable-workflow/server/pull/1215). Native 3.11.0 [release preparation](https://github.com/durable-workflow/server/pull/1218) is also merged, while publication and consumer qualification remain pending. The selected published Server retains its earlier timer refusal and clock-writing behavior. This source description does not establish a published producer, SDK replay result or stable selection. +The plain-timer extension and fractional-clock correction are merged in [Server source 5221ed82](https://github.com/durable-workflow/server/pull/1215). Native 3.11.0 has a published immutable image and [accepted producer/platform/corpus/Compose qualification](https://github.com/durable-workflow/server/pull/1218#issuecomment-6868218894). Stable aliases, the final GitHub Release, Chart adoption and applicable installed-consumer evidence remain held. The selected published Server retains its earlier timer refusal and clock-writing behavior. Producer qualification alone does not establish an installed SDK replay result or stable selection. ::: @@ -522,7 +522,7 @@ Cancelled timers remain `unsupported_history`. Step collisions, gaps and invalid The [actual PHP/Python/Rust cold-worker cohort](https://github.com/durable-workflow/server/issues/980#issuecomment-6865541932) must retain the same workflow definition/fingerprint through cold replacement and repeated redrive. It compares parsed full-precision UTC instants against an observed nonzero-fraction source `TimerFired`, preserves source history, and checks original callback counts, fresh timer identity and absence of repeated timer work. Whole-second rendering cannot establish that precision result, and installed history must not be rewritten to supply it. Source-controlled timestamp tests are separate evidence. -Immutable producer/platform/source qualification, the applicable installed SDK receipts and actual Chart publication precede stable adoption. [Core's precision/reference follow-through](https://github.com/durable-workflow/workflow/issues/992) remains separate under [Server #980](https://github.com/durable-workflow/server/issues/980). The change adds no ordinary-entry clock support to an SDK that does not advertise it, and unchanged SDKs need no release solely to align version numbers. Protocol, OpenAPI and catalog shapes are unchanged. +The immutable producer/platform/source qualification has passed. Applicable installed SDK receipts, stable aliases/final Release and actual Chart publication still precede stable adoption. [Core's precision/reference follow-through](https://github.com/durable-workflow/workflow/issues/992) remains separate under [Server #980](https://github.com/durable-workflow/server/issues/980). The change adds no ordinary-entry clock support to an SDK that does not advertise it, and unchanged SDKs need no release solely to align version numbers. Protocol, OpenAPI and catalog shapes are unchanged. ## Namespace And Storage diff --git a/i18n/de/docusaurus-plugin-content-docs/current/failures-and-recovery.md b/i18n/de/docusaurus-plugin-content-docs/current/failures-and-recovery.md index fb6027c8723..adc904f8df7 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/failures-and-recovery.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/failures-and-recovery.md @@ -261,7 +261,7 @@ Workflow-Releases vor 2.18.0 nehmen weniger Läufe an. Jeder Schritt vor der feh Releases vor 2.19.0 ignorieren `reused_recorded_at` bei wiederverwendeten Signal-, Memo- und Suchattribut-Schritten. Nachdem ein Nachfolger aus Workflow 2.19.0 oder später diese Schritte wiederverwendet hat, behalten Sie Worker ab 2.19.0 bei oder stellen Sie vor einem Rollback sicher, dass keine solche Historie per Replay verarbeitet werden kann. Im Embedded-Modus verarbeitet Workflow 2.19.0 einen 2.20.0-Nachfolger, der ein Update oder eine verkettete Signalwarteoperation wiederverwendet hat, beim Replay, Import und Fortsetzen genauso wie 2.20.0 ([Qualifizierungsnachweis](https://github.com/durable-workflow/workflow/issues/864#issuecomment-6617902412)). -Seit 3.7.0 übernimmt natives Server-Redrive beim Start gesetzte Memos und Suchattribute in den Nachfolger, und `describe()` meldet `can_redrive` sowie `redrive_blocked_reason` unter `actions`. Seit 3.8.0 werden auch Side Effects und Versionsmarker vor dem fehlgeschlagenen Schritt mit ursprünglicher Payload, `reused_from_run_id` und `reused_recorded_at` wiederverwendet. Native 3.8.0–3.10.x erhalten vorhandene Wiederverwendungs-Zeitstempelstrings, schreiben aber neue Fallback-Uhren nur mit ganzen Sekunden. Diese Schreibvorgänge belegen keine Gleichheit von Sekundenbruchteilen beim Replay. Diese Releases verweigern Memo-/Suchattribut-Upserts aus Workflow-Code (`service_redrive_history_not_qualified`), extern gespeicherte Side-Effect-Ergebnisse (`external_side_effect_result_not_supported`) und ausgelöste Timer (`unsupported_history`). Die [ausstehende native Plain-Timer- und Uhrpräzisionskorrektur](./polyglot/server-api-reference.md#native-redrive-timers) hat separate Veröffentlichungs- und installierte SDK-Gates. Cores Präzisions-/Referenzarbeit und übrige native Parität bleiben in [server#980](https://github.com/durable-workflow/server/issues/980) erfasst. +Seit 3.7.0 übernimmt natives Server-Redrive beim Start gesetzte Memos und Suchattribute in den Nachfolger, und `describe()` meldet `can_redrive` sowie `redrive_blocked_reason` unter `actions`. Seit 3.8.0 werden auch Side Effects und Versionsmarker vor dem fehlgeschlagenen Schritt mit ursprünglicher Payload, `reused_from_run_id` und `reused_recorded_at` wiederverwendet. Native 3.8.0–3.10.x erhalten vorhandene Wiederverwendungs-Zeitstempelstrings, schreiben aber neue Fallback-Uhren nur mit ganzen Sekunden. Diese Schreibvorgänge belegen keine Gleichheit von Sekundenbruchteilen beim Replay. Diese Releases verweigern Memo-/Suchattribut-Upserts aus Workflow-Code (`service_redrive_history_not_qualified`), extern gespeicherte Side-Effect-Ergebnisse (`external_side_effect_result_not_supported`) und ausgelöste Timer (`unsupported_history`). Die [native Plain-Timer- und Uhrpräzisionserweiterung](./polyglot/server-api-reference.md#native-redrive-timers) hat einen qualifizierten unveränderlichen Producer. Stabile Übernahme benötigt weiterhin die jeweiligen installierten SDK-Belege und Chart-/Release-Gates. Cores Präzisions-/Referenzarbeit und übrige native Parität bleiben in [server#980](https://github.com/durable-workflow/server/issues/980) erfasst. ## Ablehnung am Einstieg im Servicemodus und Wiederherstellung {#service-entry-recovery} diff --git a/i18n/de/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md b/i18n/de/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md index 38fa361032e..35efde9d95c 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md @@ -487,9 +487,9 @@ Befehle übertragen Geschäftswerte in Avro-Envelopes. Die offiziellen SDKs codi ### Native Redrive ausgelöster Timer und Replay-Uhren {#native-redrive-timers} -:::note Native Veröffentlichung und Consumer-Qualifikation ausstehend +:::note Stabile Übernahme und installierte Consumer ausstehend -Die Plain-Timer-Erweiterung und Korrektur der Sekundenbruchteile sind in [Server-Quellstand 5221ed82](https://github.com/durable-workflow/server/pull/1215) zusammengeführt. Auch die [Release-Vorbereitung](https://github.com/durable-workflow/server/pull/1218) für native 3.11.0 ist zusammengeführt; Veröffentlichung und Consumer-Qualifikation stehen noch aus. Der ausgewählte veröffentlichte Server behält seine bisherige Timer-Ablehnung und Uhrschreibweise. Diese Quellbeschreibung belegt keinen veröffentlichten Producer, SDK-Replay-Erfolg oder stabile Auswahl. +Die Plain-Timer-Erweiterung und Bruchteilkorrektur sind in [Server-Quellstand 5221ed82](https://github.com/durable-workflow/server/pull/1215) zusammengeführt. Native 3.11.0 hat ein veröffentlichtes unveränderliches Image und eine [akzeptierte Producer-/Plattform-/Korpus-/Compose-Qualifikation](https://github.com/durable-workflow/server/pull/1218#issuecomment-6868218894). Stabile Aliasse, das endgültige GitHub Release, Chart-Übernahme und die jeweiligen installierten Consumer-Belege bleiben gesperrt. Der ausgewählte veröffentlichte Server behält seine bisherige Timer-Ablehnung und Uhrschreibweise. Die Producer-Qualifikation allein belegt keinen installierten SDK-Replay-Erfolg oder stabile Auswahl. ::: @@ -506,7 +506,7 @@ Abgebrochene Timer bleiben `unsupported_history`. Schritt-Kollisionen, Lücken u Die [tatsächliche PHP/Python/Rust-Cold-Worker-Kohorte](https://github.com/durable-workflow/server/issues/980#issuecomment-6865541932) muss bei kaltem Austausch und wiederholtem Redrive dieselbe Workflow-Definition und denselben Fingerprint erhalten. Sie vergleicht vollständig geparste UTC-Zeitpunkte mit einem beobachteten Quell-`TimerFired` mit nichtnull Sekundenbruchteil, erhält die Quellhistorie und prüft ursprüngliche Callback-Zahlen, neue Timer-Identität und ausbleibende erneute Timer-Arbeit. Eine Ganzsekundendarstellung belegt diese Präzision nicht; installierte Historie darf dafür nicht umgeschrieben werden. Quelltests mit kontrollierten Zeitstempeln sind separate Evidenz. -Unveränderliche Producer-/Plattform-/Quellqualifikation, die jeweiligen installierten SDK-Belege und die tatsächliche Chart-Veröffentlichung gehen stabiler Übernahme voraus. [Cores Präzisions-/Referenzarbeit](https://github.com/durable-workflow/workflow/issues/992) bleibt unter [Server #980](https://github.com/durable-workflow/server/issues/980) separat. Die Änderung ergänzt keine Ordinary-Entry-Uhrunterstützung in einem SDK, das sie nicht meldet; unveränderte SDKs benötigen keine bloße Versionsangleichungs-Release. Protokoll-, OpenAPI- und Katalogstrukturen bleiben unverändert. +Die unveränderliche Producer-/Plattform-/Quellqualifikation ist bestanden. Die jeweiligen installierten SDK-Belege, stabile Aliasse/endgültiges Release und die tatsächliche Chart-Veröffentlichung gehen weiterhin stabiler Übernahme voraus. [Cores Präzisions-/Referenzarbeit](https://github.com/durable-workflow/workflow/issues/992) bleibt unter [Server #980](https://github.com/durable-workflow/server/issues/980) separat. Die Änderung ergänzt keine Ordinary-Entry-Uhrunterstützung in einem SDK, das sie nicht meldet; unveränderte SDKs benötigen keine bloße Versionsangleichungs-Release. Protokoll-, OpenAPI- und Katalogstrukturen bleiben unverändert. ## Namespace und Speicher {#namespace-and-storage} diff --git a/i18n/de/source-hashes.json b/i18n/de/source-hashes.json index 7a23d28b290..a9762d682f5 100644 --- a/i18n/de/source-hashes.json +++ b/i18n/de/source-hashes.json @@ -29,7 +29,7 @@ "defining-workflows/workflow-status.md": "8e8cb27ff44c890d489d89bf166375acfdfaecabd990a2235e106fab1592d529", "defining-workflows/workflows.md": "f467bc73de32aa5d722c61ce085065460382ae7dd44cea4625847d9fcdc4c97c", "deployment.md": "1dd901213228a52e6222a15c6b85305098a4a4db06f198e319a7889c4562bddb", - "failures-and-recovery.md": "877e8ebafa056e78d2603e1d0339cc6f61fdffd6368f984ba043e1b752ee961c", + "failures-and-recovery.md": "5fca75a97d5a32501f0364140e38ff378bcf2fea0b7aeba792edb1322aac7648", "features/activity-execution-model.md": "e8c37520ae46a7efb30438f4fc06bf893c1df430cb1f92c48963697adaf09082", "features/cancel-and-terminate.md": "cedd1e6c51dfa551e00edc1d39739ff1f67d558d2a0be92143f478cb6111536b", "features/child-workflows.md": "30dd8e1a131654d6320641446b6bd661f27cd591353a60d007574955749cf8fb", @@ -88,7 +88,7 @@ "polyglot/runtime-migration.md": "5a78713bb8cb74aea58f6d5d826400d968a405f69c6ff17fdf2f7decb1d14b71", "polyglot/rust-cloud-quickstart.md": "2303434fc9302a81a8381ad4836423ef9952eb3201a4574c432254e3cb68c5f3", "polyglot/rust.md": "602f61be5ec561f27845d4ca0657d71c8f6cc3f08e30d1f657bd62c23dc53314", - "polyglot/server-api-reference.md": "9d671a8c63682069f8c12b2ad71b50ca81900628643dec30bd70ee373b3388e0", + "polyglot/server-api-reference.md": "7cf926b66298cd750837f9d7102bbd210e541e36ad89b5f9fbb7616f7581fb82", "polyglot/server-config-reference.md": "aec241c0046f12a9d6efe2d6c1de443d7753bdf34135e06a6f83b3904ed1d429", "polyglot/server-role-topology.md": "3d048f0c6b5f179399622508f51e67fff8aa5a6d5b2492533fc720eeec2c27f2", "polyglot/server.md": "f24fd7ff4eebcc768ec8105e8689ab1a14cc08d98167090ebb84e3e26631132a", diff --git a/i18n/es/docusaurus-plugin-content-docs/current/failures-and-recovery.md b/i18n/es/docusaurus-plugin-content-docs/current/failures-and-recovery.md index bd61b17aee4..e0501ddb7eb 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/failures-and-recovery.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/failures-and-recovery.md @@ -265,7 +265,7 @@ Las versiones de Workflow anteriores a 2.18.0 aceptan menos ejecuciones. Cada pa Las versiones anteriores a 2.19.0 ignoran `reused_recorded_at` en los pasos reutilizados de señal, memo y atributo de búsqueda. Después de que un sucesor de Workflow 2.19.0 o posterior reutilice esos pasos, mantenga workers de 2.19.0 o posteriores, o confirme que ningún historial así puede reproducirse, antes de volver atrás. En modo embebido, Workflow 2.19.0 reproduce, importa y reanuda un sucesor de 2.20.0 que reutilizó un update o una espera de señal encadenada igual que 2.20.0 ([comprobante de calificación](https://github.com/durable-workflow/workflow/issues/864#issuecomment-6617902412)). -Desde 3.7.0, el redrive del Server nativo transfiere al sucesor memos y atributos de búsqueda establecidos al inicio, y `describe()` informa `can_redrive` y `redrive_blocked_reason` bajo `actions`. Desde 3.8.0 también reutiliza efectos laterales y marcadores de versión previos al paso fallido, registrando payload original, `reused_from_run_id` y `reused_recorded_at`. Las versiones nativas 3.8.0–3.10.x conservan las cadenas de timestamps reutilizadas existentes, pero escriben respaldos de reloj nuevos con segundos enteros; esas escrituras no acreditan igualdad fraccionaria del reloj de replay. Rechazan upserts de memo/atributos desde el workflow (`service_redrive_history_not_qualified`), resultados de efectos laterales externos (`external_side_effect_result_not_supported`) y temporizadores disparados (`unsupported_history`). La [corrección pendiente de temporizadores simples y precisión del reloj](./polyglot/server-api-reference.md#native-redrive-timers) tiene sus propias condiciones de publicación y SDK instalado. El trabajo de precisión/referencia de Core y la paridad nativa restante siguen en [server#980](https://github.com/durable-workflow/server/issues/980). +Desde 3.7.0, el redrive del Server nativo transfiere al sucesor memos y atributos de búsqueda establecidos al inicio, y `describe()` informa `can_redrive` y `redrive_blocked_reason` bajo `actions`. Desde 3.8.0 también reutiliza efectos laterales y marcadores de versión previos al paso fallido, registrando payload original, `reused_from_run_id` y `reused_recorded_at`. Las versiones nativas 3.8.0–3.10.x conservan las cadenas de timestamps reutilizadas existentes, pero escriben respaldos de reloj nuevos con segundos enteros; esas escrituras no acreditan igualdad fraccionaria del reloj de replay. Rechazan upserts de memo/atributos desde el workflow (`service_redrive_history_not_qualified`), resultados de efectos laterales externos (`external_side_effect_result_not_supported`) y temporizadores disparados (`unsupported_history`). La [extensión nativa de temporizadores simples y precisión del reloj](./polyglot/server-api-reference.md#native-redrive-timers) tiene un productor inmutable validado. La adopción estable aún requiere los recibos instalados aplicables de SDK y las condiciones de Chart/release. El trabajo de precisión/referencia de Core y la paridad nativa restante siguen en [server#980](https://github.com/durable-workflow/server/issues/980). ## Rechazo de entrada y recuperación en modo servicio {#service-entry-recovery} diff --git a/i18n/es/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md b/i18n/es/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md index bd437bc4d8d..4ed6daa2116 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md @@ -354,9 +354,9 @@ Los comandos llevan valores de negocio en sobres Avro. Los SDK oficiales los cod ### Redrive nativo de temporizadores disparados y relojes de replay {#native-redrive-timers} -:::note Publicación nativa y validación de consumidores pendientes +:::note Adopción estable y consumidores instalados pendientes -La extensión de temporizadores simples y la corrección de precisión fraccionaria están integradas en el [código del Server 5221ed82](https://github.com/durable-workflow/server/pull/1215). También se integró la [preparación de versión](https://github.com/durable-workflow/server/pull/1218) nativa 3.11.0; la publicación y la validación de consumidores siguen pendientes. El Server publicado seleccionado conserva el rechazo de temporizadores y la escritura de relojes anteriores. Esta descripción de código no acredita un productor publicado, un resultado de replay del SDK ni una selección estable. +La extensión de temporizadores simples y la corrección fraccionaria están integradas en el [código del Server 5221ed82](https://github.com/durable-workflow/server/pull/1215). Native 3.11.0 tiene una imagen inmutable publicada y [validación aceptada de productor/plataforma/corpus/Compose](https://github.com/durable-workflow/server/pull/1218#issuecomment-6868218894). Siguen retenidos los alias estables, el GitHub Release final, la adopción del Chart y la evidencia instalada de consumidores aplicables. El Server publicado seleccionado conserva el rechazo de temporizadores y la escritura de relojes anteriores. La validación del productor por sí sola no acredita un resultado de replay del SDK instalado ni una selección estable. ::: @@ -373,7 +373,7 @@ Los temporizadores cancelados siguen siendo `unsupported_history`. Colisiones, h La [cohorte real de workers fríos PHP/Python/Rust](https://github.com/durable-workflow/server/issues/980#issuecomment-6865541932) debe mantener la misma definición/fingerprint durante el reemplazo frío y redrives repetidos. Compara instantes UTC analizados con precisión completa contra un `TimerFired` de origen observado con fracción no nula, conserva el historial de origen y comprueba los conteos originales de callbacks, la identidad nueva del temporizador y la ausencia de trabajo repetido. Mostrar segundos enteros no acredita esa precisión; no se puede reescribir el historial instalado para producirla. Las pruebas de código con timestamps controlados son evidencia separada. -La validación del productor/plataforma/código inmutables, los recibos instalados aplicables de SDK y la publicación real del Chart preceden a la adopción estable. El [trabajo de precisión/referencia de Core](https://github.com/durable-workflow/workflow/issues/992) sigue separado bajo [Server #980](https://github.com/durable-workflow/server/issues/980). El cambio no añade relojes en la entrada ordinaria a un SDK que no los anuncia; un SDK sin cambios no requiere una versión nueva solo para alinear números. Las formas de protocolo, OpenAPI y catálogo no cambian. +La validación inmutable de productor/plataforma/código ha pasado. Los recibos instalados aplicables de SDK, los alias estables/Release final y la publicación real del Chart siguen precediendo a la adopción estable. El [trabajo de precisión/referencia de Core](https://github.com/durable-workflow/workflow/issues/992) sigue separado bajo [Server #980](https://github.com/durable-workflow/server/issues/980). El cambio no añade relojes en la entrada ordinaria a un SDK que no los anuncia; un SDK sin cambios no requiere una versión nueva solo para alinear números. Las formas de protocolo, OpenAPI y catálogo no cambian. ## Espacios de nombres y almacenamiento {#namespace-and-storage} diff --git a/i18n/es/source-hashes.json b/i18n/es/source-hashes.json index 7a23d28b290..a9762d682f5 100644 --- a/i18n/es/source-hashes.json +++ b/i18n/es/source-hashes.json @@ -29,7 +29,7 @@ "defining-workflows/workflow-status.md": "8e8cb27ff44c890d489d89bf166375acfdfaecabd990a2235e106fab1592d529", "defining-workflows/workflows.md": "f467bc73de32aa5d722c61ce085065460382ae7dd44cea4625847d9fcdc4c97c", "deployment.md": "1dd901213228a52e6222a15c6b85305098a4a4db06f198e319a7889c4562bddb", - "failures-and-recovery.md": "877e8ebafa056e78d2603e1d0339cc6f61fdffd6368f984ba043e1b752ee961c", + "failures-and-recovery.md": "5fca75a97d5a32501f0364140e38ff378bcf2fea0b7aeba792edb1322aac7648", "features/activity-execution-model.md": "e8c37520ae46a7efb30438f4fc06bf893c1df430cb1f92c48963697adaf09082", "features/cancel-and-terminate.md": "cedd1e6c51dfa551e00edc1d39739ff1f67d558d2a0be92143f478cb6111536b", "features/child-workflows.md": "30dd8e1a131654d6320641446b6bd661f27cd591353a60d007574955749cf8fb", @@ -88,7 +88,7 @@ "polyglot/runtime-migration.md": "5a78713bb8cb74aea58f6d5d826400d968a405f69c6ff17fdf2f7decb1d14b71", "polyglot/rust-cloud-quickstart.md": "2303434fc9302a81a8381ad4836423ef9952eb3201a4574c432254e3cb68c5f3", "polyglot/rust.md": "602f61be5ec561f27845d4ca0657d71c8f6cc3f08e30d1f657bd62c23dc53314", - "polyglot/server-api-reference.md": "9d671a8c63682069f8c12b2ad71b50ca81900628643dec30bd70ee373b3388e0", + "polyglot/server-api-reference.md": "7cf926b66298cd750837f9d7102bbd210e541e36ad89b5f9fbb7616f7581fb82", "polyglot/server-config-reference.md": "aec241c0046f12a9d6efe2d6c1de443d7753bdf34135e06a6f83b3904ed1d429", "polyglot/server-role-topology.md": "3d048f0c6b5f179399622508f51e67fff8aa5a6d5b2492533fc720eeec2c27f2", "polyglot/server.md": "f24fd7ff4eebcc768ec8105e8689ab1a14cc08d98167090ebb84e3e26631132a", diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/failures-and-recovery.md b/i18n/fr/docusaurus-plugin-content-docs/current/failures-and-recovery.md index d2bc0808ce6..103fd7021a4 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/failures-and-recovery.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/failures-and-recovery.md @@ -269,7 +269,7 @@ Les versions de Workflow antérieures à 2.18.0 acceptent un ensemble plus restr Les versions antérieures à 2.19.0 ignorent `reused_recorded_at` sur les étapes de signal, de mémo et d’attribut de recherche réutilisées. Une fois qu’un successeur de Workflow 2.19.0 ou ultérieur a réutilisé ces étapes, gardez des workers 2.19.0 ou ultérieurs, ou vérifiez qu’aucun historique de ce type ne peut être rejoué, avant de revenir en arrière. En mode embarqué, Workflow 2.19.0 rejoue, importe et reprend un successeur 2.20.0 qui a réutilisé un update ou une attente de signal enchaînée de la même façon que 2.20.0 ([preuve de qualification](https://github.com/durable-workflow/workflow/issues/864#issuecomment-6617902412)). -Depuis 3.7.0, le redrive du Server natif transmet au successeur les memos et attributs de recherche définis au démarrage, et `describe()` expose `can_redrive` et `redrive_blocked_reason` sous `actions`. Depuis 3.8.0, il réutilise aussi les effets de bord et marqueurs de version précédant l’étape échouée, avec leur payload original, `reused_from_run_id` et `reused_recorded_at`. Les versions natives 3.8.0–3.10.x conservent les chaînes d’horodatage réutilisées existantes, mais écrivent les nouvelles horloges de repli en secondes entières ; cela ne prouve pas l’égalité fractionnaire des horloges de relecture. Elles refusent les upserts de memo/attribut dans le workflow (`service_redrive_history_not_qualified`), les résultats d’effets de bord externes (`external_side_effect_result_not_supported`) et les temporisateurs déclenchés (`unsupported_history`). La [correction native en attente des temporisateurs simples et de la précision d’horloge](./polyglot/server-api-reference.md#native-redrive-timers) conserve ses propres conditions de publication et de SDK installé. Le suivi de précision/référence de Core et la parité native restante restent dans [server#980](https://github.com/durable-workflow/server/issues/980). +Depuis 3.7.0, le redrive du Server natif transmet au successeur les memos et attributs de recherche définis au démarrage, et `describe()` expose `can_redrive` et `redrive_blocked_reason` sous `actions`. Depuis 3.8.0, il réutilise aussi les effets de bord et marqueurs de version précédant l’étape échouée, avec leur payload original, `reused_from_run_id` et `reused_recorded_at`. Les versions natives 3.8.0–3.10.x conservent les chaînes d’horodatage réutilisées existantes, mais écrivent les nouvelles horloges de repli en secondes entières ; cela ne prouve pas l’égalité fractionnaire des horloges de relecture. Elles refusent les upserts de memo/attribut dans le workflow (`service_redrive_history_not_qualified`), les résultats d’effets de bord externes (`external_side_effect_result_not_supported`) et les temporisateurs déclenchés (`unsupported_history`). L’[extension native des temporisateurs simples et de la précision d’horloge](./polyglot/server-api-reference.md#native-redrive-timers) dispose d’un producteur immuable qualifié. L’adoption stable nécessite encore les reçus SDK installés applicables et les conditions de Chart/release. Le suivi de précision/référence de Core et la parité native restante restent dans [server#980](https://github.com/durable-workflow/server/issues/980). ## Refus à l’entrée en mode service et récupération {#service-entry-recovery} diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md b/i18n/fr/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md index e4dce74f992..bf25f7ebb3f 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md @@ -504,9 +504,9 @@ Les commandes transportent les valeurs métier dans des enveloppes Avro. Les SDK ### Redrive natif des temporisateurs déclenchés et horloges de relecture {#native-redrive-timers} -:::note Publication native et qualification des consommateurs en attente +:::note Adoption stable et consommateurs installés en attente -L’extension des temporisateurs simples et la correction de précision fractionnaire sont intégrées dans le [code Server 5221ed82](https://github.com/durable-workflow/server/pull/1215). La [préparation de version](https://github.com/durable-workflow/server/pull/1218) native 3.11.0 est aussi intégrée ; publication et qualification des consommateurs restent en attente. Le Server publié sélectionné conserve ses refus de temporisateurs et son écriture d’horloge précédents. Cette description source n’établit ni producteur publié, ni résultat de relecture SDK, ni sélection stable. +L’extension des temporisateurs simples et la correction fractionnaire sont intégrées dans le [code Server 5221ed82](https://github.com/durable-workflow/server/pull/1215). Native 3.11.0 dispose d’une image immuable publiée et d’une [qualification producteur/plateforme/corpus/Compose acceptée](https://github.com/durable-workflow/server/pull/1218#issuecomment-6868218894). Les alias stables, le GitHub Release final, l’adoption du Chart et les preuves installées des consommateurs applicables restent en attente. Le Server publié sélectionné conserve ses refus de temporisateurs et son écriture d’horloge précédents. La qualification du producteur seule n’établit ni résultat de relecture du SDK installé ni sélection stable. ::: @@ -523,7 +523,7 @@ Les temporisateurs annulés restent `unsupported_history`. Collisions d’étape La [cohorte réelle de workers froids PHP/Python/Rust](https://github.com/durable-workflow/server/issues/980#issuecomment-6865541932) doit garder la même définition/empreinte lors du remplacement à froid et des redrives répétés. Elle compare des instants UTC analysés à pleine précision à un `TimerFired` source observé avec fraction non nulle, préserve l’historique source et vérifie les nombres originaux de callbacks, la nouvelle identité du temporisateur et l’absence de travail répété. Un affichage en secondes entières ne prouve pas cette précision ; l’historique installé ne doit pas être réécrit pour la fournir. Les tests source à horodatages contrôlés sont une preuve distincte. -La qualification des producteur/plateforme/source immuables, les reçus SDK installés applicables et la publication réelle du Chart précèdent l’adoption stable. Le [suivi de précision/référence de Core](https://github.com/durable-workflow/workflow/issues/992) reste distinct sous [Server #980](https://github.com/durable-workflow/server/issues/980). Le changement n’ajoute pas de prise en charge de l’horloge d’entrée ordinaire à un SDK qui ne l’annonce pas ; les SDK inchangés n’ont pas besoin de nouvelle version pour simplement aligner les numéros. Les formes du protocole, d’OpenAPI et du catalogue restent inchangées. +La qualification immuable producteur/plateforme/source a réussi. Les reçus SDK installés applicables, les alias stables/Release final et la publication réelle du Chart précèdent toujours l’adoption stable. Le [suivi de précision/référence de Core](https://github.com/durable-workflow/workflow/issues/992) reste distinct sous [Server #980](https://github.com/durable-workflow/server/issues/980). Le changement n’ajoute pas de prise en charge de l’horloge d’entrée ordinaire à un SDK qui ne l’annonce pas ; les SDK inchangés n’ont pas besoin de nouvelle version pour simplement aligner les numéros. Les formes du protocole, d’OpenAPI et du catalogue restent inchangées. ## Espaces de noms et stockage {#namespace-and-storage} diff --git a/i18n/fr/source-hashes.json b/i18n/fr/source-hashes.json index 7a23d28b290..a9762d682f5 100644 --- a/i18n/fr/source-hashes.json +++ b/i18n/fr/source-hashes.json @@ -29,7 +29,7 @@ "defining-workflows/workflow-status.md": "8e8cb27ff44c890d489d89bf166375acfdfaecabd990a2235e106fab1592d529", "defining-workflows/workflows.md": "f467bc73de32aa5d722c61ce085065460382ae7dd44cea4625847d9fcdc4c97c", "deployment.md": "1dd901213228a52e6222a15c6b85305098a4a4db06f198e319a7889c4562bddb", - "failures-and-recovery.md": "877e8ebafa056e78d2603e1d0339cc6f61fdffd6368f984ba043e1b752ee961c", + "failures-and-recovery.md": "5fca75a97d5a32501f0364140e38ff378bcf2fea0b7aeba792edb1322aac7648", "features/activity-execution-model.md": "e8c37520ae46a7efb30438f4fc06bf893c1df430cb1f92c48963697adaf09082", "features/cancel-and-terminate.md": "cedd1e6c51dfa551e00edc1d39739ff1f67d558d2a0be92143f478cb6111536b", "features/child-workflows.md": "30dd8e1a131654d6320641446b6bd661f27cd591353a60d007574955749cf8fb", @@ -88,7 +88,7 @@ "polyglot/runtime-migration.md": "5a78713bb8cb74aea58f6d5d826400d968a405f69c6ff17fdf2f7decb1d14b71", "polyglot/rust-cloud-quickstart.md": "2303434fc9302a81a8381ad4836423ef9952eb3201a4574c432254e3cb68c5f3", "polyglot/rust.md": "602f61be5ec561f27845d4ca0657d71c8f6cc3f08e30d1f657bd62c23dc53314", - "polyglot/server-api-reference.md": "9d671a8c63682069f8c12b2ad71b50ca81900628643dec30bd70ee373b3388e0", + "polyglot/server-api-reference.md": "7cf926b66298cd750837f9d7102bbd210e541e36ad89b5f9fbb7616f7581fb82", "polyglot/server-config-reference.md": "aec241c0046f12a9d6efe2d6c1de443d7753bdf34135e06a6f83b3904ed1d429", "polyglot/server-role-topology.md": "3d048f0c6b5f179399622508f51e67fff8aa5a6d5b2492533fc720eeec2c27f2", "polyglot/server.md": "f24fd7ff4eebcc768ec8105e8689ab1a14cc08d98167090ebb84e3e26631132a", diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/failures-and-recovery.md b/i18n/ja/docusaurus-plugin-content-docs/current/failures-and-recovery.md index 107d899441c..bffca892968 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/failures-and-recovery.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/failures-and-recovery.md @@ -261,7 +261,7 @@ Workflow 2.18.0 は、完了したアクティビティ、副作用、バージ 2.19.0 より前のリリースは、再利用されたシグナル、メモ、検索属性のステップの `reused_recorded_at` を無視します。Workflow 2.19.0 以降の後継実行がこれらのステップを再利用した後は、2.19.0 以降のワーカーを使い続けるか、ロールバックの前にそのような履歴がリプレイされないことを確認してください。組み込みモードでは、Workflow 2.19.0 は、更新または連鎖したシグナル待機を再利用した 2.20.0 の後継実行を、2.20.0 と同じようにリプレイ、インポート、再開します([検証記録](https://github.com/durable-workflow/workflow/issues/864#issuecomment-6617902412))。 -3.7.0 以降、native Server の redrive は開始時の memo と検索属性を後続へ引き継ぎ、`describe()` は `actions` 内に `can_redrive` と `redrive_blocked_reason` を返します。3.8.0 以降は失敗ステップ前の副作用とバージョンマーカーも再利用し、元のペイロード、`reused_from_run_id`、`reused_recorded_at` を記録します。native 3.8.0–3.10.x は既存の再利用タイムスタンプ文字列を保持しますが、新たなフォールバッククロックを秒単位で書くため、小数部を含むリプレイクロックの一致を示しません。これらのリリースはワークフロー内 memo/検索属性 upsert(`service_redrive_history_not_qualified`)、外部保存された副作用結果(`external_side_effect_result_not_supported`)、発火済みタイマー(`unsupported_history`)を拒否します。[保留中の単純タイマーとクロック精度の native 修正](./polyglot/server-api-reference.md#native-redrive-timers)には、公開とインストール済み SDK の別の条件があります。Core の精度/参照と残りの native 同等性は [server#980](https://github.com/durable-workflow/server/issues/980) で追跡します。 +3.7.0 以降、native Server の redrive は開始時の memo と検索属性を後続へ引き継ぎ、`describe()` は `actions` 内に `can_redrive` と `redrive_blocked_reason` を返します。3.8.0 以降は失敗ステップ前の副作用とバージョンマーカーも再利用し、元のペイロード、`reused_from_run_id`、`reused_recorded_at` を記録します。native 3.8.0–3.10.x は既存の再利用タイムスタンプ文字列を保持しますが、新たなフォールバッククロックを秒単位で書くため、小数部を含むリプレイクロックの一致を示しません。これらのリリースはワークフロー内 memo/検索属性 upsert(`service_redrive_history_not_qualified`)、外部保存された副作用結果(`external_side_effect_result_not_supported`)、発火済みタイマー(`unsupported_history`)を拒否します。[単純タイマーとクロック精度の native 拡張](./polyglot/server-api-reference.md#native-redrive-timers)には資格検証済みの不変 producer があります。Stable 採用には引き続き対象のインストール済み SDK 記録と Chart/release の条件が必要です。Core の精度/参照と残りの native 同等性は [server#980](https://github.com/durable-workflow/server/issues/980) で追跡します。 ## サービスモードのエントリ拒否と復旧 {#service-entry-recovery} diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md b/i18n/ja/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md index ef19b36ecbf..094c153658e 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md @@ -354,9 +354,9 @@ Server は協調的な `request-cancellation` ルートも提供します。時 ### 発火済みタイマーの native redrive とリプレイクロック {#native-redrive-timers} -:::note native 公開と利用側の資格検証は未完了 +:::note Stable 採用とインストール済み利用側の確認は未完了 -単純タイマーの拡張と小数精度の修正は [Server ソース 5221ed82](https://github.com/durable-workflow/server/pull/1215) にマージ済みです。native 3.11.0 の[リリース準備](https://github.com/durable-workflow/server/pull/1218)もマージ済みですが、公開と利用側の資格検証はまだ完了していません。選択中の公開 Server は以前のタイマー拒否とクロック書き込み動作を保持します。このソース説明は、公開済み producer、SDK のリプレイ結果、stable 選択を示しません。 +単純タイマーの拡張と小数精度の修正は [Server ソース 5221ed82](https://github.com/durable-workflow/server/pull/1215) にマージ済みです。Native 3.11.0 には公開済みの不変イメージがあり、[producer/platform/corpus/Compose の資格検証が受理されています](https://github.com/durable-workflow/server/pull/1218#issuecomment-6868218894)。stable エイリアス、最終 GitHub Release、Chart 採用、対象のインストール済み利用側の証拠は保留中です。選択中の公開 Server は以前のタイマー拒否とクロック書き込み動作を保持します。producer の資格検証だけでは、インストール済み SDK のリプレイ結果や stable 選択を示しません。 ::: @@ -373,7 +373,7 @@ Server は協調的な `request-cancellation` ルートも提供します。時 [実際の PHP/Python/Rust コールド Worker コホート](https://github.com/durable-workflow/server/issues/980#issuecomment-6865541932)は、コールド置換と繰り返し redrive で同じワークフロー定義/フィンガープリントを維持する必要があります。非ゼロ小数部を持つ元の `TimerFired` の観測時刻と、完全精度で解析した UTC 時点を比較し、元履歴を保持して元の callback 数、新しいタイマー ID、タイマー処理の再実行がないことを確認します。秒単位の表示では精度を検証できず、その結果を作るためにインストール済み環境の履歴を書き換えてはいけません。制御した時刻を使うソーステストは別の証拠です。 -不変の producer/platform/source の資格検証、対象となるインストール済み SDK の記録、実際の Chart 公開が stable 採用に先行します。[Core の精度/参照の追跡](https://github.com/durable-workflow/workflow/issues/992)は [Server #980](https://github.com/durable-workflow/server/issues/980) の下で別扱いです。この変更は通常エントリーのクロック対応を宣言しない SDK にその対応を追加しません。変更のない SDK は番号合わせだけのリリースを必要としません。プロトコル、OpenAPI、カタログの形は変わりません。 +不変の producer/platform/source の資格検証は成功しています。対象のインストール済み SDK の記録、stable エイリアス/最終 Release、実際の Chart 公開は、引き続き stable 採用に先行する条件です。[Core の精度/参照の追跡](https://github.com/durable-workflow/workflow/issues/992)は [Server #980](https://github.com/durable-workflow/server/issues/980) の下で別扱いです。この変更は通常エントリーのクロック対応を宣言しない SDK にその対応を追加しません。変更のない SDK は番号合わせだけのリリースを必要としません。プロトコル、OpenAPI、カタログの形は変わりません。 ## 名前空間とストレージ {#namespace-and-storage} diff --git a/i18n/ja/source-hashes.json b/i18n/ja/source-hashes.json index 7a23d28b290..a9762d682f5 100644 --- a/i18n/ja/source-hashes.json +++ b/i18n/ja/source-hashes.json @@ -29,7 +29,7 @@ "defining-workflows/workflow-status.md": "8e8cb27ff44c890d489d89bf166375acfdfaecabd990a2235e106fab1592d529", "defining-workflows/workflows.md": "f467bc73de32aa5d722c61ce085065460382ae7dd44cea4625847d9fcdc4c97c", "deployment.md": "1dd901213228a52e6222a15c6b85305098a4a4db06f198e319a7889c4562bddb", - "failures-and-recovery.md": "877e8ebafa056e78d2603e1d0339cc6f61fdffd6368f984ba043e1b752ee961c", + "failures-and-recovery.md": "5fca75a97d5a32501f0364140e38ff378bcf2fea0b7aeba792edb1322aac7648", "features/activity-execution-model.md": "e8c37520ae46a7efb30438f4fc06bf893c1df430cb1f92c48963697adaf09082", "features/cancel-and-terminate.md": "cedd1e6c51dfa551e00edc1d39739ff1f67d558d2a0be92143f478cb6111536b", "features/child-workflows.md": "30dd8e1a131654d6320641446b6bd661f27cd591353a60d007574955749cf8fb", @@ -88,7 +88,7 @@ "polyglot/runtime-migration.md": "5a78713bb8cb74aea58f6d5d826400d968a405f69c6ff17fdf2f7decb1d14b71", "polyglot/rust-cloud-quickstart.md": "2303434fc9302a81a8381ad4836423ef9952eb3201a4574c432254e3cb68c5f3", "polyglot/rust.md": "602f61be5ec561f27845d4ca0657d71c8f6cc3f08e30d1f657bd62c23dc53314", - "polyglot/server-api-reference.md": "9d671a8c63682069f8c12b2ad71b50ca81900628643dec30bd70ee373b3388e0", + "polyglot/server-api-reference.md": "7cf926b66298cd750837f9d7102bbd210e541e36ad89b5f9fbb7616f7581fb82", "polyglot/server-config-reference.md": "aec241c0046f12a9d6efe2d6c1de443d7753bdf34135e06a6f83b3904ed1d429", "polyglot/server-role-topology.md": "3d048f0c6b5f179399622508f51e67fff8aa5a6d5b2492533fc720eeec2c27f2", "polyglot/server.md": "f24fd7ff4eebcc768ec8105e8689ab1a14cc08d98167090ebb84e3e26631132a", diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/failures-and-recovery.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/failures-and-recovery.md index 8f81625d9a9..7610cd51613 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/failures-and-recovery.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/failures-and-recovery.md @@ -266,7 +266,7 @@ Versões do Workflow anteriores à 2.18.0 aceitam um conjunto menor de execuçõ Versões anteriores à 2.19.0 ignoram `reused_recorded_at` em passos reutilizados de sinal, memo e atributo de busca. Depois que um sucessor do Workflow 2.19.0 ou posterior reutilizar esses passos, mantenha workers 2.19.0 ou posteriores, ou confirme que nenhum histórico assim pode ser reproduzido, antes de voltar de versão. No modo embarcado, o Workflow 2.19.0 reproduz, importa e retoma um sucessor do 2.20.0 que reutilizou um update ou uma espera de sinal encadeada do mesmo jeito que o 2.20.0 ([comprovante de qualificação](https://github.com/durable-workflow/workflow/issues/864#issuecomment-6617902412)). -Desde 3.7.0, o redrive do Server nativo leva ao sucessor memos e atributos de busca definidos no início, e `describe()` informa `can_redrive` e `redrive_blocked_reason` em `actions`. Desde 3.8.0 também reutiliza efeitos colaterais e marcadores de versão anteriores ao passo que falhou, registrando payload original, `reused_from_run_id` e `reused_recorded_at`. As versões nativas 3.8.0–3.10.x preservam strings existentes de timestamps reutilizados, mas escrevem novos relógios de fallback em segundos inteiros; isso não comprova igualdade fracionária do relógio de replay. Essas versões recusam upserts de memo/atributo no código do workflow (`service_redrive_history_not_qualified`), resultados externos de efeitos colaterais (`external_side_effect_result_not_supported`) e temporizadores disparados (`unsupported_history`). A [correção pendente de temporizadores simples e precisão do relógio](./polyglot/server-api-reference.md#native-redrive-timers) tem condições próprias de publicação e SDK instalado. O trabalho de precisão/referência do Core e a paridade nativa restante continuam em [server#980](https://github.com/durable-workflow/server/issues/980). +Desde 3.7.0, o redrive do Server nativo leva ao sucessor memos e atributos de busca definidos no início, e `describe()` informa `can_redrive` e `redrive_blocked_reason` em `actions`. Desde 3.8.0 também reutiliza efeitos colaterais e marcadores de versão anteriores ao passo que falhou, registrando payload original, `reused_from_run_id` e `reused_recorded_at`. As versões nativas 3.8.0–3.10.x preservam strings existentes de timestamps reutilizados, mas escrevem novos relógios de fallback em segundos inteiros; isso não comprova igualdade fracionária do relógio de replay. Essas versões recusam upserts de memo/atributo no código do workflow (`service_redrive_history_not_qualified`), resultados externos de efeitos colaterais (`external_side_effect_result_not_supported`) e temporizadores disparados (`unsupported_history`). A [extensão nativa de temporizadores simples e precisão do relógio](./polyglot/server-api-reference.md#native-redrive-timers) tem um produtor imutável qualificado. A adoção estável ainda exige os recibos instalados aplicáveis de SDK e as condições de Chart/release. O trabalho de precisão/referência do Core e a paridade nativa restante continuam em [server#980](https://github.com/durable-workflow/server/issues/980). ## Recusa de entrada e recuperação no modo de serviço {#service-entry-recovery} diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md index fdec52174d6..0b09abd3f93 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md @@ -483,9 +483,9 @@ Os comandos levam valores de negócio em envelopes Avro. Os SDKs oficiais os cod ### Redrive nativo de temporizadores disparados e relógios de replay {#native-redrive-timers} -:::note Publicação nativa e qualificação dos consumidores pendentes +:::note Adoção estável e consumidores instalados pendentes -A extensão de temporizadores simples e a correção de precisão fracionária foram integradas no [código do Server 5221ed82](https://github.com/durable-workflow/server/pull/1215). A [preparação da versão](https://github.com/durable-workflow/server/pull/1218) nativa 3.11.0 também foi integrada; publicação e qualificação dos consumidores continuam pendentes. O Server publicado selecionado mantém a recusa de temporizadores e a escrita de relógios anteriores. Esta descrição de código não comprova produtor publicado, resultado de replay do SDK ou seleção estável. +A extensão de temporizadores simples e a correção fracionária foram integradas no [código do Server 5221ed82](https://github.com/durable-workflow/server/pull/1215). Native 3.11.0 tem uma imagem imutável publicada e [qualificação aceita de produtor/plataforma/corpus/Compose](https://github.com/durable-workflow/server/pull/1218#issuecomment-6868218894). Aliases estáveis, GitHub Release final, adoção do Chart e evidências instaladas dos consumidores aplicáveis continuam retidos. O Server publicado selecionado mantém a recusa de temporizadores e a escrita de relógios anteriores. A qualificação do produtor, sozinha, não comprova replay de SDK instalado nem seleção estável. ::: @@ -502,7 +502,7 @@ Temporizadores cancelados continuam como `unsupported_history`. Colisões de pas A [coorte real de workers frios PHP/Python/Rust](https://github.com/durable-workflow/server/issues/980#issuecomment-6865541932) deve manter a mesma definição/fingerprint durante substituição fria e redrives repetidos. Ela compara instantes UTC analisados com precisão completa contra um `TimerFired` de origem observado com fração não nula, preserva o histórico de origem e verifica contagens originais de callbacks, nova identidade do temporizador e ausência de trabalho repetido. Renderizar segundos inteiros não comprova essa precisão; o histórico instalado não pode ser reescrito para fornecê-la. Testes de código com timestamps controlados são evidências separadas. -A qualificação do produtor/plataforma/código imutáveis, os recibos instalados aplicáveis de SDK e a publicação real do Chart precedem a adoção estável. O [trabalho de precisão/referência do Core](https://github.com/durable-workflow/workflow/issues/992) continua separado sob [Server #980](https://github.com/durable-workflow/server/issues/980). A mudança não adiciona relógios de entrada comum a um SDK que não os anuncia; SDKs inalterados não precisam de versão nova só para alinhar números. As formas de protocolo, OpenAPI e catálogo permanecem iguais. +A qualificação imutável de produtor/plataforma/código passou. Recibos instalados aplicáveis de SDK, aliases estáveis/Release final e publicação real do Chart continuam precedendo a adoção estável. O [trabalho de precisão/referência do Core](https://github.com/durable-workflow/workflow/issues/992) continua separado sob [Server #980](https://github.com/durable-workflow/server/issues/980). A mudança não adiciona relógios de entrada comum a um SDK que não os anuncia; SDKs inalterados não precisam de versão nova só para alinhar números. As formas de protocolo, OpenAPI e catálogo permanecem iguais. ## Namespace e armazenamento {#namespace-and-storage} diff --git a/i18n/pt-BR/source-hashes.json b/i18n/pt-BR/source-hashes.json index 7a23d28b290..a9762d682f5 100644 --- a/i18n/pt-BR/source-hashes.json +++ b/i18n/pt-BR/source-hashes.json @@ -29,7 +29,7 @@ "defining-workflows/workflow-status.md": "8e8cb27ff44c890d489d89bf166375acfdfaecabd990a2235e106fab1592d529", "defining-workflows/workflows.md": "f467bc73de32aa5d722c61ce085065460382ae7dd44cea4625847d9fcdc4c97c", "deployment.md": "1dd901213228a52e6222a15c6b85305098a4a4db06f198e319a7889c4562bddb", - "failures-and-recovery.md": "877e8ebafa056e78d2603e1d0339cc6f61fdffd6368f984ba043e1b752ee961c", + "failures-and-recovery.md": "5fca75a97d5a32501f0364140e38ff378bcf2fea0b7aeba792edb1322aac7648", "features/activity-execution-model.md": "e8c37520ae46a7efb30438f4fc06bf893c1df430cb1f92c48963697adaf09082", "features/cancel-and-terminate.md": "cedd1e6c51dfa551e00edc1d39739ff1f67d558d2a0be92143f478cb6111536b", "features/child-workflows.md": "30dd8e1a131654d6320641446b6bd661f27cd591353a60d007574955749cf8fb", @@ -88,7 +88,7 @@ "polyglot/runtime-migration.md": "5a78713bb8cb74aea58f6d5d826400d968a405f69c6ff17fdf2f7decb1d14b71", "polyglot/rust-cloud-quickstart.md": "2303434fc9302a81a8381ad4836423ef9952eb3201a4574c432254e3cb68c5f3", "polyglot/rust.md": "602f61be5ec561f27845d4ca0657d71c8f6cc3f08e30d1f657bd62c23dc53314", - "polyglot/server-api-reference.md": "9d671a8c63682069f8c12b2ad71b50ca81900628643dec30bd70ee373b3388e0", + "polyglot/server-api-reference.md": "7cf926b66298cd750837f9d7102bbd210e541e36ad89b5f9fbb7616f7581fb82", "polyglot/server-config-reference.md": "aec241c0046f12a9d6efe2d6c1de443d7753bdf34135e06a6f83b3904ed1d429", "polyglot/server-role-topology.md": "3d048f0c6b5f179399622508f51e67fff8aa5a6d5b2492533fc720eeec2c27f2", "polyglot/server.md": "f24fd7ff4eebcc768ec8105e8689ab1a14cc08d98167090ebb84e3e26631132a", diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/failures-and-recovery.md b/i18n/uk/docusaurus-plugin-content-docs/current/failures-and-recovery.md index f908f477e7d..21e9fdbe698 100644 --- a/i18n/uk/docusaurus-plugin-content-docs/current/failures-and-recovery.md +++ b/i18n/uk/docusaurus-plugin-content-docs/current/failures-and-recovery.md @@ -266,7 +266,7 @@ Workflow 2.18.0 повторно використовує завершені act Релізи до 2.19.0 ігнорують `reused_recorded_at` на повторно використаних кроках signal, memo й атрибутів пошуку. Після того як наступник із Workflow 2.19.0 чи новішого повторно використав ці кроки, залиште worker 2.19.0 чи новіші або переконайтеся перед відкатом, що жодна така історія не може відтворюватися в replay. У вбудованому режимі Workflow 2.19.0 відтворює, імпортує й продовжує наступника з 2.20.0, який повторно використав update чи ланцюжкове очікування signal, так само як 2.20.0 ([звіт кваліфікації](https://github.com/durable-workflow/workflow/issues/864#issuecomment-6617902412)). -Починаючи з 3.7.0 native Server redrive переносить задані при старті memo й атрибути пошуку до наступника, а `describe()` повертає `can_redrive` та `redrive_blocked_reason` у `actions`. З 3.8.0 він також повторно використовує side effects і маркери версій перед помилковим кроком, записуючи початковий payload, `reused_from_run_id` та `reused_recorded_at`. Native 3.8.0–3.10.x зберігає наявні рядки повторно використаних часових позначок, але записує нові fallback-годинники цілими секундами, тому ці записи не доводять дробову рівність годинника replay. Ці релізи відмовляють у memo/search-attribute upsert з workflow-коду (`service_redrive_history_not_qualified`), зовнішніх результатах side effect (`external_side_effect_result_not_supported`) і спрацьованих timer (`unsupported_history`). [Очікуване native-виправлення простих timer і точності годинника](./polyglot/server-api-reference.md#native-redrive-timers) має окремі умови публікації та встановленого SDK. Супровід точності/посилань Core і решта native-паритету залишаються в [server#980](https://github.com/durable-workflow/server/issues/980). +Починаючи з 3.7.0 native Server redrive переносить задані при старті memo й атрибути пошуку до наступника, а `describe()` повертає `can_redrive` та `redrive_blocked_reason` у `actions`. З 3.8.0 він також повторно використовує side effects і маркери версій перед помилковим кроком, записуючи початковий payload, `reused_from_run_id` та `reused_recorded_at`. Native 3.8.0–3.10.x зберігає наявні рядки повторно використаних часових позначок, але записує нові fallback-годинники цілими секундами, тому ці записи не доводять дробову рівність годинника replay. Ці релізи відмовляють у memo/search-attribute upsert з workflow-коду (`service_redrive_history_not_qualified`), зовнішніх результатах side effect (`external_side_effect_result_not_supported`) і спрацьованих timer (`unsupported_history`). [Native-розширення простих timer і точності годинника](./polyglot/server-api-reference.md#native-redrive-timers) має кваліфікований незмінний producer. Stable-адаптація ще потребує відповідних встановлених SDK-результатів та умов Chart/release. Супровід точності/посилань Core і решта native-паритету залишаються в [server#980](https://github.com/durable-workflow/server/issues/980). ## Відмова входу та відновлення в сервісному режимі {#service-entry-recovery} diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md b/i18n/uk/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md index 2f7f2a8c68f..95f8eeab47b 100644 --- a/i18n/uk/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md +++ b/i18n/uk/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md @@ -460,9 +460,9 @@ Server також надає кооперативні маршрути `request- ### Native redrive спрацьованих timer і годинники replay {#native-redrive-timers} -:::note Native-публікація та кваліфікація споживачів очікуються +:::note Stable-адаптація та встановлені споживачі очікуються -Розширення простих timer і виправлення дробової точності вже злиті в [Server-коді 5221ed82](https://github.com/durable-workflow/server/pull/1215). [Підготовка native-релізу 3.11.0](https://github.com/durable-workflow/server/pull/1218) також злита, але публікація та кваліфікація споживачів ще очікуються. Вибраний опублікований Server зберігає попередню відмову timer і поведінку запису годинника. Цей опис коду не доводить наявність опублікованого producer, SDK replay-результату чи stable-вибору. +Розширення простих timer і виправлення дробової точності злиті в [Server-коді 5221ed82](https://github.com/durable-workflow/server/pull/1215). Native 3.11.0 має опублікований незмінний образ і [прийняту producer/platform/corpus/Compose-кваліфікацію](https://github.com/durable-workflow/server/pull/1218#issuecomment-6868218894). Stable-аліаси, фінальний GitHub Release, адаптація Chart та відповідні докази встановлених споживачів залишаються на утриманні. Вибраний опублікований Server зберігає попередню відмову timer і запис годинника. Сама producer-кваліфікація не доводить встановлений SDK replay-результат чи stable-вибір. ::: @@ -479,7 +479,7 @@ Server також надає кооперативні маршрути `request- [Фактична когорта холодних PHP/Python/Rust worker](https://github.com/durable-workflow/server/issues/980#issuecomment-6865541932) має зберігати те саме визначення/fingerprint workflow під час холодної заміни й повторних redrive. Вона порівнює розібрані UTC-моменти повної точності зі спостереженим початковим `TimerFired` із ненульовою часткою, зберігає початкову історію та перевіряє початкову кількість callbacks, нову timer-ідентичність і відсутність повторної timer-роботи. Відображення цілих секунд не доводить такої точності; встановлену історію не можна переписувати заради результату. Source-тести з керованими часовими позначками є окремим доказом. -Кваліфікація незмінних producer/platform/source, відповідні встановлені SDK-результати та фактична публікація Chart передують stable-адаптації. [Супровід точності/посилань Core](https://github.com/durable-workflow/workflow/issues/992) залишається окремим під [Server #980](https://github.com/durable-workflow/server/issues/980). Зміна не додає підтримки годинника ordinary-entry до SDK, який її не оголошує; незміненим SDK не потрібен реліз лише для вирівнювання номерів. Форми протоколу, OpenAPI й каталогу не змінюються. +Кваліфікація незмінних producer/platform/source пройдена. Відповідні встановлені SDK-результати, stable-аліаси/фінальний Release та фактична публікація Chart і далі передують stable-адаптації. [Супровід точності/посилань Core](https://github.com/durable-workflow/workflow/issues/992) залишається окремим під [Server #980](https://github.com/durable-workflow/server/issues/980). Зміна не додає підтримки годинника ordinary-entry до SDK, який її не оголошує; незміненим SDK не потрібен реліз лише для вирівнювання номерів. Форми протоколу, OpenAPI й каталогу не змінюються. ## Namespace і сховище {#namespace-and-storage} diff --git a/i18n/uk/source-hashes.json b/i18n/uk/source-hashes.json index 7a23d28b290..a9762d682f5 100644 --- a/i18n/uk/source-hashes.json +++ b/i18n/uk/source-hashes.json @@ -29,7 +29,7 @@ "defining-workflows/workflow-status.md": "8e8cb27ff44c890d489d89bf166375acfdfaecabd990a2235e106fab1592d529", "defining-workflows/workflows.md": "f467bc73de32aa5d722c61ce085065460382ae7dd44cea4625847d9fcdc4c97c", "deployment.md": "1dd901213228a52e6222a15c6b85305098a4a4db06f198e319a7889c4562bddb", - "failures-and-recovery.md": "877e8ebafa056e78d2603e1d0339cc6f61fdffd6368f984ba043e1b752ee961c", + "failures-and-recovery.md": "5fca75a97d5a32501f0364140e38ff378bcf2fea0b7aeba792edb1322aac7648", "features/activity-execution-model.md": "e8c37520ae46a7efb30438f4fc06bf893c1df430cb1f92c48963697adaf09082", "features/cancel-and-terminate.md": "cedd1e6c51dfa551e00edc1d39739ff1f67d558d2a0be92143f478cb6111536b", "features/child-workflows.md": "30dd8e1a131654d6320641446b6bd661f27cd591353a60d007574955749cf8fb", @@ -88,7 +88,7 @@ "polyglot/runtime-migration.md": "5a78713bb8cb74aea58f6d5d826400d968a405f69c6ff17fdf2f7decb1d14b71", "polyglot/rust-cloud-quickstart.md": "2303434fc9302a81a8381ad4836423ef9952eb3201a4574c432254e3cb68c5f3", "polyglot/rust.md": "602f61be5ec561f27845d4ca0657d71c8f6cc3f08e30d1f657bd62c23dc53314", - "polyglot/server-api-reference.md": "9d671a8c63682069f8c12b2ad71b50ca81900628643dec30bd70ee373b3388e0", + "polyglot/server-api-reference.md": "7cf926b66298cd750837f9d7102bbd210e541e36ad89b5f9fbb7616f7581fb82", "polyglot/server-config-reference.md": "aec241c0046f12a9d6efe2d6c1de443d7753bdf34135e06a6f83b3904ed1d429", "polyglot/server-role-topology.md": "3d048f0c6b5f179399622508f51e67fff8aa5a6d5b2492533fc720eeec2c27f2", "polyglot/server.md": "f24fd7ff4eebcc768ec8105e8689ab1a14cc08d98167090ebb84e3e26631132a", diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/failures-and-recovery.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/failures-and-recovery.md index 3d0c21d9092..61eb99f3a56 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/failures-and-recovery.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/failures-and-recovery.md @@ -261,7 +261,7 @@ Workflow 2.18.0 会复用已完成的活动、副作用、版本标记和已触 2.19.0 之前的版本会忽略复用的信号、备忘录和搜索属性步骤上的 `reused_recorded_at`。在 Workflow 2.19.0 或更高版本的后继运行复用这些步骤之后,请继续使用 2.19.0 或更高版本的 Worker,或在回滚前确认没有这样的历史会被重放。在嵌入模式下,对于复用了更新或链式信号等待的 2.20.0 后继运行,Workflow 2.19.0 的重放、导入和恢复方式与 2.20.0 相同([验证记录](https://github.com/durable-workflow/workflow/issues/864#issuecomment-6617902412))。 -从 3.7.0 起,原生 Server 重驱动将启动时设置的 memo 和搜索属性传给后继运行,`describe()` 在 `actions` 下报告 `can_redrive` 与 `redrive_blocked_reason`。从 3.8.0 起还复用失败步骤之前的副作用与版本标记,记录原始载荷、`reused_from_run_id` 和 `reused_recorded_at`。原生 3.8.0–3.10.x 保留已有复用时间戳字符串,但写入新的回退时钟时只保留整秒,因此这些写入不能证明重放时钟的小数精度相等。这些版本拒绝工作流代码的 memo/搜索属性 upsert(`service_redrive_history_not_qualified`)、外部保存的副作用结果(`external_side_effect_result_not_supported`)以及已触发定时器(`unsupported_history`)。[等待中的原生简单定时器与时钟精度修复](./polyglot/server-api-reference.md#native-redrive-timers)有独立的发布和已安装 SDK 验证条件。Core 的精度/参考后续工作及剩余原生一致性仍在 [server#980](https://github.com/durable-workflow/server/issues/980) 跟踪。 +从 3.7.0 起,原生 Server 重驱动将启动时设置的 memo 和搜索属性传给后继运行,`describe()` 在 `actions` 下报告 `can_redrive` 与 `redrive_blocked_reason`。从 3.8.0 起还复用失败步骤之前的副作用与版本标记,记录原始载荷、`reused_from_run_id` 和 `reused_recorded_at`。原生 3.8.0–3.10.x 保留已有复用时间戳字符串,但写入新的回退时钟时只保留整秒,因此这些写入不能证明重放时钟的小数精度相等。这些版本拒绝工作流代码的 memo/搜索属性 upsert(`service_redrive_history_not_qualified`)、外部保存的副作用结果(`external_side_effect_result_not_supported`)以及已触发定时器(`unsupported_history`)。[原生简单定时器与时钟精度扩展](./polyglot/server-api-reference.md#native-redrive-timers)已有通过资格验证的不可变生产者。稳定采用仍需要适用的已安装 SDK 回执及 Chart/release 条件。Core 的精度/参考后续工作及剩余原生一致性仍在 [server#980](https://github.com/durable-workflow/server/issues/980) 跟踪。 ## 服务模式入口拒绝与恢复 {#service-entry-recovery} diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md index b03688a0190..af385283674 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md @@ -353,9 +353,9 @@ Server 也提供协作式 `request-cancellation` 路由。有时限清理契约 ### 原生已触发定时器重驱动与重放时钟 {#native-redrive-timers} -:::note 等待原生发布与消费者资格验证 +:::note 等待稳定采用与已安装消费者验证 -简单定时器扩展和小数精度修复已合入 [Server 源码 5221ed82](https://github.com/durable-workflow/server/pull/1215)。原生 3.11.0 的[发布准备](https://github.com/durable-workflow/server/pull/1218)也已合并,但发布与消费者资格验证仍未完成。当前选定的已发布 Server 保留此前的定时器拒绝和时钟写入行为。此源码说明不代表已有已发布生产者、SDK 重放结果或稳定选择。 +简单定时器扩展和小数精度修复已合入 [Server 源码 5221ed82](https://github.com/durable-workflow/server/pull/1215)。原生 3.11.0 已有公开的不可变镜像,以及[已接受的生产者/平台/语料库/Compose 资格验证](https://github.com/durable-workflow/server/pull/1218#issuecomment-6868218894)。稳定别名、最终 GitHub Release、Chart 采用和适用的已安装消费者证据仍被保留。当前选定的已发布 Server 保留此前的定时器拒绝和时钟写入行为。仅生产者资格验证不代表已安装 SDK 重放结果或稳定选择。 ::: @@ -372,7 +372,7 @@ Server 也提供协作式 `request-cancellation` 路由。有时限清理契约 [实际 PHP/Python/Rust 冷 Worker 验证组](https://github.com/durable-workflow/server/issues/980#issuecomment-6865541932)必须在冷替换和重复重驱动期间保持相同工作流定义/指纹。它将完整精度解析的 UTC 时刻与实际观察到的、含非零小数部分的源 `TimerFired` 比较,保留源历史,并检查原始回调次数、新定时器标识以及没有重复定时器工作。仅显示整秒不能证明该精度;不得改写已安装环境的历史来制造结果。使用受控时间戳的源码测试是独立证据。 -稳定采用之前必须完成不可变生产者/平台/源码资格验证、适用的已安装 SDK 回执以及实际 Chart 发布。[Core 的精度/参考后续工作](https://github.com/durable-workflow/workflow/issues/992)在 [Server #980](https://github.com/durable-workflow/server/issues/980) 下单独跟踪。该变更不会给未声明支持的 SDK 增加普通入口时钟支持;未修改的 SDK 无须仅为版本号对齐而发布。协议、OpenAPI 和目录结构不变。 +不可变生产者/平台/源码资格验证已通过。适用的已安装 SDK 回执、稳定别名/最终 Release 和实际 Chart 发布仍是稳定采用之前的条件。[Core 的精度/参考后续工作](https://github.com/durable-workflow/workflow/issues/992)在 [Server #980](https://github.com/durable-workflow/server/issues/980) 下单独跟踪。该变更不会给未声明支持的 SDK 增加普通入口时钟支持;未修改的 SDK 无须仅为版本号对齐而发布。协议、OpenAPI 和目录结构不变。 ## 命名空间与存储 {#namespace-and-storage} diff --git a/i18n/zh-Hans/source-hashes.json b/i18n/zh-Hans/source-hashes.json index 7a23d28b290..a9762d682f5 100644 --- a/i18n/zh-Hans/source-hashes.json +++ b/i18n/zh-Hans/source-hashes.json @@ -29,7 +29,7 @@ "defining-workflows/workflow-status.md": "8e8cb27ff44c890d489d89bf166375acfdfaecabd990a2235e106fab1592d529", "defining-workflows/workflows.md": "f467bc73de32aa5d722c61ce085065460382ae7dd44cea4625847d9fcdc4c97c", "deployment.md": "1dd901213228a52e6222a15c6b85305098a4a4db06f198e319a7889c4562bddb", - "failures-and-recovery.md": "877e8ebafa056e78d2603e1d0339cc6f61fdffd6368f984ba043e1b752ee961c", + "failures-and-recovery.md": "5fca75a97d5a32501f0364140e38ff378bcf2fea0b7aeba792edb1322aac7648", "features/activity-execution-model.md": "e8c37520ae46a7efb30438f4fc06bf893c1df430cb1f92c48963697adaf09082", "features/cancel-and-terminate.md": "cedd1e6c51dfa551e00edc1d39739ff1f67d558d2a0be92143f478cb6111536b", "features/child-workflows.md": "30dd8e1a131654d6320641446b6bd661f27cd591353a60d007574955749cf8fb", @@ -88,7 +88,7 @@ "polyglot/runtime-migration.md": "5a78713bb8cb74aea58f6d5d826400d968a405f69c6ff17fdf2f7decb1d14b71", "polyglot/rust-cloud-quickstart.md": "2303434fc9302a81a8381ad4836423ef9952eb3201a4574c432254e3cb68c5f3", "polyglot/rust.md": "602f61be5ec561f27845d4ca0657d71c8f6cc3f08e30d1f657bd62c23dc53314", - "polyglot/server-api-reference.md": "9d671a8c63682069f8c12b2ad71b50ca81900628643dec30bd70ee373b3388e0", + "polyglot/server-api-reference.md": "7cf926b66298cd750837f9d7102bbd210e541e36ad89b5f9fbb7616f7581fb82", "polyglot/server-config-reference.md": "aec241c0046f12a9d6efe2d6c1de443d7753bdf34135e06a6f83b3904ed1d429", "polyglot/server-role-topology.md": "3d048f0c6b5f179399622508f51e67fff8aa5a6d5b2492533fc720eeec2c27f2", "polyglot/server.md": "f24fd7ff4eebcc768ec8105e8689ab1a14cc08d98167090ebb84e3e26631132a", From ea89924fdefb47a417b87c469782e697169aeda9 Mon Sep 17 00:00:00 2001 From: Richard McDaniel <1130888+rmcdaniel@users.noreply.github.com> Date: Sat, 14 Nov 2026 11:54:24 +0000 Subject: [PATCH 5/6] Clarify pending native adoption in localized callouts --- .../current/polyglot/server-api-reference.md | 2 +- .../current/polyglot/server-api-reference.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md b/i18n/uk/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md index 95f8eeab47b..0afbe3c5ff3 100644 --- a/i18n/uk/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md +++ b/i18n/uk/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md @@ -462,7 +462,7 @@ Server також надає кооперативні маршрути `request- :::note Stable-адаптація та встановлені споживачі очікуються -Розширення простих timer і виправлення дробової точності злиті в [Server-коді 5221ed82](https://github.com/durable-workflow/server/pull/1215). Native 3.11.0 має опублікований незмінний образ і [прийняту producer/platform/corpus/Compose-кваліфікацію](https://github.com/durable-workflow/server/pull/1218#issuecomment-6868218894). Stable-аліаси, фінальний GitHub Release, адаптація Chart та відповідні докази встановлених споживачів залишаються на утриманні. Вибраний опублікований Server зберігає попередню відмову timer і запис годинника. Сама producer-кваліфікація не доводить встановлений SDK replay-результат чи stable-вибір. +Розширення простих timer і виправлення дробової точності злиті в [Server-коді 5221ed82](https://github.com/durable-workflow/server/pull/1215). Native 3.11.0 має опублікований незмінний образ і [прийняту producer/platform/corpus/Compose-кваліфікацію](https://github.com/durable-workflow/server/pull/1218#issuecomment-6868218894). Підвищення stable-аліасів, фінальний GitHub Release, адаптація Chart і відповідна перевірка встановлених споживачів ще очікують завершення. Вибраний опублікований Server зберігає попередню відмову timer і запис годинника. Сама producer-кваліфікація не доводить встановлений SDK replay-результат чи stable-вибір. ::: diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md index af385283674..79019b100d4 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md @@ -355,7 +355,7 @@ Server 也提供协作式 `request-cancellation` 路由。有时限清理契约 :::note 等待稳定采用与已安装消费者验证 -简单定时器扩展和小数精度修复已合入 [Server 源码 5221ed82](https://github.com/durable-workflow/server/pull/1215)。原生 3.11.0 已有公开的不可变镜像,以及[已接受的生产者/平台/语料库/Compose 资格验证](https://github.com/durable-workflow/server/pull/1218#issuecomment-6868218894)。稳定别名、最终 GitHub Release、Chart 采用和适用的已安装消费者证据仍被保留。当前选定的已发布 Server 保留此前的定时器拒绝和时钟写入行为。仅生产者资格验证不代表已安装 SDK 重放结果或稳定选择。 +简单定时器扩展和小数精度修复已合入 [Server 源码 5221ed82](https://github.com/durable-workflow/server/pull/1215)。原生 3.11.0 已有公开的不可变镜像,以及[已接受的生产者/平台/语料库/Compose 资格验证](https://github.com/durable-workflow/server/pull/1218#issuecomment-6868218894)。稳定别名提升、最终 GitHub Release、Chart 采用以及适用的已安装消费者验证仍待完成。当前选定的已发布 Server 保留此前的定时器拒绝和时钟写入行为。仅生产者资格验证不代表已安装 SDK 重放结果或稳定选择。 ::: From 87b0b98ef9d5734cd419eeb86d0db0b15e43bd66 Mon Sep 17 00:00:00 2001 From: Richard McDaniel <1130888+rmcdaniel@users.noreply.github.com> Date: Tue, 17 Nov 2026 16:38:26 +0000 Subject: [PATCH 6/6] Describe released native Server 3.11.0 timer redrive Native Server 3.11.0 is the released source of plain fired-timer redrive and full-precision replay clocks. Replace the pending-adoption callout with a release note, record the passing installed Rust 4.18.0, Python 2.17.2 and PHP 3.18.3 cold-worker receipts on server#980, note the server's millisecond clock storage, and say in failures/recovery what 3.11.0 adds over 3.8.0-3.10.x. Apply the same changes in all seven locales and rebind their reviewed source hashes for the two pages. Co-Authored-By: Claude Opus 5.5 --- docs/failures-and-recovery.md | 2 +- docs/polyglot/server-api-reference.md | 6 +++--- .../current/failures-and-recovery.md | 2 +- .../current/polyglot/server-api-reference.md | 6 +++--- i18n/de/source-hashes.json | 4 ++-- .../current/failures-and-recovery.md | 2 +- .../current/polyglot/server-api-reference.md | 6 +++--- i18n/es/source-hashes.json | 4 ++-- .../current/failures-and-recovery.md | 2 +- .../current/polyglot/server-api-reference.md | 6 +++--- i18n/fr/source-hashes.json | 4 ++-- .../current/failures-and-recovery.md | 2 +- .../current/polyglot/server-api-reference.md | 6 +++--- i18n/ja/source-hashes.json | 4 ++-- .../current/failures-and-recovery.md | 2 +- .../current/polyglot/server-api-reference.md | 6 +++--- i18n/pt-BR/source-hashes.json | 4 ++-- .../current/failures-and-recovery.md | 2 +- .../current/polyglot/server-api-reference.md | 6 +++--- i18n/uk/source-hashes.json | 4 ++-- .../current/failures-and-recovery.md | 2 +- .../current/polyglot/server-api-reference.md | 6 +++--- i18n/zh-Hans/source-hashes.json | 4 ++-- 23 files changed, 46 insertions(+), 46 deletions(-) diff --git a/docs/failures-and-recovery.md b/docs/failures-and-recovery.md index 849f64483c1..44f8e7ed26f 100644 --- a/docs/failures-and-recovery.md +++ b/docs/failures-and-recovery.md @@ -264,7 +264,7 @@ Workflow releases before 2.18.0 accept a narrower set of runs. Every step before Releases before 2.19.0 ignore `reused_recorded_at` on reused signal, memo and search-attribute steps. After a Workflow 2.19.0 or later successor reuses those steps, keep 2.19.0 or later workers, or confirm that no such history can replay, before you roll back. In embedded mode, Workflow 2.19.0 replays, imports and resumes a 2.20.0 successor that reused an update or a chained signal wait the same way 2.20.0 does ([qualification receipt](https://github.com/durable-workflow/workflow/issues/864#issuecomment-6617902412)). -From 3.7.0, native Server redrive carries memos and search attributes set at start to the successor, and `describe()` reports `can_redrive` and `redrive_blocked_reason` under `actions`. From 3.8.0 it also reuses side effects and version markers before the failed step, recording each with its original payload, `reused_from_run_id` and `reused_recorded_at`. Native 3.8.0–3.10.x retains existing reuse timestamp strings but writes whole-second fallbacks for new reuse clocks, so those writes do not establish fractional replay-clock equality. These releases refuse workflow-code memo/search-attribute upserts (`service_redrive_history_not_qualified`), externally stored side-effect results (`external_side_effect_result_not_supported`) and fired timers (`unsupported_history`). The [native plain-timer and clock-precision extension](./polyglot/server-api-reference.md#native-redrive-timers) has a qualified immutable producer. Stable adoption still requires applicable installed-SDK receipts and Chart/release gates. Core's precision/reference follow-through and remaining native parity stay tracked in [server#980](https://github.com/durable-workflow/server/issues/980). +From 3.7.0, native Server redrive carries memos and search attributes set at start to the successor, and `describe()` reports `can_redrive` and `redrive_blocked_reason` under `actions`. From 3.8.0 it also reuses side effects and version markers before the failed step, recording each with its original payload, `reused_from_run_id` and `reused_recorded_at`. Native 3.8.0–3.10.x retains existing reuse timestamp strings but writes whole-second fallbacks for new reuse clocks, so those writes do not establish fractional replay-clock equality. These releases refuse workflow-code memo/search-attribute upserts (`service_redrive_history_not_qualified`), externally stored side-effect results (`external_side_effect_result_not_supported`) and fired timers (`unsupported_history`). Native 3.11.0 accepts a completed plain timer before the failed activity and writes fallback clocks at the full millisecond precision the server stores ([native fired-timer redrive](./polyglot/server-api-reference.md#native-redrive-timers)). Core's precision/reference follow-through and remaining native parity stay tracked in [server#980](https://github.com/durable-workflow/server/issues/980). ## Service Entry Refusal and Recovery {#service-entry-recovery} diff --git a/docs/polyglot/server-api-reference.md b/docs/polyglot/server-api-reference.md index b6ac19330b4..dd644ecf172 100644 --- a/docs/polyglot/server-api-reference.md +++ b/docs/polyglot/server-api-reference.md @@ -503,9 +503,9 @@ HTTP document is JSON; raw business JSON is not an alternative payload codec. ### Native fired-timer redrive and replay clocks {#native-redrive-timers} -:::note Pending stable adoption and installed consumers +:::note Available from native Server 3.11.0 -The plain-timer extension and fractional-clock correction are merged in [Server source 5221ed82](https://github.com/durable-workflow/server/pull/1215). Native 3.11.0 has a published immutable image and [accepted producer/platform/corpus/Compose qualification](https://github.com/durable-workflow/server/pull/1218#issuecomment-6868218894). Stable aliases, the final GitHub Release, Chart adoption and applicable installed-consumer evidence remain held. The selected published Server retains its earlier timer refusal and clock-writing behavior. Producer qualification alone does not establish an installed SDK replay result or stable selection. +Native Server [3.11.0](https://github.com/durable-workflow/server/releases/tag/3.11.0) accepts the completed plain timers and writes the replay clocks described in this section. Earlier native releases refuse fired timers with `unsupported_history`. ::: @@ -522,7 +522,7 @@ Cancelled timers remain `unsupported_history`. Step collisions, gaps and invalid The [actual PHP/Python/Rust cold-worker cohort](https://github.com/durable-workflow/server/issues/980#issuecomment-6865541932) must retain the same workflow definition/fingerprint through cold replacement and repeated redrive. It compares parsed full-precision UTC instants against an observed nonzero-fraction source `TimerFired`, preserves source history, and checks original callback counts, fresh timer identity and absence of repeated timer work. Whole-second rendering cannot establish that precision result, and installed history must not be rewritten to supply it. Source-controlled timestamp tests are separate evidence. -The immutable producer/platform/source qualification has passed. Applicable installed SDK receipts, stable aliases/final Release and actual Chart publication still precede stable adoption. [Core's precision/reference follow-through](https://github.com/durable-workflow/workflow/issues/992) remains separate under [Server #980](https://github.com/durable-workflow/server/issues/980). The change adds no ordinary-entry clock support to an SDK that does not advertise it, and unchanged SDKs need no release solely to align version numbers. Protocol, OpenAPI and catalog shapes are unchanged. +Installed published-SDK cold-worker receipts passed against native Server 3.11.0 for Rust SDK 4.18.0, Python SDK 2.17.2 and PHP SDK 3.18.3 ([Server #980](https://github.com/durable-workflow/server/issues/980)). The server stores these clocks at millisecond precision. [Core's precision/reference follow-through](https://github.com/durable-workflow/workflow/issues/992) remains separate under [Server #980](https://github.com/durable-workflow/server/issues/980). The change adds no ordinary-entry clock support to an SDK that does not advertise it, and unchanged SDKs need no release solely to align version numbers. Protocol, OpenAPI and catalog shapes are unchanged. ## Namespace And Storage diff --git a/i18n/de/docusaurus-plugin-content-docs/current/failures-and-recovery.md b/i18n/de/docusaurus-plugin-content-docs/current/failures-and-recovery.md index adc904f8df7..8739ca11fab 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/failures-and-recovery.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/failures-and-recovery.md @@ -261,7 +261,7 @@ Workflow-Releases vor 2.18.0 nehmen weniger Läufe an. Jeder Schritt vor der feh Releases vor 2.19.0 ignorieren `reused_recorded_at` bei wiederverwendeten Signal-, Memo- und Suchattribut-Schritten. Nachdem ein Nachfolger aus Workflow 2.19.0 oder später diese Schritte wiederverwendet hat, behalten Sie Worker ab 2.19.0 bei oder stellen Sie vor einem Rollback sicher, dass keine solche Historie per Replay verarbeitet werden kann. Im Embedded-Modus verarbeitet Workflow 2.19.0 einen 2.20.0-Nachfolger, der ein Update oder eine verkettete Signalwarteoperation wiederverwendet hat, beim Replay, Import und Fortsetzen genauso wie 2.20.0 ([Qualifizierungsnachweis](https://github.com/durable-workflow/workflow/issues/864#issuecomment-6617902412)). -Seit 3.7.0 übernimmt natives Server-Redrive beim Start gesetzte Memos und Suchattribute in den Nachfolger, und `describe()` meldet `can_redrive` sowie `redrive_blocked_reason` unter `actions`. Seit 3.8.0 werden auch Side Effects und Versionsmarker vor dem fehlgeschlagenen Schritt mit ursprünglicher Payload, `reused_from_run_id` und `reused_recorded_at` wiederverwendet. Native 3.8.0–3.10.x erhalten vorhandene Wiederverwendungs-Zeitstempelstrings, schreiben aber neue Fallback-Uhren nur mit ganzen Sekunden. Diese Schreibvorgänge belegen keine Gleichheit von Sekundenbruchteilen beim Replay. Diese Releases verweigern Memo-/Suchattribut-Upserts aus Workflow-Code (`service_redrive_history_not_qualified`), extern gespeicherte Side-Effect-Ergebnisse (`external_side_effect_result_not_supported`) und ausgelöste Timer (`unsupported_history`). Die [native Plain-Timer- und Uhrpräzisionserweiterung](./polyglot/server-api-reference.md#native-redrive-timers) hat einen qualifizierten unveränderlichen Producer. Stabile Übernahme benötigt weiterhin die jeweiligen installierten SDK-Belege und Chart-/Release-Gates. Cores Präzisions-/Referenzarbeit und übrige native Parität bleiben in [server#980](https://github.com/durable-workflow/server/issues/980) erfasst. +Seit 3.7.0 übernimmt natives Server-Redrive beim Start gesetzte Memos und Suchattribute in den Nachfolger, und `describe()` meldet `can_redrive` sowie `redrive_blocked_reason` unter `actions`. Seit 3.8.0 werden auch Side Effects und Versionsmarker vor dem fehlgeschlagenen Schritt mit ursprünglicher Payload, `reused_from_run_id` und `reused_recorded_at` wiederverwendet. Native 3.8.0–3.10.x erhalten vorhandene Wiederverwendungs-Zeitstempelstrings, schreiben aber neue Fallback-Uhren nur mit ganzen Sekunden. Diese Schreibvorgänge belegen keine Gleichheit von Sekundenbruchteilen beim Replay. Diese Releases verweigern Memo-/Suchattribut-Upserts aus Workflow-Code (`service_redrive_history_not_qualified`), extern gespeicherte Side-Effect-Ergebnisse (`external_side_effect_result_not_supported`) und ausgelöste Timer (`unsupported_history`). Native 3.11.0 akzeptiert einen abgeschlossenen einfachen Timer vor der fehlgeschlagenen Activity und schreibt Fallback-Uhren mit der vollen Millisekundenpräzision, die der Server speichert ([natives Redrive ausgelöster Timer](./polyglot/server-api-reference.md#native-redrive-timers)). Cores Präzisions-/Referenzarbeit und übrige native Parität bleiben in [server#980](https://github.com/durable-workflow/server/issues/980) erfasst. ## Ablehnung am Einstieg im Servicemodus und Wiederherstellung {#service-entry-recovery} diff --git a/i18n/de/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md b/i18n/de/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md index 35efde9d95c..969af1a12ed 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md @@ -487,9 +487,9 @@ Befehle übertragen Geschäftswerte in Avro-Envelopes. Die offiziellen SDKs codi ### Native Redrive ausgelöster Timer und Replay-Uhren {#native-redrive-timers} -:::note Stabile Übernahme und installierte Consumer ausstehend +:::note Verfügbar ab nativem Server 3.11.0 -Die Plain-Timer-Erweiterung und Bruchteilkorrektur sind in [Server-Quellstand 5221ed82](https://github.com/durable-workflow/server/pull/1215) zusammengeführt. Native 3.11.0 hat ein veröffentlichtes unveränderliches Image und eine [akzeptierte Producer-/Plattform-/Korpus-/Compose-Qualifikation](https://github.com/durable-workflow/server/pull/1218#issuecomment-6868218894). Stabile Aliasse, das endgültige GitHub Release, Chart-Übernahme und die jeweiligen installierten Consumer-Belege bleiben gesperrt. Der ausgewählte veröffentlichte Server behält seine bisherige Timer-Ablehnung und Uhrschreibweise. Die Producer-Qualifikation allein belegt keinen installierten SDK-Replay-Erfolg oder stabile Auswahl. +Nativer Server [3.11.0](https://github.com/durable-workflow/server/releases/tag/3.11.0) akzeptiert die abgeschlossenen einfachen Timer und schreibt die in diesem Abschnitt beschriebenen Replay-Uhren. Frühere native Releases verweigern ausgelöste Timer mit `unsupported_history`. ::: @@ -506,7 +506,7 @@ Abgebrochene Timer bleiben `unsupported_history`. Schritt-Kollisionen, Lücken u Die [tatsächliche PHP/Python/Rust-Cold-Worker-Kohorte](https://github.com/durable-workflow/server/issues/980#issuecomment-6865541932) muss bei kaltem Austausch und wiederholtem Redrive dieselbe Workflow-Definition und denselben Fingerprint erhalten. Sie vergleicht vollständig geparste UTC-Zeitpunkte mit einem beobachteten Quell-`TimerFired` mit nichtnull Sekundenbruchteil, erhält die Quellhistorie und prüft ursprüngliche Callback-Zahlen, neue Timer-Identität und ausbleibende erneute Timer-Arbeit. Eine Ganzsekundendarstellung belegt diese Präzision nicht; installierte Historie darf dafür nicht umgeschrieben werden. Quelltests mit kontrollierten Zeitstempeln sind separate Evidenz. -Die unveränderliche Producer-/Plattform-/Quellqualifikation ist bestanden. Die jeweiligen installierten SDK-Belege, stabile Aliasse/endgültiges Release und die tatsächliche Chart-Veröffentlichung gehen weiterhin stabiler Übernahme voraus. [Cores Präzisions-/Referenzarbeit](https://github.com/durable-workflow/workflow/issues/992) bleibt unter [Server #980](https://github.com/durable-workflow/server/issues/980) separat. Die Änderung ergänzt keine Ordinary-Entry-Uhrunterstützung in einem SDK, das sie nicht meldet; unveränderte SDKs benötigen keine bloße Versionsangleichungs-Release. Protokoll-, OpenAPI- und Katalogstrukturen bleiben unverändert. +Installierte Cold-Worker-Belege veröffentlichter SDKs sind gegen nativen Server 3.11.0 für Rust SDK 4.18.0, Python SDK 2.17.2 und PHP SDK 3.18.3 bestanden ([Server #980](https://github.com/durable-workflow/server/issues/980)). Der Server speichert diese Uhren mit Millisekundenpräzision. [Cores Präzisions-/Referenzarbeit](https://github.com/durable-workflow/workflow/issues/992) bleibt unter [Server #980](https://github.com/durable-workflow/server/issues/980) separat. Die Änderung ergänzt keine Ordinary-Entry-Uhrunterstützung in einem SDK, das sie nicht meldet; unveränderte SDKs benötigen keine bloße Versionsangleichungs-Release. Protokoll-, OpenAPI- und Katalogstrukturen bleiben unverändert. ## Namespace und Speicher {#namespace-and-storage} diff --git a/i18n/de/source-hashes.json b/i18n/de/source-hashes.json index ac870ff5d7e..f864192dbab 100644 --- a/i18n/de/source-hashes.json +++ b/i18n/de/source-hashes.json @@ -29,7 +29,7 @@ "defining-workflows/workflow-status.md": "8e8cb27ff44c890d489d89bf166375acfdfaecabd990a2235e106fab1592d529", "defining-workflows/workflows.md": "f467bc73de32aa5d722c61ce085065460382ae7dd44cea4625847d9fcdc4c97c", "deployment.md": "1dd901213228a52e6222a15c6b85305098a4a4db06f198e319a7889c4562bddb", - "failures-and-recovery.md": "5fca75a97d5a32501f0364140e38ff378bcf2fea0b7aeba792edb1322aac7648", + "failures-and-recovery.md": "f36882d22adf0b035216013696cc0af5a8ed4b125f9777d997ad1158faee188e", "features/activity-execution-model.md": "e8c37520ae46a7efb30438f4fc06bf893c1df430cb1f92c48963697adaf09082", "features/cancel-and-terminate.md": "cedd1e6c51dfa551e00edc1d39739ff1f67d558d2a0be92143f478cb6111536b", "features/child-workflows.md": "30dd8e1a131654d6320641446b6bd661f27cd591353a60d007574955749cf8fb", @@ -88,7 +88,7 @@ "polyglot/runtime-migration.md": "5a78713bb8cb74aea58f6d5d826400d968a405f69c6ff17fdf2f7decb1d14b71", "polyglot/rust-cloud-quickstart.md": "2303434fc9302a81a8381ad4836423ef9952eb3201a4574c432254e3cb68c5f3", "polyglot/rust.md": "602f61be5ec561f27845d4ca0657d71c8f6cc3f08e30d1f657bd62c23dc53314", - "polyglot/server-api-reference.md": "7cf926b66298cd750837f9d7102bbd210e541e36ad89b5f9fbb7616f7581fb82", + "polyglot/server-api-reference.md": "9d215d30468ee7d175005d83ab8c8a8d5d4c2589b4184515d96e7d29404dc6b2", "polyglot/server-config-reference.md": "aec241c0046f12a9d6efe2d6c1de443d7753bdf34135e06a6f83b3904ed1d429", "polyglot/server-role-topology.md": "3d048f0c6b5f179399622508f51e67fff8aa5a6d5b2492533fc720eeec2c27f2", "polyglot/server.md": "f24fd7ff4eebcc768ec8105e8689ab1a14cc08d98167090ebb84e3e26631132a", diff --git a/i18n/es/docusaurus-plugin-content-docs/current/failures-and-recovery.md b/i18n/es/docusaurus-plugin-content-docs/current/failures-and-recovery.md index e0501ddb7eb..68d60a9f371 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/failures-and-recovery.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/failures-and-recovery.md @@ -265,7 +265,7 @@ Las versiones de Workflow anteriores a 2.18.0 aceptan menos ejecuciones. Cada pa Las versiones anteriores a 2.19.0 ignoran `reused_recorded_at` en los pasos reutilizados de señal, memo y atributo de búsqueda. Después de que un sucesor de Workflow 2.19.0 o posterior reutilice esos pasos, mantenga workers de 2.19.0 o posteriores, o confirme que ningún historial así puede reproducirse, antes de volver atrás. En modo embebido, Workflow 2.19.0 reproduce, importa y reanuda un sucesor de 2.20.0 que reutilizó un update o una espera de señal encadenada igual que 2.20.0 ([comprobante de calificación](https://github.com/durable-workflow/workflow/issues/864#issuecomment-6617902412)). -Desde 3.7.0, el redrive del Server nativo transfiere al sucesor memos y atributos de búsqueda establecidos al inicio, y `describe()` informa `can_redrive` y `redrive_blocked_reason` bajo `actions`. Desde 3.8.0 también reutiliza efectos laterales y marcadores de versión previos al paso fallido, registrando payload original, `reused_from_run_id` y `reused_recorded_at`. Las versiones nativas 3.8.0–3.10.x conservan las cadenas de timestamps reutilizadas existentes, pero escriben respaldos de reloj nuevos con segundos enteros; esas escrituras no acreditan igualdad fraccionaria del reloj de replay. Rechazan upserts de memo/atributos desde el workflow (`service_redrive_history_not_qualified`), resultados de efectos laterales externos (`external_side_effect_result_not_supported`) y temporizadores disparados (`unsupported_history`). La [extensión nativa de temporizadores simples y precisión del reloj](./polyglot/server-api-reference.md#native-redrive-timers) tiene un productor inmutable validado. La adopción estable aún requiere los recibos instalados aplicables de SDK y las condiciones de Chart/release. El trabajo de precisión/referencia de Core y la paridad nativa restante siguen en [server#980](https://github.com/durable-workflow/server/issues/980). +Desde 3.7.0, el redrive del Server nativo transfiere al sucesor memos y atributos de búsqueda establecidos al inicio, y `describe()` informa `can_redrive` y `redrive_blocked_reason` bajo `actions`. Desde 3.8.0 también reutiliza efectos laterales y marcadores de versión previos al paso fallido, registrando payload original, `reused_from_run_id` y `reused_recorded_at`. Las versiones nativas 3.8.0–3.10.x conservan las cadenas de timestamps reutilizadas existentes, pero escriben respaldos de reloj nuevos con segundos enteros; esas escrituras no acreditan igualdad fraccionaria del reloj de replay. Rechazan upserts de memo/atributos desde el workflow (`service_redrive_history_not_qualified`), resultados de efectos laterales externos (`external_side_effect_result_not_supported`) y temporizadores disparados (`unsupported_history`). Server nativo 3.11.0 acepta un temporizador simple completado antes de la actividad fallida y escribe los relojes de respaldo con la precisión completa de milisegundos que almacena el servidor ([redrive nativo de temporizadores disparados](./polyglot/server-api-reference.md#native-redrive-timers)). El trabajo de precisión/referencia de Core y la paridad nativa restante siguen en [server#980](https://github.com/durable-workflow/server/issues/980). ## Rechazo de entrada y recuperación en modo servicio {#service-entry-recovery} diff --git a/i18n/es/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md b/i18n/es/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md index 4ed6daa2116..8d355bb5a53 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md @@ -354,9 +354,9 @@ Los comandos llevan valores de negocio en sobres Avro. Los SDK oficiales los cod ### Redrive nativo de temporizadores disparados y relojes de replay {#native-redrive-timers} -:::note Adopción estable y consumidores instalados pendientes +:::note Disponible desde Server nativo 3.11.0 -La extensión de temporizadores simples y la corrección fraccionaria están integradas en el [código del Server 5221ed82](https://github.com/durable-workflow/server/pull/1215). Native 3.11.0 tiene una imagen inmutable publicada y [validación aceptada de productor/plataforma/corpus/Compose](https://github.com/durable-workflow/server/pull/1218#issuecomment-6868218894). Siguen retenidos los alias estables, el GitHub Release final, la adopción del Chart y la evidencia instalada de consumidores aplicables. El Server publicado seleccionado conserva el rechazo de temporizadores y la escritura de relojes anteriores. La validación del productor por sí sola no acredita un resultado de replay del SDK instalado ni una selección estable. +Server nativo [3.11.0](https://github.com/durable-workflow/server/releases/tag/3.11.0) acepta los temporizadores simples completados y escribe los relojes de replay descritos en esta sección. Las versiones nativas anteriores rechazan los temporizadores disparados con `unsupported_history`. ::: @@ -373,7 +373,7 @@ Los temporizadores cancelados siguen siendo `unsupported_history`. Colisiones, h La [cohorte real de workers fríos PHP/Python/Rust](https://github.com/durable-workflow/server/issues/980#issuecomment-6865541932) debe mantener la misma definición/fingerprint durante el reemplazo frío y redrives repetidos. Compara instantes UTC analizados con precisión completa contra un `TimerFired` de origen observado con fracción no nula, conserva el historial de origen y comprueba los conteos originales de callbacks, la identidad nueva del temporizador y la ausencia de trabajo repetido. Mostrar segundos enteros no acredita esa precisión; no se puede reescribir el historial instalado para producirla. Las pruebas de código con timestamps controlados son evidencia separada. -La validación inmutable de productor/plataforma/código ha pasado. Los recibos instalados aplicables de SDK, los alias estables/Release final y la publicación real del Chart siguen precediendo a la adopción estable. El [trabajo de precisión/referencia de Core](https://github.com/durable-workflow/workflow/issues/992) sigue separado bajo [Server #980](https://github.com/durable-workflow/server/issues/980). El cambio no añade relojes en la entrada ordinaria a un SDK que no los anuncia; un SDK sin cambios no requiere una versión nueva solo para alinear números. Las formas de protocolo, OpenAPI y catálogo no cambian. +Los recibos instalados de workers en frío con SDK publicados pasaron contra Server nativo 3.11.0 para Rust SDK 4.18.0, Python SDK 2.17.2 y PHP SDK 3.18.3 ([Server #980](https://github.com/durable-workflow/server/issues/980)). El servidor almacena estos relojes con precisión de milisegundos. El [trabajo de precisión/referencia de Core](https://github.com/durable-workflow/workflow/issues/992) sigue separado bajo [Server #980](https://github.com/durable-workflow/server/issues/980). El cambio no añade relojes en la entrada ordinaria a un SDK que no los anuncia; un SDK sin cambios no requiere una versión nueva solo para alinear números. Las formas de protocolo, OpenAPI y catálogo no cambian. ## Espacios de nombres y almacenamiento {#namespace-and-storage} diff --git a/i18n/es/source-hashes.json b/i18n/es/source-hashes.json index ac870ff5d7e..f864192dbab 100644 --- a/i18n/es/source-hashes.json +++ b/i18n/es/source-hashes.json @@ -29,7 +29,7 @@ "defining-workflows/workflow-status.md": "8e8cb27ff44c890d489d89bf166375acfdfaecabd990a2235e106fab1592d529", "defining-workflows/workflows.md": "f467bc73de32aa5d722c61ce085065460382ae7dd44cea4625847d9fcdc4c97c", "deployment.md": "1dd901213228a52e6222a15c6b85305098a4a4db06f198e319a7889c4562bddb", - "failures-and-recovery.md": "5fca75a97d5a32501f0364140e38ff378bcf2fea0b7aeba792edb1322aac7648", + "failures-and-recovery.md": "f36882d22adf0b035216013696cc0af5a8ed4b125f9777d997ad1158faee188e", "features/activity-execution-model.md": "e8c37520ae46a7efb30438f4fc06bf893c1df430cb1f92c48963697adaf09082", "features/cancel-and-terminate.md": "cedd1e6c51dfa551e00edc1d39739ff1f67d558d2a0be92143f478cb6111536b", "features/child-workflows.md": "30dd8e1a131654d6320641446b6bd661f27cd591353a60d007574955749cf8fb", @@ -88,7 +88,7 @@ "polyglot/runtime-migration.md": "5a78713bb8cb74aea58f6d5d826400d968a405f69c6ff17fdf2f7decb1d14b71", "polyglot/rust-cloud-quickstart.md": "2303434fc9302a81a8381ad4836423ef9952eb3201a4574c432254e3cb68c5f3", "polyglot/rust.md": "602f61be5ec561f27845d4ca0657d71c8f6cc3f08e30d1f657bd62c23dc53314", - "polyglot/server-api-reference.md": "7cf926b66298cd750837f9d7102bbd210e541e36ad89b5f9fbb7616f7581fb82", + "polyglot/server-api-reference.md": "9d215d30468ee7d175005d83ab8c8a8d5d4c2589b4184515d96e7d29404dc6b2", "polyglot/server-config-reference.md": "aec241c0046f12a9d6efe2d6c1de443d7753bdf34135e06a6f83b3904ed1d429", "polyglot/server-role-topology.md": "3d048f0c6b5f179399622508f51e67fff8aa5a6d5b2492533fc720eeec2c27f2", "polyglot/server.md": "f24fd7ff4eebcc768ec8105e8689ab1a14cc08d98167090ebb84e3e26631132a", diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/failures-and-recovery.md b/i18n/fr/docusaurus-plugin-content-docs/current/failures-and-recovery.md index 103fd7021a4..a33ac256484 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/failures-and-recovery.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/failures-and-recovery.md @@ -269,7 +269,7 @@ Les versions de Workflow antérieures à 2.18.0 acceptent un ensemble plus restr Les versions antérieures à 2.19.0 ignorent `reused_recorded_at` sur les étapes de signal, de mémo et d’attribut de recherche réutilisées. Une fois qu’un successeur de Workflow 2.19.0 ou ultérieur a réutilisé ces étapes, gardez des workers 2.19.0 ou ultérieurs, ou vérifiez qu’aucun historique de ce type ne peut être rejoué, avant de revenir en arrière. En mode embarqué, Workflow 2.19.0 rejoue, importe et reprend un successeur 2.20.0 qui a réutilisé un update ou une attente de signal enchaînée de la même façon que 2.20.0 ([preuve de qualification](https://github.com/durable-workflow/workflow/issues/864#issuecomment-6617902412)). -Depuis 3.7.0, le redrive du Server natif transmet au successeur les memos et attributs de recherche définis au démarrage, et `describe()` expose `can_redrive` et `redrive_blocked_reason` sous `actions`. Depuis 3.8.0, il réutilise aussi les effets de bord et marqueurs de version précédant l’étape échouée, avec leur payload original, `reused_from_run_id` et `reused_recorded_at`. Les versions natives 3.8.0–3.10.x conservent les chaînes d’horodatage réutilisées existantes, mais écrivent les nouvelles horloges de repli en secondes entières ; cela ne prouve pas l’égalité fractionnaire des horloges de relecture. Elles refusent les upserts de memo/attribut dans le workflow (`service_redrive_history_not_qualified`), les résultats d’effets de bord externes (`external_side_effect_result_not_supported`) et les temporisateurs déclenchés (`unsupported_history`). L’[extension native des temporisateurs simples et de la précision d’horloge](./polyglot/server-api-reference.md#native-redrive-timers) dispose d’un producteur immuable qualifié. L’adoption stable nécessite encore les reçus SDK installés applicables et les conditions de Chart/release. Le suivi de précision/référence de Core et la parité native restante restent dans [server#980](https://github.com/durable-workflow/server/issues/980). +Depuis 3.7.0, le redrive du Server natif transmet au successeur les memos et attributs de recherche définis au démarrage, et `describe()` expose `can_redrive` et `redrive_blocked_reason` sous `actions`. Depuis 3.8.0, il réutilise aussi les effets de bord et marqueurs de version précédant l’étape échouée, avec leur payload original, `reused_from_run_id` et `reused_recorded_at`. Les versions natives 3.8.0–3.10.x conservent les chaînes d’horodatage réutilisées existantes, mais écrivent les nouvelles horloges de repli en secondes entières ; cela ne prouve pas l’égalité fractionnaire des horloges de relecture. Elles refusent les upserts de memo/attribut dans le workflow (`service_redrive_history_not_qualified`), les résultats d’effets de bord externes (`external_side_effect_result_not_supported`) et les temporisateurs déclenchés (`unsupported_history`). Server natif 3.11.0 accepte un temporisateur simple terminé avant l’activité échouée et écrit les horloges de repli avec la pleine précision à la milliseconde que stocke le serveur ([redrive natif des temporisateurs déclenchés](./polyglot/server-api-reference.md#native-redrive-timers)). Le suivi de précision/référence de Core et la parité native restante restent dans [server#980](https://github.com/durable-workflow/server/issues/980). ## Refus à l’entrée en mode service et récupération {#service-entry-recovery} diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md b/i18n/fr/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md index bf25f7ebb3f..48b97183bd2 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md @@ -504,9 +504,9 @@ Les commandes transportent les valeurs métier dans des enveloppes Avro. Les SDK ### Redrive natif des temporisateurs déclenchés et horloges de relecture {#native-redrive-timers} -:::note Adoption stable et consommateurs installés en attente +:::note Disponible à partir de Server natif 3.11.0 -L’extension des temporisateurs simples et la correction fractionnaire sont intégrées dans le [code Server 5221ed82](https://github.com/durable-workflow/server/pull/1215). Native 3.11.0 dispose d’une image immuable publiée et d’une [qualification producteur/plateforme/corpus/Compose acceptée](https://github.com/durable-workflow/server/pull/1218#issuecomment-6868218894). Les alias stables, le GitHub Release final, l’adoption du Chart et les preuves installées des consommateurs applicables restent en attente. Le Server publié sélectionné conserve ses refus de temporisateurs et son écriture d’horloge précédents. La qualification du producteur seule n’établit ni résultat de relecture du SDK installé ni sélection stable. +Server natif [3.11.0](https://github.com/durable-workflow/server/releases/tag/3.11.0) accepte les temporisateurs simples terminés et écrit les horloges de relecture décrites dans cette section. Les versions natives antérieures refusent les temporisateurs déclenchés avec `unsupported_history`. ::: @@ -523,7 +523,7 @@ Les temporisateurs annulés restent `unsupported_history`. Collisions d’étape La [cohorte réelle de workers froids PHP/Python/Rust](https://github.com/durable-workflow/server/issues/980#issuecomment-6865541932) doit garder la même définition/empreinte lors du remplacement à froid et des redrives répétés. Elle compare des instants UTC analysés à pleine précision à un `TimerFired` source observé avec fraction non nulle, préserve l’historique source et vérifie les nombres originaux de callbacks, la nouvelle identité du temporisateur et l’absence de travail répété. Un affichage en secondes entières ne prouve pas cette précision ; l’historique installé ne doit pas être réécrit pour la fournir. Les tests source à horodatages contrôlés sont une preuve distincte. -La qualification immuable producteur/plateforme/source a réussi. Les reçus SDK installés applicables, les alias stables/Release final et la publication réelle du Chart précèdent toujours l’adoption stable. Le [suivi de précision/référence de Core](https://github.com/durable-workflow/workflow/issues/992) reste distinct sous [Server #980](https://github.com/durable-workflow/server/issues/980). Le changement n’ajoute pas de prise en charge de l’horloge d’entrée ordinaire à un SDK qui ne l’annonce pas ; les SDK inchangés n’ont pas besoin de nouvelle version pour simplement aligner les numéros. Les formes du protocole, d’OpenAPI et du catalogue restent inchangées. +Les reçus installés de workers à froid avec des SDK publiés ont réussi contre Server natif 3.11.0 pour Rust SDK 4.18.0, Python SDK 2.17.2 et PHP SDK 3.18.3 ([Server #980](https://github.com/durable-workflow/server/issues/980)). Le serveur stocke ces horloges avec une précision à la milliseconde. Le [suivi de précision/référence de Core](https://github.com/durable-workflow/workflow/issues/992) reste distinct sous [Server #980](https://github.com/durable-workflow/server/issues/980). Le changement n’ajoute pas de prise en charge de l’horloge d’entrée ordinaire à un SDK qui ne l’annonce pas ; les SDK inchangés n’ont pas besoin de nouvelle version pour simplement aligner les numéros. Les formes du protocole, d’OpenAPI et du catalogue restent inchangées. ## Espaces de noms et stockage {#namespace-and-storage} diff --git a/i18n/fr/source-hashes.json b/i18n/fr/source-hashes.json index ac870ff5d7e..f864192dbab 100644 --- a/i18n/fr/source-hashes.json +++ b/i18n/fr/source-hashes.json @@ -29,7 +29,7 @@ "defining-workflows/workflow-status.md": "8e8cb27ff44c890d489d89bf166375acfdfaecabd990a2235e106fab1592d529", "defining-workflows/workflows.md": "f467bc73de32aa5d722c61ce085065460382ae7dd44cea4625847d9fcdc4c97c", "deployment.md": "1dd901213228a52e6222a15c6b85305098a4a4db06f198e319a7889c4562bddb", - "failures-and-recovery.md": "5fca75a97d5a32501f0364140e38ff378bcf2fea0b7aeba792edb1322aac7648", + "failures-and-recovery.md": "f36882d22adf0b035216013696cc0af5a8ed4b125f9777d997ad1158faee188e", "features/activity-execution-model.md": "e8c37520ae46a7efb30438f4fc06bf893c1df430cb1f92c48963697adaf09082", "features/cancel-and-terminate.md": "cedd1e6c51dfa551e00edc1d39739ff1f67d558d2a0be92143f478cb6111536b", "features/child-workflows.md": "30dd8e1a131654d6320641446b6bd661f27cd591353a60d007574955749cf8fb", @@ -88,7 +88,7 @@ "polyglot/runtime-migration.md": "5a78713bb8cb74aea58f6d5d826400d968a405f69c6ff17fdf2f7decb1d14b71", "polyglot/rust-cloud-quickstart.md": "2303434fc9302a81a8381ad4836423ef9952eb3201a4574c432254e3cb68c5f3", "polyglot/rust.md": "602f61be5ec561f27845d4ca0657d71c8f6cc3f08e30d1f657bd62c23dc53314", - "polyglot/server-api-reference.md": "7cf926b66298cd750837f9d7102bbd210e541e36ad89b5f9fbb7616f7581fb82", + "polyglot/server-api-reference.md": "9d215d30468ee7d175005d83ab8c8a8d5d4c2589b4184515d96e7d29404dc6b2", "polyglot/server-config-reference.md": "aec241c0046f12a9d6efe2d6c1de443d7753bdf34135e06a6f83b3904ed1d429", "polyglot/server-role-topology.md": "3d048f0c6b5f179399622508f51e67fff8aa5a6d5b2492533fc720eeec2c27f2", "polyglot/server.md": "f24fd7ff4eebcc768ec8105e8689ab1a14cc08d98167090ebb84e3e26631132a", diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/failures-and-recovery.md b/i18n/ja/docusaurus-plugin-content-docs/current/failures-and-recovery.md index bffca892968..1e8db45f9e5 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/failures-and-recovery.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/failures-and-recovery.md @@ -261,7 +261,7 @@ Workflow 2.18.0 は、完了したアクティビティ、副作用、バージ 2.19.0 より前のリリースは、再利用されたシグナル、メモ、検索属性のステップの `reused_recorded_at` を無視します。Workflow 2.19.0 以降の後継実行がこれらのステップを再利用した後は、2.19.0 以降のワーカーを使い続けるか、ロールバックの前にそのような履歴がリプレイされないことを確認してください。組み込みモードでは、Workflow 2.19.0 は、更新または連鎖したシグナル待機を再利用した 2.20.0 の後継実行を、2.20.0 と同じようにリプレイ、インポート、再開します([検証記録](https://github.com/durable-workflow/workflow/issues/864#issuecomment-6617902412))。 -3.7.0 以降、native Server の redrive は開始時の memo と検索属性を後続へ引き継ぎ、`describe()` は `actions` 内に `can_redrive` と `redrive_blocked_reason` を返します。3.8.0 以降は失敗ステップ前の副作用とバージョンマーカーも再利用し、元のペイロード、`reused_from_run_id`、`reused_recorded_at` を記録します。native 3.8.0–3.10.x は既存の再利用タイムスタンプ文字列を保持しますが、新たなフォールバッククロックを秒単位で書くため、小数部を含むリプレイクロックの一致を示しません。これらのリリースはワークフロー内 memo/検索属性 upsert(`service_redrive_history_not_qualified`)、外部保存された副作用結果(`external_side_effect_result_not_supported`)、発火済みタイマー(`unsupported_history`)を拒否します。[単純タイマーとクロック精度の native 拡張](./polyglot/server-api-reference.md#native-redrive-timers)には資格検証済みの不変 producer があります。Stable 採用には引き続き対象のインストール済み SDK 記録と Chart/release の条件が必要です。Core の精度/参照と残りの native 同等性は [server#980](https://github.com/durable-workflow/server/issues/980) で追跡します。 +3.7.0 以降、native Server の redrive は開始時の memo と検索属性を後続へ引き継ぎ、`describe()` は `actions` 内に `can_redrive` と `redrive_blocked_reason` を返します。3.8.0 以降は失敗ステップ前の副作用とバージョンマーカーも再利用し、元のペイロード、`reused_from_run_id`、`reused_recorded_at` を記録します。native 3.8.0–3.10.x は既存の再利用タイムスタンプ文字列を保持しますが、新たなフォールバッククロックを秒単位で書くため、小数部を含むリプレイクロックの一致を示しません。これらのリリースはワークフロー内 memo/検索属性 upsert(`service_redrive_history_not_qualified`)、外部保存された副作用結果(`external_side_effect_result_not_supported`)、発火済みタイマー(`unsupported_history`)を拒否します。native 3.11.0 は、失敗したアクティビティより前に完了した単純タイマーを受け入れ、Server が保存するミリ秒単位の完全な精度でフォールバッククロックを書き込みます([発火済みタイマーの native redrive](./polyglot/server-api-reference.md#native-redrive-timers))。Core の精度/参照と残りの native 同等性は [server#980](https://github.com/durable-workflow/server/issues/980) で追跡します。 ## サービスモードのエントリ拒否と復旧 {#service-entry-recovery} diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md b/i18n/ja/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md index 094c153658e..45397690591 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md @@ -354,9 +354,9 @@ Server は協調的な `request-cancellation` ルートも提供します。時 ### 発火済みタイマーの native redrive とリプレイクロック {#native-redrive-timers} -:::note Stable 採用とインストール済み利用側の確認は未完了 +:::note native Server 3.11.0 から利用可能 -単純タイマーの拡張と小数精度の修正は [Server ソース 5221ed82](https://github.com/durable-workflow/server/pull/1215) にマージ済みです。Native 3.11.0 には公開済みの不変イメージがあり、[producer/platform/corpus/Compose の資格検証が受理されています](https://github.com/durable-workflow/server/pull/1218#issuecomment-6868218894)。stable エイリアス、最終 GitHub Release、Chart 採用、対象のインストール済み利用側の証拠は保留中です。選択中の公開 Server は以前のタイマー拒否とクロック書き込み動作を保持します。producer の資格検証だけでは、インストール済み SDK のリプレイ結果や stable 選択を示しません。 +native Server [3.11.0](https://github.com/durable-workflow/server/releases/tag/3.11.0) は、完了した単純タイマーを受け入れ、このセクションで説明するリプレイクロックを書き込みます。以前の native リリースは、発火済みタイマーを `unsupported_history` で拒否します。 ::: @@ -373,7 +373,7 @@ Server は協調的な `request-cancellation` ルートも提供します。時 [実際の PHP/Python/Rust コールド Worker コホート](https://github.com/durable-workflow/server/issues/980#issuecomment-6865541932)は、コールド置換と繰り返し redrive で同じワークフロー定義/フィンガープリントを維持する必要があります。非ゼロ小数部を持つ元の `TimerFired` の観測時刻と、完全精度で解析した UTC 時点を比較し、元履歴を保持して元の callback 数、新しいタイマー ID、タイマー処理の再実行がないことを確認します。秒単位の表示では精度を検証できず、その結果を作るためにインストール済み環境の履歴を書き換えてはいけません。制御した時刻を使うソーステストは別の証拠です。 -不変の producer/platform/source の資格検証は成功しています。対象のインストール済み SDK の記録、stable エイリアス/最終 Release、実際の Chart 公開は、引き続き stable 採用に先行する条件です。[Core の精度/参照の追跡](https://github.com/durable-workflow/workflow/issues/992)は [Server #980](https://github.com/durable-workflow/server/issues/980) の下で別扱いです。この変更は通常エントリーのクロック対応を宣言しない SDK にその対応を追加しません。変更のない SDK は番号合わせだけのリリースを必要としません。プロトコル、OpenAPI、カタログの形は変わりません。 +公開済み SDK をインストールしたコールドワーカーの記録は、native Server 3.11.0 に対して Rust SDK 4.18.0、Python SDK 2.17.2、PHP SDK 3.18.3 のすべてで成功しています([Server #980](https://github.com/durable-workflow/server/issues/980))。Server はこれらのクロックをミリ秒精度で保存します。[Core の精度/参照の追跡](https://github.com/durable-workflow/workflow/issues/992)は [Server #980](https://github.com/durable-workflow/server/issues/980) の下で別扱いです。この変更は通常エントリーのクロック対応を宣言しない SDK にその対応を追加しません。変更のない SDK は番号合わせだけのリリースを必要としません。プロトコル、OpenAPI、カタログの形は変わりません。 ## 名前空間とストレージ {#namespace-and-storage} diff --git a/i18n/ja/source-hashes.json b/i18n/ja/source-hashes.json index ac870ff5d7e..f864192dbab 100644 --- a/i18n/ja/source-hashes.json +++ b/i18n/ja/source-hashes.json @@ -29,7 +29,7 @@ "defining-workflows/workflow-status.md": "8e8cb27ff44c890d489d89bf166375acfdfaecabd990a2235e106fab1592d529", "defining-workflows/workflows.md": "f467bc73de32aa5d722c61ce085065460382ae7dd44cea4625847d9fcdc4c97c", "deployment.md": "1dd901213228a52e6222a15c6b85305098a4a4db06f198e319a7889c4562bddb", - "failures-and-recovery.md": "5fca75a97d5a32501f0364140e38ff378bcf2fea0b7aeba792edb1322aac7648", + "failures-and-recovery.md": "f36882d22adf0b035216013696cc0af5a8ed4b125f9777d997ad1158faee188e", "features/activity-execution-model.md": "e8c37520ae46a7efb30438f4fc06bf893c1df430cb1f92c48963697adaf09082", "features/cancel-and-terminate.md": "cedd1e6c51dfa551e00edc1d39739ff1f67d558d2a0be92143f478cb6111536b", "features/child-workflows.md": "30dd8e1a131654d6320641446b6bd661f27cd591353a60d007574955749cf8fb", @@ -88,7 +88,7 @@ "polyglot/runtime-migration.md": "5a78713bb8cb74aea58f6d5d826400d968a405f69c6ff17fdf2f7decb1d14b71", "polyglot/rust-cloud-quickstart.md": "2303434fc9302a81a8381ad4836423ef9952eb3201a4574c432254e3cb68c5f3", "polyglot/rust.md": "602f61be5ec561f27845d4ca0657d71c8f6cc3f08e30d1f657bd62c23dc53314", - "polyglot/server-api-reference.md": "7cf926b66298cd750837f9d7102bbd210e541e36ad89b5f9fbb7616f7581fb82", + "polyglot/server-api-reference.md": "9d215d30468ee7d175005d83ab8c8a8d5d4c2589b4184515d96e7d29404dc6b2", "polyglot/server-config-reference.md": "aec241c0046f12a9d6efe2d6c1de443d7753bdf34135e06a6f83b3904ed1d429", "polyglot/server-role-topology.md": "3d048f0c6b5f179399622508f51e67fff8aa5a6d5b2492533fc720eeec2c27f2", "polyglot/server.md": "f24fd7ff4eebcc768ec8105e8689ab1a14cc08d98167090ebb84e3e26631132a", diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/failures-and-recovery.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/failures-and-recovery.md index 7610cd51613..8cd90f0cac6 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/failures-and-recovery.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/failures-and-recovery.md @@ -266,7 +266,7 @@ Versões do Workflow anteriores à 2.18.0 aceitam um conjunto menor de execuçõ Versões anteriores à 2.19.0 ignoram `reused_recorded_at` em passos reutilizados de sinal, memo e atributo de busca. Depois que um sucessor do Workflow 2.19.0 ou posterior reutilizar esses passos, mantenha workers 2.19.0 ou posteriores, ou confirme que nenhum histórico assim pode ser reproduzido, antes de voltar de versão. No modo embarcado, o Workflow 2.19.0 reproduz, importa e retoma um sucessor do 2.20.0 que reutilizou um update ou uma espera de sinal encadeada do mesmo jeito que o 2.20.0 ([comprovante de qualificação](https://github.com/durable-workflow/workflow/issues/864#issuecomment-6617902412)). -Desde 3.7.0, o redrive do Server nativo leva ao sucessor memos e atributos de busca definidos no início, e `describe()` informa `can_redrive` e `redrive_blocked_reason` em `actions`. Desde 3.8.0 também reutiliza efeitos colaterais e marcadores de versão anteriores ao passo que falhou, registrando payload original, `reused_from_run_id` e `reused_recorded_at`. As versões nativas 3.8.0–3.10.x preservam strings existentes de timestamps reutilizados, mas escrevem novos relógios de fallback em segundos inteiros; isso não comprova igualdade fracionária do relógio de replay. Essas versões recusam upserts de memo/atributo no código do workflow (`service_redrive_history_not_qualified`), resultados externos de efeitos colaterais (`external_side_effect_result_not_supported`) e temporizadores disparados (`unsupported_history`). A [extensão nativa de temporizadores simples e precisão do relógio](./polyglot/server-api-reference.md#native-redrive-timers) tem um produtor imutável qualificado. A adoção estável ainda exige os recibos instalados aplicáveis de SDK e as condições de Chart/release. O trabalho de precisão/referência do Core e a paridade nativa restante continuam em [server#980](https://github.com/durable-workflow/server/issues/980). +Desde 3.7.0, o redrive do Server nativo leva ao sucessor memos e atributos de busca definidos no início, e `describe()` informa `can_redrive` e `redrive_blocked_reason` em `actions`. Desde 3.8.0 também reutiliza efeitos colaterais e marcadores de versão anteriores ao passo que falhou, registrando payload original, `reused_from_run_id` e `reused_recorded_at`. As versões nativas 3.8.0–3.10.x preservam strings existentes de timestamps reutilizados, mas escrevem novos relógios de fallback em segundos inteiros; isso não comprova igualdade fracionária do relógio de replay. Essas versões recusam upserts de memo/atributo no código do workflow (`service_redrive_history_not_qualified`), resultados externos de efeitos colaterais (`external_side_effect_result_not_supported`) e temporizadores disparados (`unsupported_history`). O Server nativo 3.11.0 aceita um temporizador simples concluído antes da atividade que falhou e escreve relógios de fallback com a precisão completa de milissegundos que o servidor armazena ([redrive nativo de temporizadores disparados](./polyglot/server-api-reference.md#native-redrive-timers)). O trabalho de precisão/referência do Core e a paridade nativa restante continuam em [server#980](https://github.com/durable-workflow/server/issues/980). ## Recusa de entrada e recuperação no modo de serviço {#service-entry-recovery} diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md index 0b09abd3f93..43eb80abff6 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md @@ -483,9 +483,9 @@ Os comandos levam valores de negócio em envelopes Avro. Os SDKs oficiais os cod ### Redrive nativo de temporizadores disparados e relógios de replay {#native-redrive-timers} -:::note Adoção estável e consumidores instalados pendentes +:::note Disponível a partir do Server nativo 3.11.0 -A extensão de temporizadores simples e a correção fracionária foram integradas no [código do Server 5221ed82](https://github.com/durable-workflow/server/pull/1215). Native 3.11.0 tem uma imagem imutável publicada e [qualificação aceita de produtor/plataforma/corpus/Compose](https://github.com/durable-workflow/server/pull/1218#issuecomment-6868218894). Aliases estáveis, GitHub Release final, adoção do Chart e evidências instaladas dos consumidores aplicáveis continuam retidos. O Server publicado selecionado mantém a recusa de temporizadores e a escrita de relógios anteriores. A qualificação do produtor, sozinha, não comprova replay de SDK instalado nem seleção estável. +O Server nativo [3.11.0](https://github.com/durable-workflow/server/releases/tag/3.11.0) aceita os temporizadores simples concluídos e escreve os relógios de replay descritos nesta seção. Versões nativas anteriores recusam temporizadores disparados com `unsupported_history`. ::: @@ -502,7 +502,7 @@ Temporizadores cancelados continuam como `unsupported_history`. Colisões de pas A [coorte real de workers frios PHP/Python/Rust](https://github.com/durable-workflow/server/issues/980#issuecomment-6865541932) deve manter a mesma definição/fingerprint durante substituição fria e redrives repetidos. Ela compara instantes UTC analisados com precisão completa contra um `TimerFired` de origem observado com fração não nula, preserva o histórico de origem e verifica contagens originais de callbacks, nova identidade do temporizador e ausência de trabalho repetido. Renderizar segundos inteiros não comprova essa precisão; o histórico instalado não pode ser reescrito para fornecê-la. Testes de código com timestamps controlados são evidências separadas. -A qualificação imutável de produtor/plataforma/código passou. Recibos instalados aplicáveis de SDK, aliases estáveis/Release final e publicação real do Chart continuam precedendo a adoção estável. O [trabalho de precisão/referência do Core](https://github.com/durable-workflow/workflow/issues/992) continua separado sob [Server #980](https://github.com/durable-workflow/server/issues/980). A mudança não adiciona relógios de entrada comum a um SDK que não os anuncia; SDKs inalterados não precisam de versão nova só para alinhar números. As formas de protocolo, OpenAPI e catálogo permanecem iguais. +Os recibos instalados de workers a frio com SDKs publicados passaram contra o Server nativo 3.11.0 para Rust SDK 4.18.0, Python SDK 2.17.2 e PHP SDK 3.18.3 ([Server #980](https://github.com/durable-workflow/server/issues/980)). O servidor armazena esses relógios com precisão de milissegundos. O [trabalho de precisão/referência do Core](https://github.com/durable-workflow/workflow/issues/992) continua separado sob [Server #980](https://github.com/durable-workflow/server/issues/980). A mudança não adiciona relógios de entrada comum a um SDK que não os anuncia; SDKs inalterados não precisam de versão nova só para alinhar números. As formas de protocolo, OpenAPI e catálogo permanecem iguais. ## Namespace e armazenamento {#namespace-and-storage} diff --git a/i18n/pt-BR/source-hashes.json b/i18n/pt-BR/source-hashes.json index ac870ff5d7e..f864192dbab 100644 --- a/i18n/pt-BR/source-hashes.json +++ b/i18n/pt-BR/source-hashes.json @@ -29,7 +29,7 @@ "defining-workflows/workflow-status.md": "8e8cb27ff44c890d489d89bf166375acfdfaecabd990a2235e106fab1592d529", "defining-workflows/workflows.md": "f467bc73de32aa5d722c61ce085065460382ae7dd44cea4625847d9fcdc4c97c", "deployment.md": "1dd901213228a52e6222a15c6b85305098a4a4db06f198e319a7889c4562bddb", - "failures-and-recovery.md": "5fca75a97d5a32501f0364140e38ff378bcf2fea0b7aeba792edb1322aac7648", + "failures-and-recovery.md": "f36882d22adf0b035216013696cc0af5a8ed4b125f9777d997ad1158faee188e", "features/activity-execution-model.md": "e8c37520ae46a7efb30438f4fc06bf893c1df430cb1f92c48963697adaf09082", "features/cancel-and-terminate.md": "cedd1e6c51dfa551e00edc1d39739ff1f67d558d2a0be92143f478cb6111536b", "features/child-workflows.md": "30dd8e1a131654d6320641446b6bd661f27cd591353a60d007574955749cf8fb", @@ -88,7 +88,7 @@ "polyglot/runtime-migration.md": "5a78713bb8cb74aea58f6d5d826400d968a405f69c6ff17fdf2f7decb1d14b71", "polyglot/rust-cloud-quickstart.md": "2303434fc9302a81a8381ad4836423ef9952eb3201a4574c432254e3cb68c5f3", "polyglot/rust.md": "602f61be5ec561f27845d4ca0657d71c8f6cc3f08e30d1f657bd62c23dc53314", - "polyglot/server-api-reference.md": "7cf926b66298cd750837f9d7102bbd210e541e36ad89b5f9fbb7616f7581fb82", + "polyglot/server-api-reference.md": "9d215d30468ee7d175005d83ab8c8a8d5d4c2589b4184515d96e7d29404dc6b2", "polyglot/server-config-reference.md": "aec241c0046f12a9d6efe2d6c1de443d7753bdf34135e06a6f83b3904ed1d429", "polyglot/server-role-topology.md": "3d048f0c6b5f179399622508f51e67fff8aa5a6d5b2492533fc720eeec2c27f2", "polyglot/server.md": "f24fd7ff4eebcc768ec8105e8689ab1a14cc08d98167090ebb84e3e26631132a", diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/failures-and-recovery.md b/i18n/uk/docusaurus-plugin-content-docs/current/failures-and-recovery.md index 21e9fdbe698..f3e93f18cdc 100644 --- a/i18n/uk/docusaurus-plugin-content-docs/current/failures-and-recovery.md +++ b/i18n/uk/docusaurus-plugin-content-docs/current/failures-and-recovery.md @@ -266,7 +266,7 @@ Workflow 2.18.0 повторно використовує завершені act Релізи до 2.19.0 ігнорують `reused_recorded_at` на повторно використаних кроках signal, memo й атрибутів пошуку. Після того як наступник із Workflow 2.19.0 чи новішого повторно використав ці кроки, залиште worker 2.19.0 чи новіші або переконайтеся перед відкатом, що жодна така історія не може відтворюватися в replay. У вбудованому режимі Workflow 2.19.0 відтворює, імпортує й продовжує наступника з 2.20.0, який повторно використав update чи ланцюжкове очікування signal, так само як 2.20.0 ([звіт кваліфікації](https://github.com/durable-workflow/workflow/issues/864#issuecomment-6617902412)). -Починаючи з 3.7.0 native Server redrive переносить задані при старті memo й атрибути пошуку до наступника, а `describe()` повертає `can_redrive` та `redrive_blocked_reason` у `actions`. З 3.8.0 він також повторно використовує side effects і маркери версій перед помилковим кроком, записуючи початковий payload, `reused_from_run_id` та `reused_recorded_at`. Native 3.8.0–3.10.x зберігає наявні рядки повторно використаних часових позначок, але записує нові fallback-годинники цілими секундами, тому ці записи не доводять дробову рівність годинника replay. Ці релізи відмовляють у memo/search-attribute upsert з workflow-коду (`service_redrive_history_not_qualified`), зовнішніх результатах side effect (`external_side_effect_result_not_supported`) і спрацьованих timer (`unsupported_history`). [Native-розширення простих timer і точності годинника](./polyglot/server-api-reference.md#native-redrive-timers) має кваліфікований незмінний producer. Stable-адаптація ще потребує відповідних встановлених SDK-результатів та умов Chart/release. Супровід точності/посилань Core і решта native-паритету залишаються в [server#980](https://github.com/durable-workflow/server/issues/980). +Починаючи з 3.7.0 native Server redrive переносить задані при старті memo й атрибути пошуку до наступника, а `describe()` повертає `can_redrive` та `redrive_blocked_reason` у `actions`. З 3.8.0 він також повторно використовує side effects і маркери версій перед помилковим кроком, записуючи початковий payload, `reused_from_run_id` та `reused_recorded_at`. Native 3.8.0–3.10.x зберігає наявні рядки повторно використаних часових позначок, але записує нові fallback-годинники цілими секундами, тому ці записи не доводять дробову рівність годинника replay. Ці релізи відмовляють у memo/search-attribute upsert з workflow-коду (`service_redrive_history_not_qualified`), зовнішніх результатах side effect (`external_side_effect_result_not_supported`) і спрацьованих timer (`unsupported_history`). Native 3.11.0 приймає завершений простий timer перед помилковою activity і записує fallback-годинники з повною мілісекундною точністю, яку зберігає Server ([native redrive спрацьованих timer](./polyglot/server-api-reference.md#native-redrive-timers)). Супровід точності/посилань Core і решта native-паритету залишаються в [server#980](https://github.com/durable-workflow/server/issues/980). ## Відмова входу та відновлення в сервісному режимі {#service-entry-recovery} diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md b/i18n/uk/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md index 0afbe3c5ff3..95426b914b1 100644 --- a/i18n/uk/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md +++ b/i18n/uk/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md @@ -460,9 +460,9 @@ Server також надає кооперативні маршрути `request- ### Native redrive спрацьованих timer і годинники replay {#native-redrive-timers} -:::note Stable-адаптація та встановлені споживачі очікуються +:::note Доступно з native Server 3.11.0 -Розширення простих timer і виправлення дробової точності злиті в [Server-коді 5221ed82](https://github.com/durable-workflow/server/pull/1215). Native 3.11.0 має опублікований незмінний образ і [прийняту producer/platform/corpus/Compose-кваліфікацію](https://github.com/durable-workflow/server/pull/1218#issuecomment-6868218894). Підвищення stable-аліасів, фінальний GitHub Release, адаптація Chart і відповідна перевірка встановлених споживачів ще очікують завершення. Вибраний опублікований Server зберігає попередню відмову timer і запис годинника. Сама producer-кваліфікація не доводить встановлений SDK replay-результат чи stable-вибір. +Native Server [3.11.0](https://github.com/durable-workflow/server/releases/tag/3.11.0) приймає завершені прості timer і записує описані в цьому розділі годинники replay. Попередні native-релізи відхиляють спрацьовані timer з `unsupported_history`. ::: @@ -479,7 +479,7 @@ Server також надає кооперативні маршрути `request- [Фактична когорта холодних PHP/Python/Rust worker](https://github.com/durable-workflow/server/issues/980#issuecomment-6865541932) має зберігати те саме визначення/fingerprint workflow під час холодної заміни й повторних redrive. Вона порівнює розібрані UTC-моменти повної точності зі спостереженим початковим `TimerFired` із ненульовою часткою, зберігає початкову історію та перевіряє початкову кількість callbacks, нову timer-ідентичність і відсутність повторної timer-роботи. Відображення цілих секунд не доводить такої точності; встановлену історію не можна переписувати заради результату. Source-тести з керованими часовими позначками є окремим доказом. -Кваліфікація незмінних producer/platform/source пройдена. Відповідні встановлені SDK-результати, stable-аліаси/фінальний Release та фактична публікація Chart і далі передують stable-адаптації. [Супровід точності/посилань Core](https://github.com/durable-workflow/workflow/issues/992) залишається окремим під [Server #980](https://github.com/durable-workflow/server/issues/980). Зміна не додає підтримки годинника ordinary-entry до SDK, який її не оголошує; незміненим SDK не потрібен реліз лише для вирівнювання номерів. Форми протоколу, OpenAPI й каталогу не змінюються. +Встановлені cold-worker-результати з опублікованими SDK пройшли на native Server 3.11.0 для Rust SDK 4.18.0, Python SDK 2.17.2 і PHP SDK 3.18.3 ([Server #980](https://github.com/durable-workflow/server/issues/980)). Server зберігає ці годинники з мілісекундною точністю. [Супровід точності/посилань Core](https://github.com/durable-workflow/workflow/issues/992) залишається окремим під [Server #980](https://github.com/durable-workflow/server/issues/980). Зміна не додає підтримки годинника ordinary-entry до SDK, який її не оголошує; незміненим SDK не потрібен реліз лише для вирівнювання номерів. Форми протоколу, OpenAPI й каталогу не змінюються. ## Namespace і сховище {#namespace-and-storage} diff --git a/i18n/uk/source-hashes.json b/i18n/uk/source-hashes.json index ac870ff5d7e..f864192dbab 100644 --- a/i18n/uk/source-hashes.json +++ b/i18n/uk/source-hashes.json @@ -29,7 +29,7 @@ "defining-workflows/workflow-status.md": "8e8cb27ff44c890d489d89bf166375acfdfaecabd990a2235e106fab1592d529", "defining-workflows/workflows.md": "f467bc73de32aa5d722c61ce085065460382ae7dd44cea4625847d9fcdc4c97c", "deployment.md": "1dd901213228a52e6222a15c6b85305098a4a4db06f198e319a7889c4562bddb", - "failures-and-recovery.md": "5fca75a97d5a32501f0364140e38ff378bcf2fea0b7aeba792edb1322aac7648", + "failures-and-recovery.md": "f36882d22adf0b035216013696cc0af5a8ed4b125f9777d997ad1158faee188e", "features/activity-execution-model.md": "e8c37520ae46a7efb30438f4fc06bf893c1df430cb1f92c48963697adaf09082", "features/cancel-and-terminate.md": "cedd1e6c51dfa551e00edc1d39739ff1f67d558d2a0be92143f478cb6111536b", "features/child-workflows.md": "30dd8e1a131654d6320641446b6bd661f27cd591353a60d007574955749cf8fb", @@ -88,7 +88,7 @@ "polyglot/runtime-migration.md": "5a78713bb8cb74aea58f6d5d826400d968a405f69c6ff17fdf2f7decb1d14b71", "polyglot/rust-cloud-quickstart.md": "2303434fc9302a81a8381ad4836423ef9952eb3201a4574c432254e3cb68c5f3", "polyglot/rust.md": "602f61be5ec561f27845d4ca0657d71c8f6cc3f08e30d1f657bd62c23dc53314", - "polyglot/server-api-reference.md": "7cf926b66298cd750837f9d7102bbd210e541e36ad89b5f9fbb7616f7581fb82", + "polyglot/server-api-reference.md": "9d215d30468ee7d175005d83ab8c8a8d5d4c2589b4184515d96e7d29404dc6b2", "polyglot/server-config-reference.md": "aec241c0046f12a9d6efe2d6c1de443d7753bdf34135e06a6f83b3904ed1d429", "polyglot/server-role-topology.md": "3d048f0c6b5f179399622508f51e67fff8aa5a6d5b2492533fc720eeec2c27f2", "polyglot/server.md": "f24fd7ff4eebcc768ec8105e8689ab1a14cc08d98167090ebb84e3e26631132a", diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/failures-and-recovery.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/failures-and-recovery.md index 61eb99f3a56..0a75df103fb 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/failures-and-recovery.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/failures-and-recovery.md @@ -261,7 +261,7 @@ Workflow 2.18.0 会复用已完成的活动、副作用、版本标记和已触 2.19.0 之前的版本会忽略复用的信号、备忘录和搜索属性步骤上的 `reused_recorded_at`。在 Workflow 2.19.0 或更高版本的后继运行复用这些步骤之后,请继续使用 2.19.0 或更高版本的 Worker,或在回滚前确认没有这样的历史会被重放。在嵌入模式下,对于复用了更新或链式信号等待的 2.20.0 后继运行,Workflow 2.19.0 的重放、导入和恢复方式与 2.20.0 相同([验证记录](https://github.com/durable-workflow/workflow/issues/864#issuecomment-6617902412))。 -从 3.7.0 起,原生 Server 重驱动将启动时设置的 memo 和搜索属性传给后继运行,`describe()` 在 `actions` 下报告 `can_redrive` 与 `redrive_blocked_reason`。从 3.8.0 起还复用失败步骤之前的副作用与版本标记,记录原始载荷、`reused_from_run_id` 和 `reused_recorded_at`。原生 3.8.0–3.10.x 保留已有复用时间戳字符串,但写入新的回退时钟时只保留整秒,因此这些写入不能证明重放时钟的小数精度相等。这些版本拒绝工作流代码的 memo/搜索属性 upsert(`service_redrive_history_not_qualified`)、外部保存的副作用结果(`external_side_effect_result_not_supported`)以及已触发定时器(`unsupported_history`)。[原生简单定时器与时钟精度扩展](./polyglot/server-api-reference.md#native-redrive-timers)已有通过资格验证的不可变生产者。稳定采用仍需要适用的已安装 SDK 回执及 Chart/release 条件。Core 的精度/参考后续工作及剩余原生一致性仍在 [server#980](https://github.com/durable-workflow/server/issues/980) 跟踪。 +从 3.7.0 起,原生 Server 重驱动将启动时设置的 memo 和搜索属性传给后继运行,`describe()` 在 `actions` 下报告 `can_redrive` 与 `redrive_blocked_reason`。从 3.8.0 起还复用失败步骤之前的副作用与版本标记,记录原始载荷、`reused_from_run_id` 和 `reused_recorded_at`。原生 3.8.0–3.10.x 保留已有复用时间戳字符串,但写入新的回退时钟时只保留整秒,因此这些写入不能证明重放时钟的小数精度相等。这些版本拒绝工作流代码的 memo/搜索属性 upsert(`service_redrive_history_not_qualified`)、外部保存的副作用结果(`external_side_effect_result_not_supported`)以及已触发定时器(`unsupported_history`)。原生 3.11.0 接受失败活动之前已完成的简单定时器,并以 Server 存储的完整毫秒精度写入回退时钟([原生已触发定时器重驱动](./polyglot/server-api-reference.md#native-redrive-timers))。Core 的精度/参考后续工作及剩余原生一致性仍在 [server#980](https://github.com/durable-workflow/server/issues/980) 跟踪。 ## 服务模式入口拒绝与恢复 {#service-entry-recovery} diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md index 79019b100d4..920f865f14e 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/polyglot/server-api-reference.md @@ -353,9 +353,9 @@ Server 也提供协作式 `request-cancellation` 路由。有时限清理契约 ### 原生已触发定时器重驱动与重放时钟 {#native-redrive-timers} -:::note 等待稳定采用与已安装消费者验证 +:::note 原生 Server 3.11.0 起可用 -简单定时器扩展和小数精度修复已合入 [Server 源码 5221ed82](https://github.com/durable-workflow/server/pull/1215)。原生 3.11.0 已有公开的不可变镜像,以及[已接受的生产者/平台/语料库/Compose 资格验证](https://github.com/durable-workflow/server/pull/1218#issuecomment-6868218894)。稳定别名提升、最终 GitHub Release、Chart 采用以及适用的已安装消费者验证仍待完成。当前选定的已发布 Server 保留此前的定时器拒绝和时钟写入行为。仅生产者资格验证不代表已安装 SDK 重放结果或稳定选择。 +原生 Server [3.11.0](https://github.com/durable-workflow/server/releases/tag/3.11.0) 接受已完成的简单定时器,并写入本节所述的重放时钟。更早的原生版本以 `unsupported_history` 拒绝已触发定时器。 ::: @@ -372,7 +372,7 @@ Server 也提供协作式 `request-cancellation` 路由。有时限清理契约 [实际 PHP/Python/Rust 冷 Worker 验证组](https://github.com/durable-workflow/server/issues/980#issuecomment-6865541932)必须在冷替换和重复重驱动期间保持相同工作流定义/指纹。它将完整精度解析的 UTC 时刻与实际观察到的、含非零小数部分的源 `TimerFired` 比较,保留源历史,并检查原始回调次数、新定时器标识以及没有重复定时器工作。仅显示整秒不能证明该精度;不得改写已安装环境的历史来制造结果。使用受控时间戳的源码测试是独立证据。 -不可变生产者/平台/源码资格验证已通过。适用的已安装 SDK 回执、稳定别名/最终 Release 和实际 Chart 发布仍是稳定采用之前的条件。[Core 的精度/参考后续工作](https://github.com/durable-workflow/workflow/issues/992)在 [Server #980](https://github.com/durable-workflow/server/issues/980) 下单独跟踪。该变更不会给未声明支持的 SDK 增加普通入口时钟支持;未修改的 SDK 无须仅为版本号对齐而发布。协议、OpenAPI 和目录结构不变。 +使用已发布 SDK 的已安装冷 worker 回执已在原生 Server 3.11.0 上通过:Rust SDK 4.18.0、Python SDK 2.17.2 和 PHP SDK 3.18.3([Server #980](https://github.com/durable-workflow/server/issues/980))。Server 以毫秒精度存储这些时钟。[Core 的精度/参考后续工作](https://github.com/durable-workflow/workflow/issues/992)在 [Server #980](https://github.com/durable-workflow/server/issues/980) 下单独跟踪。该变更不会给未声明支持的 SDK 增加普通入口时钟支持;未修改的 SDK 无须仅为版本号对齐而发布。协议、OpenAPI 和目录结构不变。 ## 命名空间与存储 {#namespace-and-storage} diff --git a/i18n/zh-Hans/source-hashes.json b/i18n/zh-Hans/source-hashes.json index ac870ff5d7e..f864192dbab 100644 --- a/i18n/zh-Hans/source-hashes.json +++ b/i18n/zh-Hans/source-hashes.json @@ -29,7 +29,7 @@ "defining-workflows/workflow-status.md": "8e8cb27ff44c890d489d89bf166375acfdfaecabd990a2235e106fab1592d529", "defining-workflows/workflows.md": "f467bc73de32aa5d722c61ce085065460382ae7dd44cea4625847d9fcdc4c97c", "deployment.md": "1dd901213228a52e6222a15c6b85305098a4a4db06f198e319a7889c4562bddb", - "failures-and-recovery.md": "5fca75a97d5a32501f0364140e38ff378bcf2fea0b7aeba792edb1322aac7648", + "failures-and-recovery.md": "f36882d22adf0b035216013696cc0af5a8ed4b125f9777d997ad1158faee188e", "features/activity-execution-model.md": "e8c37520ae46a7efb30438f4fc06bf893c1df430cb1f92c48963697adaf09082", "features/cancel-and-terminate.md": "cedd1e6c51dfa551e00edc1d39739ff1f67d558d2a0be92143f478cb6111536b", "features/child-workflows.md": "30dd8e1a131654d6320641446b6bd661f27cd591353a60d007574955749cf8fb", @@ -88,7 +88,7 @@ "polyglot/runtime-migration.md": "5a78713bb8cb74aea58f6d5d826400d968a405f69c6ff17fdf2f7decb1d14b71", "polyglot/rust-cloud-quickstart.md": "2303434fc9302a81a8381ad4836423ef9952eb3201a4574c432254e3cb68c5f3", "polyglot/rust.md": "602f61be5ec561f27845d4ca0657d71c8f6cc3f08e30d1f657bd62c23dc53314", - "polyglot/server-api-reference.md": "7cf926b66298cd750837f9d7102bbd210e541e36ad89b5f9fbb7616f7581fb82", + "polyglot/server-api-reference.md": "9d215d30468ee7d175005d83ab8c8a8d5d4c2589b4184515d96e7d29404dc6b2", "polyglot/server-config-reference.md": "aec241c0046f12a9d6efe2d6c1de443d7753bdf34135e06a6f83b3904ed1d429", "polyglot/server-role-topology.md": "3d048f0c6b5f179399622508f51e67fff8aa5a6d5b2492533fc720eeec2c27f2", "polyglot/server.md": "f24fd7ff4eebcc768ec8105e8689ab1a14cc08d98167090ebb84e3e26631132a",