The documentation you are viewing is for Dapr v1.4 which is an older version of Dapr. For up-to-date documentation, see the latest version.

Zeebe JobWorker binding spec

Detailed documentation on the Zeebe JobWorker binding component


To setup Zeebe JobWorker binding create a component of type bindings.zeebe.jobworker. 请参阅本指南,了解如何创建和应用绑定配置。

See this for Zeebe JobWorker documentation.

kind: Component
  name: <NAME>
  namespace: <NAMESPACE>
  type: bindings.zeebe.jobworker
  version: v1
  - name: gatewayAddr
    value: <host>:<port>
  - name: gatewayKeepAlive
    value: 45s
  - name: usePlainTextConnection
    value: true
  - name: caCertificatePath
    value: /path/to/ca-cert
  - name: workerName
    value: products-worker
  - name: workerTimeout
    value: 5m
  - name: requestTimeout
    value: 15s
  - name: jobType
    value: fetch-products
  - name: maxJobsActive
    value: 32
  - name: concurrency
    value: 4
  - name: pollInterval
    value: 100ms
  - name: pollThreshold
    value: 0.3
  - name: fetchVariables
    value: productId, productName, productKey


字段 必填 绑定支持 详情 示例
gatewayAddr Y 输入 Zeebe gateway address localhost:26500
gatewayKeepAlive N 输入 Sets how often keep alive messages should be sent to the gateway. Defaults to 45 seconds 45s
usePlainTextConnection N 输入 Whether to use a plain text connection or not true,false
caCertificatePath N 输入 The path to the CA cert /path/to/ca-cert
workerName N 输入 The name of the worker activating the jobs, mostly used for logging purposes products-worker
workerTimeout N 输入 A job returned after this call will not be activated by another call until the timeout has been reached; defaults to 5 minutes 5m
requestTimeout N 输入 The request will be completed when at least one job is activated or after the requestTimeout. If the requestTimeout = 0, a default timeout is used. If the requestTimeout < 0, long polling is disabled and the request is completed immediately, even when no job is activated. Defaults to 10 seconds 30s
jobType Y 输入 the job type, as defined in the BPMN process (e.g. <zeebe:taskDefinition type="fetch-products" />) fetch-products
maxJobsActive N 输入 Set the maximum number of jobs which will be activated for this worker at the same time. Defaults to 32 32
并发(Concurrency) N 输入 The maximum number of concurrent spawned goroutines to complete jobs. Defaults to 4 4
pollInterval N 输入 Set the maximal interval between polling for new jobs. Defaults to 100 milliseconds 100ms
pollThreshold N 输入 Set the threshold of buffered activated jobs before polling for new jobs, i.e. threshold * maxJobsActive. Defaults to 0.3 0.3
fetchVariables N 输入 A list of variables to fetch as the job variables; if empty, all visible variables at the time of activation for the scope of the job will be returned productId, productName, productKey


This component supports input binding interfaces.



The Zeebe process engine handles the process state as also process variables which can be passed on process instantiation or which can be updated or created during process execution. These variables can be passed to a registered job worker by defining the variable names as comma-separated list in the fetchVariables metadata field. The process engine will then pass these variables with its current values to the job worker implementation.

If the binding will register three variables productId, productName and productKey then the worker will be called with the following JSON body:

  "productId": "some-product-id",
  "productName": "some-product-name",
  "productKey": "some-product-key"

Note: if the fetchVariables metadata field will not be passed, all process variables will be passed to the worker.


The Zeebe process engine has the ability to pass custom task headers to a job worker. These headers can be defined for every service task. Task headers will be passed by the binding as metadata (HTTP headers) to the job worker.

The binding will also pass the following job related variables as metadata. The values will be passed as string. The table contains also the original data type so that it can be converted back to the equivalent data type in the used programming language for the worker.

元数据(Metadata) Data type 说明
X-Zeebe-Job-Key int64 The key, a unique identifier for the job
X-Zeebe-Job-Type string The type of the job (should match what was requested)
X-Zeebe-Process-Instance-Key int64 The job’s process instance key
X-Zeebe-Bpmn-Process-Id string The bpmn process ID of the job process definition
X-Zeebe-Process-Definition-Version int32 The version of the job process definition
X-Zeebe-Process-Definition-Key int64 The key of the job process definition
X-Zeebe-Element-Id string The associated task element ID
X-Zeebe-Element-Instance-Key int64 The unique key identifying the associated task, unique within the scope of the process instance
X-Zeebe-Worker string The name of the worker which activated this job
X-Zeebe-Retries int32 The amount of retries left to this job (should always be positive)
X-Zeebe-Deadline int64 When the job can be activated again, sent as a UNIX epoch timestamp