Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 10 additions & 4 deletions docs/polyglot/invocable-carrier.md
Original file line number Diff line number Diff line change
@@ -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
Expand All @@ -25,14 +25,20 @@ 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).
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
Expand Down Expand Up @@ -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 |
| --- | --- | --- |
Expand Down
Original file line number Diff line number Diff line change
@@ -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
Expand All @@ -24,14 +24,20 @@ 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)
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
Expand Down Expand Up @@ -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 |
Expand Down
2 changes: 1 addition & 1 deletion i18n/de/source-hashes.json
Original file line number Diff line number Diff line change
Expand Up @@ -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",
Expand Down
Original file line number Diff line number Diff line change
@@ -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
Expand All @@ -24,14 +24,20 @@ 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).
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
Expand Down Expand Up @@ -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 |
Expand Down
2 changes: 1 addition & 1 deletion i18n/es/source-hashes.json
Original file line number Diff line number Diff line change
Expand Up @@ -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",
Expand Down
Original file line number Diff line number Diff line change
@@ -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
Expand All @@ -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).
Expand All @@ -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
Expand Down Expand Up @@ -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 |
Expand Down
2 changes: 1 addition & 1 deletion i18n/fr/source-hashes.json
Original file line number Diff line number Diff line change
Expand Up @@ -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",
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
sidebar_position: 4
title: 呼び出し可能な HTTP キャリア
description: アクティビティ専用の invocable_http キャリアを設定し、Server がリースしたアクティビティタスクを HTTPS ハンドラーへ POST して構造化された結果を照合できるようにします。
description: アクティビティ専用の invocable_http キャリアを設定し、リースしたアクティビティタスクを HTTPS ハンドラーに対応付けて、構造化された結果を照合します。
tags:
- external-execution
- invocable-carrier
Expand All @@ -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}

Expand Down Expand Up @@ -81,7 +87,7 @@ keywords:

## リクエストとレスポンスのエンベロープ {#request-and-response-envelope}

Server はキャリアに依存しない入力エンベロープを送り、キャリアに依存しない結果エンベロープを期待します。
キャリアのプロセスはキャリアに依存しない入力エンベロープを送り、キャリアに依存しない結果エンベロープを期待します。

| 方向 | コンテンツタイプ | スキーマ |
| --- | --- | --- |
Expand Down
2 changes: 1 addition & 1 deletion i18n/ja/source-hashes.json
Original file line number Diff line number Diff line change
Expand Up @@ -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",
Expand Down
Original file line number Diff line number Diff line change
@@ -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
Expand All @@ -24,14 +24,20 @@ 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).
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
Expand Down Expand Up @@ -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 |
Expand Down
2 changes: 1 addition & 1 deletion i18n/pt-BR/source-hashes.json
Original file line number Diff line number Diff line change
Expand Up @@ -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",
Expand Down
Loading
Loading