diff --git a/docs/failures-and-recovery.md b/docs/failures-and-recovery.md index 4fc6805c793..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`, 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`). 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 80c23e89ae2..dd644ecf172 100644 --- a/docs/polyglot/server-api-reference.md +++ b/docs/polyglot/server-api-reference.md @@ -501,6 +501,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 Available from native Server 3.11.0 + +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`. + +::: + +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` | 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. + +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. + +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 Namespace routes require operator or admin roles. Mutating namespace and 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..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)). -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`). 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 5ce48c5bb52..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 @@ -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 Verfügbar ab nativem Server 3.11.0 + +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`. + +::: + +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. + +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} 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 38621ca26ef..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": "a240727af9539cca9cceb6ab3ddea545c95f21402813365442929ea05c09e70c", + "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": "d3f148fc8a12a315d695d47108ce658c80dea78c314b650a3b86f08727a20aee", + "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 53af436b349..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 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`). 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 fc73846eac4..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 @@ -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 Disponible desde Server nativo 3.11.0 + +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`. + +::: + +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. + +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} 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 38621ca26ef..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": "a240727af9539cca9cceb6ab3ddea545c95f21402813365442929ea05c09e70c", + "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": "d3f148fc8a12a315d695d47108ce658c80dea78c314b650a3b86f08727a20aee", + "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 2b220397484..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 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`). 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 be8f2c49774..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 @@ -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 Disponible à partir de Server natif 3.11.0 + +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`. + +::: + +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. + +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} 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 38621ca26ef..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": "a240727af9539cca9cceb6ab3ddea545c95f21402813365442929ea05c09e70c", + "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": "d3f148fc8a12a315d695d47108ce658c80dea78c314b650a3b86f08727a20aee", + "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 676f86d9432..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 以降、ネイティブ 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 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 178c3b379e4..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 @@ -352,6 +352,29 @@ Server は協調的な `request-cancellation` ルートも提供します。時 コマンドは業務値を Avro ペイロードエンベロープで運びます。公式 SDK が自動でエンコードします。直接 HTTP クライアントは、公式 Avro エンコーダーの `{codec, blob}` エンベロープか、以下のランタイム外部参照を使ってください。外側の HTTP 文書は JSON ですが、生の業務 JSON は別のペイロードコーデックとして使えません。 +### 発火済みタイマーの native redrive とリプレイクロック {#native-redrive-timers} + +:::note native Server 3.11.0 から利用可能 + +native Server [3.11.0](https://github.com/durable-workflow/server/releases/tag/3.11.0) は、完了した単純タイマーを受け入れ、このセクションで説明するリプレイクロックを書き込みます。以前の native リリースは、発火済みタイマーを `unsupported_history` で拒否します。 + +::: + +他の条件を満たし、アクティビティで失敗した実行では、新しいソースはその失敗前に完了した単純タイマーを受け入れます。一意のステップに、元の `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、タイマー処理の再実行がないことを確認します。秒単位の表示では精度を検証できず、その結果を作るためにインストール済み環境の履歴を書き換えてはいけません。制御した時刻を使うソーステストは別の証拠です。 + +公開済み 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} 名前空間ルートは operator または admin ロールが必要です。名前空間と外部ストレージの変更には admin ロールが必要です。 diff --git a/i18n/ja/source-hashes.json b/i18n/ja/source-hashes.json index 38621ca26ef..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": "a240727af9539cca9cceb6ab3ddea545c95f21402813365442929ea05c09e70c", + "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": "d3f148fc8a12a315d695d47108ce658c80dea78c314b650a3b86f08727a20aee", + "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 01cc86d323b..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)). -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`). 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 7e5111db3fd..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 @@ -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 Disponível a partir do Server nativo 3.11.0 + +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`. + +::: + +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. + +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} 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 38621ca26ef..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": "a240727af9539cca9cceb6ab3ddea545c95f21402813365442929ea05c09e70c", + "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": "d3f148fc8a12a315d695d47108ce658c80dea78c314b650a3b86f08727a20aee", + "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 2df60014881..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, 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 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 9d52b280854..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 @@ -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 Server 3.11.0 + +Native Server [3.11.0](https://github.com/durable-workflow/server/releases/tag/3.11.0) приймає завершені прості timer і записує описані в цьому розділі годинники replay. Попередні native-релізи відхиляють спрацьовані timer з `unsupported_history`. + +::: + +Для інакше придатного запуску, який завершився помилкою в 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-тести з керованими часовими позначками є окремим доказом. + +Встановлені 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} Маршрути namespace вимагають operator чи admin. Зміни namespace та diff --git a/i18n/uk/source-hashes.json b/i18n/uk/source-hashes.json index 38621ca26ef..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": "a240727af9539cca9cceb6ab3ddea545c95f21402813365442929ea05c09e70c", + "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": "d3f148fc8a12a315d695d47108ce658c80dea78c314b650a3b86f08727a20aee", + "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 1197a8a2646..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 的 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`)。原生 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 47d345be764..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 @@ -351,6 +351,29 @@ Server 也提供协作式 `request-cancellation` 路由。有时限清理契约 命令通过 Avro 负载封装传递业务值,官方 SDK 自动完成编码。直接 HTTP 客户端必须使用官方 Avro 编码器的 `{codec, blob}` 封装,或下述运行时外部引用。外围 HTTP 文档是 JSON,但原始业务 JSON 不是另一种负载编解码格式。 +### 原生已触发定时器重驱动与重放时钟 {#native-redrive-timers} + +:::note 原生 Server 3.11.0 起可用 + +原生 Server [3.11.0](https://github.com/durable-workflow/server/releases/tag/3.11.0) 接受已完成的简单定时器,并写入本节所述的重放时钟。更早的原生版本以 `unsupported_history` 拒绝已触发定时器。 + +::: + +对于其他条件合格、在活动处失败的运行,新源码接受失败之前已完成的简单定时器。其唯一的步骤必须恰好包含一对按顺序排列的 `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 的已安装冷 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} 命名空间路由要求 operator 或 admin 角色。变更命名空间及外部存储的路由要求 admin 角色。 diff --git a/i18n/zh-Hans/source-hashes.json b/i18n/zh-Hans/source-hashes.json index 38621ca26ef..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": "a240727af9539cca9cceb6ab3ddea545c95f21402813365442929ea05c09e70c", + "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": "d3f148fc8a12a315d695d47108ce658c80dea78c314b650a3b86f08727a20aee", + "polyglot/server-api-reference.md": "9d215d30468ee7d175005d83ab8c8a8d5d4c2589b4184515d96e7d29404dc6b2", "polyglot/server-config-reference.md": "aec241c0046f12a9d6efe2d6c1de443d7753bdf34135e06a6f83b3904ed1d429", "polyglot/server-role-topology.md": "3d048f0c6b5f179399622508f51e67fff8aa5a6d5b2492533fc720eeec2c27f2", "polyglot/server.md": "f24fd7ff4eebcc768ec8105e8689ab1a14cc08d98167090ebb84e3e26631132a",