title | description | ms.date | monikerRange |
---|---|---|---|
resources.builds.build definition |
A build resource used to reference artifacts from a run. |
11/20/2024 |
<=azure-pipelines |
:::moniker range="<=azure-pipelines"
A build resource used to reference artifacts from a run.
:::moniker-end
:::moniker range=">=azure-pipelines-2020"
builds:
- build: string # Required as first property. Alias or name of build artifact.
type: string # Required. Name of the artifact type.
connection: string # Required. Name of the connection. This connection will be used for all the communication related to this artifact.
source: string # Required. Name of the source definition/build/job.
version: string
branch: string
trigger: none | true # When the artifact mentioned in this build resource completes a build, it is allowed to trigger this pipeline.
:::moniker-end
:::moniker range="<=azure-pipelines-2019.1"
builds:
- build: string # Required as first property. Alias or name of build artifact.
type: string # Required. Name of the artifact type.
connection: string # Required. Name of the connection. This connection will be used for all the communication related to this artifact.
source: string # Required. Name of the source definition/build/job.
version: string
branch: string
:::moniker-end
:::moniker range="<=azure-pipelines"
Definitions that reference this definition: resources.builds
:::moniker-end
:::moniker range="<=azure-pipelines"
build
string. Required as first property.
Alias or name of build artifact. Acceptable values: [-_A-Za-z0-9]*.
:::moniker-end
:::moniker range="<=azure-pipelines"
type
string. Required.
Name of the artifact type.
:::moniker-end
:::moniker range="<=azure-pipelines"
connection
string. Required.
Name of the connection. This connection will be used for all the communication related to this artifact.
:::moniker-end
:::moniker range="<=azure-pipelines"
source
string. Required.
Name of the source definition/build/job.
:::moniker-end
:::moniker range="<=azure-pipelines"
version
string.
:::moniker-end
:::moniker range="<=azure-pipelines"
branch
string.
:::moniker-end
:::moniker range=">=azure-pipelines-2020"
trigger
string.
When the artifact mentioned in this build resource completes a build, it is allowed to trigger this pipeline. none | true.
:::moniker-end
If you have an external CI build system that produces artifacts, you can consume artifacts with a build resource. A build resource can be any external CI systems like Jenkins, TeamCity, CircleCI, and so on.
Important
Triggers are only supported for hosted Jenkins where Azure DevOps has line of sight with Jenkins server.
resources:
builds:
- build: Spaceworkz
type: Jenkins
connection: MyJenkinsServer
source: SpaceworkzProj # name of the jenkins source project
trigger: true