diff --git a/docs/polyglot/invocable-carrier.md b/docs/polyglot/invocable-carrier.md index fa97bf427c6..c08939e3563 100644 --- a/docs/polyglot/invocable-carrier.md +++ b/docs/polyglot/invocable-carrier.md @@ -1,7 +1,7 @@ --- sidebar_position: 4 title: Invocable HTTP Carrier -description: Configure the activity-only invocable_http carrier so the server can POST a leased activity task to an HTTPS handler endpoint and reconcile the structured result. +description: Configure the activity-only invocable_http carrier, which maps a leased activity task to an HTTPS handler endpoint and reconciles the structured result. tags: - external-execution - invocable-carrier @@ -25,7 +25,7 @@ The invocable HTTP carrier is the first concrete carrier defined under the `carrier_type: invocable_http`. When a configured handler mapping resolves to an `invocable_http` carrier, the -server invokes the configured endpoint with the carrier-neutral +configured endpoint is invoked with the carrier-neutral [external task input envelope](./external-execution.md#published-contract-seams) and reconciles the response against the [external task result envelope](./external-execution.md#published-contract-seams). @@ -33,6 +33,12 @@ Workflow tasks, signal/update ordering, replay, and history mutation stay inside the server. The carrier only moves declared input and result envelopes across an HTTPS boundary. +:::warning + +**Current limitation:** the Server does not send the HTTP request itself. It validates the mapping and returns it on the activity poll response. A process you run must poll the queue, call the endpoint and report the result. If nothing polls the queue, the activity task waits. A Server-side dispatcher will be built when users need it ([#527](https://github.com/durable-workflow/server/issues/527)). + +::: + ## What It Is The invocable HTTP carrier exists for activity-grade work that an operator @@ -123,8 +129,8 @@ substitute for it. ## Request And Response Envelope -The server sends the carrier-neutral input envelope and expects the -carrier-neutral result envelope back: +The carrier process sends the carrier-neutral input envelope and expects +the carrier-neutral result envelope back: | Direction | Content type | Schema | | --- | --- | --- | diff --git a/i18n/de/docusaurus-plugin-content-docs/current/polyglot/invocable-carrier.md b/i18n/de/docusaurus-plugin-content-docs/current/polyglot/invocable-carrier.md index e4a517a6f7c..656453de399 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/polyglot/invocable-carrier.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/polyglot/invocable-carrier.md @@ -1,7 +1,7 @@ --- sidebar_position: 4 title: Aufrufbarer HTTP-Transportadapter -description: Den auf Aktivitäten begrenzten invocable_http-Transportadapter konfigurieren, damit Server einen geleasten Aktivitäts-Task per POST an einen HTTPS-Handler sendet und das strukturierte Ergebnis abgleicht. +description: Den auf Aktivitäten begrenzten invocable_http-Transportadapter konfigurieren, der einen geleasten Aktivitäts-Task einem HTTPS-Handler-Endpunkt zuordnet und das strukturierte Ergebnis abgleicht. tags: - external-execution - invocable-carrier @@ -24,7 +24,7 @@ Der aufrufbare HTTP-Transportadapter ist der erste konkrete Transportadapter der `carrier_type: invocable_http` veröffentlicht. Wird eine konfigurierte Handler-Zuordnung zu einem `invocable_http`-Transportadapter -aufgelöst, ruft der Server den konfigurierten Endpunkt mit der transportneutralen +aufgelöst, ruft der Carrier-Prozess den konfigurierten Endpunkt mit der transportneutralen [externen Task-Eingabe-Envelope](./external-execution.md#published-contract-seams) auf und gleicht die Antwort mit der [externen Task-Ergebnis-Envelope](./external-execution.md#published-contract-seams) @@ -32,6 +32,12 @@ ab. Workflow-Tasks, Signal-/Update-Reihenfolge, Replay und Änderungen an der Historie bleiben im Server. Der Transportadapter bewegt nur deklarierte Eingabe- und Ergebnis-Envelopes über eine HTTPS-Grenze. +:::warning + +**Aktuelle Einschränkung:** Der Server sendet die HTTP-Anfrage nicht selbst. Er prüft die Zuordnung und liefert sie in der Antwort auf den Activity-Poll. Ein von Ihnen betriebener Prozess muss die Queue pollen, den Endpunkt aufrufen und das Ergebnis melden. Pollt niemand die Queue, wartet die Activity-Aufgabe. Ein serverseitiger Dispatcher wird gebaut, sobald Nutzer ihn brauchen ([#527](https://github.com/durable-workflow/server/issues/527)). + +::: + ## Zweck {#what-it-is} Der aufrufbare HTTP-Transportadapter dient Arbeit auf Aktivitätsniveau, die ein @@ -120,7 +126,7 @@ des Transportadapters verlängert, überschreibt oder ersetzt diese nicht. ## Anfrage- und Antwort-Envelope {#request-and-response-envelope} -Der Server sendet die transportneutrale Eingabe-Envelope und erwartet die +Der Carrier-Prozess sendet die transportneutrale Eingabe-Envelope und erwartet die transportneutrale Ergebnis-Envelope zurück: | Richtung | Inhaltstyp | Schema | diff --git a/i18n/de/source-hashes.json b/i18n/de/source-hashes.json index 738d7a0b347..4ec35cae6fb 100644 --- a/i18n/de/source-hashes.json +++ b/i18n/de/source-hashes.json @@ -77,7 +77,7 @@ "polyglot/deployment-modes.md": "7b508db4be86c92de76cfd8dfd946d93941c8a6f0a601a161d4d3fd1711bf97f", "polyglot/embedded-to-server.md": "21a7e4c9439a73db3a97fd9b0610749faabf7c449806fe0ad55a0924f50d3b80", "polyglot/external-execution.md": "410728db1107c328d0cb129cbf0c58f4fa8c6427e0406610d6801dfeb8a2db31", - "polyglot/invocable-carrier.md": "d32d8b5c7c33204b342f977e0af734166d91e96073db1a49ccb4d414a6d67380", + "polyglot/invocable-carrier.md": "00bcf878b7bac1be90718b73f0a626a99cf0e111414ac0854c6491d159798c01", "polyglot/invocable-php-handler.md": "3b678eb1d69fe32dfcfdc05d36b33e49e01b79d7216bd784f6a61a6f1c3c3a13", "polyglot/namespace-auth-workers.md": "fee5e52a18637814f60aeb419f7ebc99ce4927089dfb748073697a8218bd47bb", "polyglot/php.md": "309e83622754b9d9abc65807280f2dab175a009054a001456ef1316776f11101", diff --git a/i18n/es/docusaurus-plugin-content-docs/current/polyglot/invocable-carrier.md b/i18n/es/docusaurus-plugin-content-docs/current/polyglot/invocable-carrier.md index 01d7ee9251f..4b29c73a723 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/polyglot/invocable-carrier.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/polyglot/invocable-carrier.md @@ -1,7 +1,7 @@ --- sidebar_position: 4 title: Transportador HTTP invocable -description: Configura el transportador invocable_http exclusivo de actividades para que el servidor envíe por POST una tarea con lease a un manejador HTTPS y concilie el resultado estructurado. +description: Configura el transportador invocable_http exclusivo de actividades, que asigna una tarea con lease a un manejador HTTPS y concilia el resultado estructurado. tags: - external-execution - invocable-carrier @@ -24,7 +24,7 @@ la [interfaz de ejecución externa](./external-execution.md). Se publica mediant `carrier_type: invocable_http`. Cuando una asignación de manejador configurada se resuelve a un transportador -`invocable_http`, el servidor invoca el endpoint configurado con el +`invocable_http`, el proceso transportador invoca el endpoint configurado con el [sobre de entrada de tarea externa](./external-execution.md#published-contract-seams) independiente del transportador y concilia la respuesta con el [sobre de resultado de tarea externa](./external-execution.md#published-contract-seams). @@ -32,6 +32,12 @@ Las tareas de workflow, el orden de señales/actualizaciones, la reproducción y la modificación del historial permanecen en el servidor. El transportador solo traslada los sobres declarados de entrada y resultado a través de HTTPS. +:::warning + +**Limitación actual:** el Server no envía la solicitud HTTP por sí mismo. Valida la asignación y la devuelve en la respuesta del poll de actividades. Un proceso que usted ejecute debe hacer poll de la cola, llamar al endpoint e informar el resultado. Si nadie hace poll de la cola, la tarea de actividad espera. Se construirá un despachador en el Server cuando los usuarios lo necesiten ([#527](https://github.com/durable-workflow/server/issues/527)). + +::: + ## Qué es {#what-it-is} El transportador sirve para trabajo con garantías de actividad que el equipo @@ -119,7 +125,7 @@ la amplía, reemplaza ni sustituye. ## Sobres de solicitud y respuesta {#request-and-response-envelope} -El servidor envía el sobre de entrada independiente del transportador y espera +El proceso transportador envía el sobre de entrada independiente del transportador y espera recibir el sobre de resultado independiente del transportador: | Sentido | Tipo de contenido | Esquema | diff --git a/i18n/es/source-hashes.json b/i18n/es/source-hashes.json index 738d7a0b347..4ec35cae6fb 100644 --- a/i18n/es/source-hashes.json +++ b/i18n/es/source-hashes.json @@ -77,7 +77,7 @@ "polyglot/deployment-modes.md": "7b508db4be86c92de76cfd8dfd946d93941c8a6f0a601a161d4d3fd1711bf97f", "polyglot/embedded-to-server.md": "21a7e4c9439a73db3a97fd9b0610749faabf7c449806fe0ad55a0924f50d3b80", "polyglot/external-execution.md": "410728db1107c328d0cb129cbf0c58f4fa8c6427e0406610d6801dfeb8a2db31", - "polyglot/invocable-carrier.md": "d32d8b5c7c33204b342f977e0af734166d91e96073db1a49ccb4d414a6d67380", + "polyglot/invocable-carrier.md": "00bcf878b7bac1be90718b73f0a626a99cf0e111414ac0854c6491d159798c01", "polyglot/invocable-php-handler.md": "3b678eb1d69fe32dfcfdc05d36b33e49e01b79d7216bd784f6a61a6f1c3c3a13", "polyglot/namespace-auth-workers.md": "fee5e52a18637814f60aeb419f7ebc99ce4927089dfb748073697a8218bd47bb", "polyglot/php.md": "309e83622754b9d9abc65807280f2dab175a009054a001456ef1316776f11101", diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/polyglot/invocable-carrier.md b/i18n/fr/docusaurus-plugin-content-docs/current/polyglot/invocable-carrier.md index 40f0efc9bb0..c5809090fa4 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/polyglot/invocable-carrier.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/polyglot/invocable-carrier.md @@ -1,7 +1,7 @@ --- sidebar_position: 4 title: Transporteur HTTP invocable -description: Configurer le transporteur invocable_http réservé aux activités pour que le serveur envoie une tâche d'activité sous bail par POST à un gestionnaire HTTPS et rapproche le résultat structuré. +description: Configurer le transporteur invocable_http réservé aux activités, qui associe une tâche d'activité sous bail à un gestionnaire HTTPS et rapproche le résultat structuré. tags: - external-execution - invocable-carrier @@ -24,7 +24,7 @@ l'[interface d'exécution externe](./external-execution.md). Il est publié par `carrier_type: invocable_http`. Lorsqu'une correspondance de gestionnaire configurée se résout en transporteur -`invocable_http`, le serveur invoque le point de terminaison configuré avec +`invocable_http`, le processus transporteur invoque le point de terminaison configuré avec l'[enveloppe d'entrée de tâche externe](./external-execution.md#published-contract-seams) indépendante du transporteur, puis rapproche la réponse de l'[enveloppe de résultat de tâche externe](./external-execution.md#published-contract-seams). @@ -33,6 +33,12 @@ modifications de l'historique restent dans le serveur. Le transporteur se limite au transfert des enveloppes déclarées d'entrée et de résultat à travers une frontière HTTPS. +:::warning + +**Limitation actuelle :** le Server n'envoie pas lui-même la requête HTTP. Il valide le mappage et le renvoie dans la réponse au poll d'activités. Un processus que vous exploitez doit interroger la file, appeler le point de terminaison et rapporter le résultat. Si personne n'interroge la file, la tâche d'activité attend. Un répartiteur côté Server sera construit quand les utilisateurs en auront besoin ([#527](https://github.com/durable-workflow/server/issues/527)). + +::: + ## Définition {#what-it-is} Le transporteur HTTP invocable sert aux tâches de niveau activité qu'une @@ -128,7 +134,7 @@ ne la prolonge pas, ne la remplace pas et ne la supplante pas. ## Enveloppes de requête et de réponse {#request-and-response-envelope} -Le serveur envoie l'enveloppe d'entrée indépendante du transporteur et attend +Le processus transporteur envoie l'enveloppe d'entrée indépendante du transporteur et attend en retour l'enveloppe de résultat indépendante du transporteur : | Direction | Type de contenu | Schéma | diff --git a/i18n/fr/source-hashes.json b/i18n/fr/source-hashes.json index 738d7a0b347..4ec35cae6fb 100644 --- a/i18n/fr/source-hashes.json +++ b/i18n/fr/source-hashes.json @@ -77,7 +77,7 @@ "polyglot/deployment-modes.md": "7b508db4be86c92de76cfd8dfd946d93941c8a6f0a601a161d4d3fd1711bf97f", "polyglot/embedded-to-server.md": "21a7e4c9439a73db3a97fd9b0610749faabf7c449806fe0ad55a0924f50d3b80", "polyglot/external-execution.md": "410728db1107c328d0cb129cbf0c58f4fa8c6427e0406610d6801dfeb8a2db31", - "polyglot/invocable-carrier.md": "d32d8b5c7c33204b342f977e0af734166d91e96073db1a49ccb4d414a6d67380", + "polyglot/invocable-carrier.md": "00bcf878b7bac1be90718b73f0a626a99cf0e111414ac0854c6491d159798c01", "polyglot/invocable-php-handler.md": "3b678eb1d69fe32dfcfdc05d36b33e49e01b79d7216bd784f6a61a6f1c3c3a13", "polyglot/namespace-auth-workers.md": "fee5e52a18637814f60aeb419f7ebc99ce4927089dfb748073697a8218bd47bb", "polyglot/php.md": "309e83622754b9d9abc65807280f2dab175a009054a001456ef1316776f11101", diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/polyglot/invocable-carrier.md b/i18n/ja/docusaurus-plugin-content-docs/current/polyglot/invocable-carrier.md index 8c66210b0a2..be549dc358c 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/polyglot/invocable-carrier.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/polyglot/invocable-carrier.md @@ -1,7 +1,7 @@ --- sidebar_position: 4 title: 呼び出し可能な HTTP キャリア -description: アクティビティ専用の invocable_http キャリアを設定し、Server がリースしたアクティビティタスクを HTTPS ハンドラーへ POST して構造化された結果を照合できるようにします。 +description: アクティビティ専用の invocable_http キャリアを設定し、リースしたアクティビティタスクを HTTPS ハンドラーに対応付けて、構造化された結果を照合します。 tags: - external-execution - invocable-carrier @@ -19,7 +19,13 @@ keywords: 呼び出し可能な HTTP キャリアは、[外部実行サーフェス](./external-execution.md)で定義された最初の具体的なキャリアです。`GET /api/cluster/info` の `worker_protocol.invocable_carrier_contract` で、`schema: durable-workflow.v2.invocable-carrier.contract`、`version: 1`、`carrier_type: invocable_http` として公開します。 -設定されたハンドラーマッピングが `invocable_http` キャリアに解決されると、Server はキャリアに依存しない[外部タスク入力エンベロープ](./external-execution.md#published-contract-seams)で設定済みエンドポイントを呼び出し、レスポンスを[外部タスク結果エンベロープ](./external-execution.md#published-contract-seams)に照らして照合します。ワークフロータスク、シグナル・更新の順序、リプレイ、履歴の変更は Server 内に残ります。キャリアは宣言された入力と結果のエンベロープを HTTPS 境界の向こうへ運ぶだけです。 +設定されたハンドラーマッピングが `invocable_http` キャリアに解決されると、キャリアのプロセスはキャリアに依存しない[外部タスク入力エンベロープ](./external-execution.md#published-contract-seams)で設定済みエンドポイントを呼び出し、レスポンスを[外部タスク結果エンベロープ](./external-execution.md#published-contract-seams)に照らして照合します。ワークフロータスク、シグナル・更新の順序、リプレイ、履歴の変更は Server 内に残ります。キャリアは宣言された入力と結果のエンベロープを HTTPS 境界の向こうへ運ぶだけです。 + +:::warning + +**現在の制限:** Server 自身は HTTP リクエストを送信しません。マッピングを検証し、アクティビティのポーリング応答で返します。キューをポーリングし、エンドポイントを呼び出し、結果を報告するプロセスを自分で実行する必要があります。キューをポーリングするものがなければ、アクティビティタスクは待機したままです。Server 側のディスパッチャーは、ユーザーが必要とした時点で作ります([#527](https://github.com/durable-workflow/server/issues/527))。 + +::: ## 用途 {#what-it-is} @@ -81,7 +87,7 @@ keywords: ## リクエストとレスポンスのエンベロープ {#request-and-response-envelope} -Server はキャリアに依存しない入力エンベロープを送り、キャリアに依存しない結果エンベロープを期待します。 +キャリアのプロセスはキャリアに依存しない入力エンベロープを送り、キャリアに依存しない結果エンベロープを期待します。 | 方向 | コンテンツタイプ | スキーマ | | --- | --- | --- | diff --git a/i18n/ja/source-hashes.json b/i18n/ja/source-hashes.json index 738d7a0b347..4ec35cae6fb 100644 --- a/i18n/ja/source-hashes.json +++ b/i18n/ja/source-hashes.json @@ -77,7 +77,7 @@ "polyglot/deployment-modes.md": "7b508db4be86c92de76cfd8dfd946d93941c8a6f0a601a161d4d3fd1711bf97f", "polyglot/embedded-to-server.md": "21a7e4c9439a73db3a97fd9b0610749faabf7c449806fe0ad55a0924f50d3b80", "polyglot/external-execution.md": "410728db1107c328d0cb129cbf0c58f4fa8c6427e0406610d6801dfeb8a2db31", - "polyglot/invocable-carrier.md": "d32d8b5c7c33204b342f977e0af734166d91e96073db1a49ccb4d414a6d67380", + "polyglot/invocable-carrier.md": "00bcf878b7bac1be90718b73f0a626a99cf0e111414ac0854c6491d159798c01", "polyglot/invocable-php-handler.md": "3b678eb1d69fe32dfcfdc05d36b33e49e01b79d7216bd784f6a61a6f1c3c3a13", "polyglot/namespace-auth-workers.md": "fee5e52a18637814f60aeb419f7ebc99ce4927089dfb748073697a8218bd47bb", "polyglot/php.md": "309e83622754b9d9abc65807280f2dab175a009054a001456ef1316776f11101", diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/polyglot/invocable-carrier.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/polyglot/invocable-carrier.md index 4c7290a400b..362566e73d4 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/polyglot/invocable-carrier.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/polyglot/invocable-carrier.md @@ -1,7 +1,7 @@ --- sidebar_position: 4 title: Transportador HTTP invocável -description: Configure o transportador invocable_http exclusivo de atividades para que o servidor envie uma tarefa de atividade sob lease por POST a um handler HTTPS e reconcilie o resultado estruturado. +description: Configure o transportador invocable_http exclusivo de atividades, que mapeia uma tarefa de atividade sob lease para um handler HTTPS e reconcilia o resultado estruturado. tags: - external-execution - invocable-carrier @@ -24,7 +24,7 @@ O transportador HTTP invocável é o primeiro transportador concreto definido na `carrier_type: invocable_http`. Quando um mapeamento de handler configurado resolve para um transportador -`invocable_http`, o servidor invoca o endpoint configurado com o +`invocable_http`, o processo transportador invoca o endpoint configurado com o [envelope de entrada de tarefa externa](./external-execution.md#published-contract-seams) independente de transportador e reconcilia a resposta com o [envelope de resultado de tarefa externa](./external-execution.md#published-contract-seams). @@ -32,6 +32,12 @@ Tarefas de workflow, ordenação de sinais/atualizações, replay e mutação do histórico permanecem no servidor. O transportador apenas move os envelopes declarados de entrada e resultado por um limite HTTPS. +:::warning + +**Limitação atual:** o Server não envia a requisição HTTP por conta própria. Ele valida o mapeamento e o devolve na resposta do poll de atividades. Um processo que você executa precisa fazer poll da fila, chamar o endpoint e informar o resultado. Se ninguém fizer poll da fila, a tarefa de atividade fica aguardando. Um despachante no Server será construído quando os usuários precisarem ([#527](https://github.com/durable-workflow/server/issues/527)). + +::: + ## O que é {#what-it-is} O transportador HTTP invocável existe para trabalho com garantias de atividade @@ -121,7 +127,7 @@ amplia, substitui nem sobrepõe. ## Envelope de requisição e resposta {#request-and-response-envelope} -O servidor envia o envelope de entrada independente de transportador e espera +O processo transportador envia o envelope de entrada independente de transportador e espera receber o envelope de resultado independente de transportador: | Direção | Tipo de conteúdo | Schema | diff --git a/i18n/pt-BR/source-hashes.json b/i18n/pt-BR/source-hashes.json index 738d7a0b347..4ec35cae6fb 100644 --- a/i18n/pt-BR/source-hashes.json +++ b/i18n/pt-BR/source-hashes.json @@ -77,7 +77,7 @@ "polyglot/deployment-modes.md": "7b508db4be86c92de76cfd8dfd946d93941c8a6f0a601a161d4d3fd1711bf97f", "polyglot/embedded-to-server.md": "21a7e4c9439a73db3a97fd9b0610749faabf7c449806fe0ad55a0924f50d3b80", "polyglot/external-execution.md": "410728db1107c328d0cb129cbf0c58f4fa8c6427e0406610d6801dfeb8a2db31", - "polyglot/invocable-carrier.md": "d32d8b5c7c33204b342f977e0af734166d91e96073db1a49ccb4d414a6d67380", + "polyglot/invocable-carrier.md": "00bcf878b7bac1be90718b73f0a626a99cf0e111414ac0854c6491d159798c01", "polyglot/invocable-php-handler.md": "3b678eb1d69fe32dfcfdc05d36b33e49e01b79d7216bd784f6a61a6f1c3c3a13", "polyglot/namespace-auth-workers.md": "fee5e52a18637814f60aeb419f7ebc99ce4927089dfb748073697a8218bd47bb", "polyglot/php.md": "309e83622754b9d9abc65807280f2dab175a009054a001456ef1316776f11101", diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/polyglot/invocable-carrier.md b/i18n/uk/docusaurus-plugin-content-docs/current/polyglot/invocable-carrier.md index d89651b7826..1f01aff6122 100644 --- a/i18n/uk/docusaurus-plugin-content-docs/current/polyglot/invocable-carrier.md +++ b/i18n/uk/docusaurus-plugin-content-docs/current/polyglot/invocable-carrier.md @@ -1,7 +1,7 @@ --- sidebar_position: 4 title: Викличний HTTP-транспорт -description: Налаштування транспорту invocable_http лише для activities, щоб Server міг надсилати орендовані завдання activity до HTTPS-обробника й узгоджувати структурований результат. +description: Налаштування транспорту invocable_http лише для activities, який зіставляє орендоване завдання activity з HTTPS-обробником і узгоджує структурований результат. tags: - external-execution - invocable-carrier @@ -25,7 +25,7 @@ keywords: `version: 1` та `carrier_type: invocable_http`. Коли налаштоване зіставлення обробника визначає carrier `invocable_http`, -Server викликає його endpoint з незалежною від carrier +Процес carrier викликає його endpoint з незалежною від carrier [оболонкою вхідних даних external task](./external-execution.md#published-contract-seams) і узгоджує відповідь з [оболонкою результату external task](./external-execution.md#published-contract-seams). @@ -33,6 +33,12 @@ Workflow tasks, порядок signals/updates, replay і зміни істор залишаються всередині Server. Carrier лише передає визначені оболонки вхідних даних і результатів через межу HTTPS. +:::warning + +**Поточне обмеження:** Server не надсилає HTTP-запит сам. Він перевіряє відображення й повертає його у відповіді на poll activity. Процес, який ви запускаєте, має опитувати чергу, викликати endpoint і повідомляти результат. Якщо чергу ніхто не опитує, activity task чекає. Диспетчер на боці Server буде створено, коли він знадобиться користувачам ([#527](https://github.com/durable-workflow/server/issues/527)). + +::: + ## Призначення {#what-it-is} Invocable HTTP carrier призначений для роботи рівня activity, яку @@ -120,7 +126,7 @@ Server перевіряє `target_fields` carrier перед публікаці ## Оболонки запиту та відповіді {#request-and-response-envelope} -Server надсилає незалежну від carrier оболонку вхідних даних +Процес carrier надсилає незалежну від carrier оболонку вхідних даних і очікує таку саму незалежну оболонку результату: | Напрямок | Content type | Schema | diff --git a/i18n/uk/source-hashes.json b/i18n/uk/source-hashes.json index 738d7a0b347..4ec35cae6fb 100644 --- a/i18n/uk/source-hashes.json +++ b/i18n/uk/source-hashes.json @@ -77,7 +77,7 @@ "polyglot/deployment-modes.md": "7b508db4be86c92de76cfd8dfd946d93941c8a6f0a601a161d4d3fd1711bf97f", "polyglot/embedded-to-server.md": "21a7e4c9439a73db3a97fd9b0610749faabf7c449806fe0ad55a0924f50d3b80", "polyglot/external-execution.md": "410728db1107c328d0cb129cbf0c58f4fa8c6427e0406610d6801dfeb8a2db31", - "polyglot/invocable-carrier.md": "d32d8b5c7c33204b342f977e0af734166d91e96073db1a49ccb4d414a6d67380", + "polyglot/invocable-carrier.md": "00bcf878b7bac1be90718b73f0a626a99cf0e111414ac0854c6491d159798c01", "polyglot/invocable-php-handler.md": "3b678eb1d69fe32dfcfdc05d36b33e49e01b79d7216bd784f6a61a6f1c3c3a13", "polyglot/namespace-auth-workers.md": "fee5e52a18637814f60aeb419f7ebc99ce4927089dfb748073697a8218bd47bb", "polyglot/php.md": "309e83622754b9d9abc65807280f2dab175a009054a001456ef1316776f11101", diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/polyglot/invocable-carrier.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/polyglot/invocable-carrier.md index f4c75f7c162..0fa3a32fdcc 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/polyglot/invocable-carrier.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/polyglot/invocable-carrier.md @@ -1,7 +1,7 @@ --- sidebar_position: 4 title: 可调用 HTTP 载体 -description: 配置仅支持活动的 invocable_http 载体,让服务器将已租用活动任务 POST 到 HTTPS 处理器端点,并核对结构化结果。 +description: 配置仅支持活动的 invocable_http 载体,将已租用活动任务映射到 HTTPS 处理器端点,并核对结构化结果。 tags: - external-execution - invocable-carrier @@ -19,7 +19,13 @@ keywords: 可调用 HTTP 载体是[外部执行接口](./external-execution.md)定义的第一个具体载体。它由 `GET /api/cluster/info` 的 `worker_protocol.invocable_carrier_contract` 发布,使用 `schema: durable-workflow.v2.invocable-carrier.contract`、`version: 1` 和 `carrier_type: invocable_http`。 -配置的处理器映射解析到 `invocable_http` 载体时,服务器携带与载体无关的[外部任务输入封装](./external-execution.md#published-contract-seams)调用配置的端点,并根据[外部任务结果封装](./external-execution.md#published-contract-seams)核对响应。工作流任务、信号和更新排序、重放及历史变更仍在服务器内进行。载体仅跨 HTTPS 边界传递已声明的输入和结果封装。 +配置的处理器映射解析到 `invocable_http` 载体时,载体进程携带与载体无关的[外部任务输入封装](./external-execution.md#published-contract-seams)调用配置的端点,并根据[外部任务结果封装](./external-execution.md#published-contract-seams)核对响应。工作流任务、信号和更新排序、重放及历史变更仍在服务器内进行。载体仅跨 HTTPS 边界传递已声明的输入和结果封装。 + +:::warning + +**当前限制:** Server 本身不会发送 HTTP 请求。它校验映射,并在 activity 轮询响应中返回该映射。你需要运行一个进程来轮询队列、调用端点并报告结果。如果没有进程轮询该队列,activity 任务会一直等待。等用户需要时,我们再构建 Server 端的分发器([#527](https://github.com/durable-workflow/server/issues/527))。 + +::: ## 用途 {#what-it-is} @@ -81,7 +87,7 @@ keywords: ## 请求与响应封装 {#request-and-response-envelope} -服务器发送与载体无关的输入封装,并期望返回与载体无关的结果封装: +载体进程发送与载体无关的输入封装,并期望返回与载体无关的结果封装: | 方向 | 内容类型 | Schema | | --- | --- | --- | diff --git a/i18n/zh-Hans/source-hashes.json b/i18n/zh-Hans/source-hashes.json index 738d7a0b347..4ec35cae6fb 100644 --- a/i18n/zh-Hans/source-hashes.json +++ b/i18n/zh-Hans/source-hashes.json @@ -77,7 +77,7 @@ "polyglot/deployment-modes.md": "7b508db4be86c92de76cfd8dfd946d93941c8a6f0a601a161d4d3fd1711bf97f", "polyglot/embedded-to-server.md": "21a7e4c9439a73db3a97fd9b0610749faabf7c449806fe0ad55a0924f50d3b80", "polyglot/external-execution.md": "410728db1107c328d0cb129cbf0c58f4fa8c6427e0406610d6801dfeb8a2db31", - "polyglot/invocable-carrier.md": "d32d8b5c7c33204b342f977e0af734166d91e96073db1a49ccb4d414a6d67380", + "polyglot/invocable-carrier.md": "00bcf878b7bac1be90718b73f0a626a99cf0e111414ac0854c6491d159798c01", "polyglot/invocable-php-handler.md": "3b678eb1d69fe32dfcfdc05d36b33e49e01b79d7216bd784f6a61a6f1c3c3a13", "polyglot/namespace-auth-workers.md": "fee5e52a18637814f60aeb419f7ebc99ce4927089dfb748073697a8218bd47bb", "polyglot/php.md": "309e83622754b9d9abc65807280f2dab175a009054a001456ef1316776f11101",