Azure DevOps Pipelines Run

Azure DevOps Pipelines Run

Certified

Trigger and monitor an Azure DevOps pipeline run

Dispatches a pipeline run in Azure DevOps. Optionally blocks and polls until the run reaches a terminal state. Supports cancellation on task kill, dynamic template parameters, variables, and branch selection.

yaml
type: io.kestra.plugin.azure.devops.pipelines.Run

Trigger an Azure DevOps pipeline and wait for completion

yaml
id: run_azure_devops_pipeline
namespace: company.team

tasks:
  - id: trigger_pipeline
    type: io.kestra.plugin.azure.devops.pipelines.Run
    organization: my-org
    project: my-project
    pipelineId: 42
    personalAccessToken: "{{ secret('AZURE_DEVOPS_PAT') }}"
    branch: main
    templateParameters:
      environment: production
    wait: true
    maxDuration: PT45M

Trigger an Azure DevOps pipeline asynchronously (fire-and-forget)

yaml
id: trigger_async_pipeline
namespace: company.team

tasks:
  - id: async_run
    type: io.kestra.plugin.azure.devops.pipelines.Run
    organization: my-org
    project: my-project
    pipelineId: 42
    personalAccessToken: "{{ secret('AZURE_DEVOPS_PAT') }}"
    wait: false
Properties

Azure DevOps organization

The name of the Azure DevOps organization or Azure DevOps Server collection.

Pipeline ID

The unique identifier of the Azure DevOps pipeline to run.

Azure DevOps project

The name or ID of the Azure DevOps project containing the pipeline.

Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.

Definitions
assetFailureBehaviorstring
Possible Values
IGNOREFAILWARN

Asset failure behavior

Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.

enableAutobooleanstring

Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.

inputsarray

The assets consumed as inputs.

id*string
Min length1
typestring
outputs

The assets produced as outputs.

id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*string
Min length1

Custom asset type

descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
Defaulthttps://dev.azure.com

Base URL

Base URL of the Azure DevOps instance. Defaults to https://dev.azure.com. Configure this property when connecting to an on-premises Azure DevOps Server.

Target branch or ref

Branch name (e.g. main, release/1.0) or Git reference to build.

Azure client ID

Client ID of the Azure service principal.

Azure client secret

Client secret of the Azure service principal.

DefaultPT30M

Maximum duration

Maximum duration to wait for the pipeline run to reach a terminal state when wait is true. Defaults to PT30M.

PEM certificate

PEM certificate content for certificate-based authentication.

Personal Access Token

Azure DevOps Personal Access Token (PAT) with Build: Read & execute scope. If omitted, Microsoft Entra ID service principal credentials must be configured.

DefaultPT5S

Poll interval

Interval between status polling requests when wait is enabled. Defaults to PT5S.

Template parameters

Optional template parameters passed to the pipeline run definition.

Azure tenant ID

Azure Entra tenant ID used for service principal authentication.

Pipeline variables

Variables passed to the pipeline run. Values can be primitive strings or maps containing a value key.

Defaultfalse

Wait for completion

Whether to block and poll until the pipeline run finishes. Defaults to false.

Formatdate-time

Creation timestamp

Timestamp when the pipeline run was created.

Formatdate-time

Finish timestamp

Timestamp when the pipeline run finished executing.

Run ID

The unique identifier of the pipeline run.

Run name

The name or build number of the pipeline run.

Run result

The outcome result of the pipeline run (e.g. succeeded, failed, canceled).

Run state

The state of the pipeline run (e.g. inProgress, completed, canceling, notStarted).

Web URL

Azure DevOps browser URL to view the pipeline run execution.

More Plugins in this Category

VMware (EE)
VMware
Enterprise

Tasks that automate VMware vSphere operations within Kestra workflows.

Infrastructure

33 tasks

3 blueprints

Salesforce (EE)
Salesforce
Enterprise

Tasks that connect to Salesforce in Kestra to query data, manage records, and trigger flows from CRM events.

Business

5 tasks

1 blueprints