DownloadBuildArtifacts@0 - ビルド成果物 v0 タスクをダウンロードする
このタスクを使用して、完了したビルドの成果物として保存されたファイルをダウンロードします。
Azure DevOps Servicesを使用している場合は、パフォーマンスを向上させるために、パイプライン成果物のダウンロードとパイプライン成果物の発行を使用することをお勧めします。
注意
Azure DevOps Serverを使用して個人用アクセス トークンによる認証を許可する場合は、IIS 基本認証を無効にします。 詳細については、「 IIS 基本認証と PAT」 を参照してください。
ビルド成果物をダウンロードします。
構文
# Download build artifacts v0
# Download files that were saved as artifacts of a completed build.
- task: DownloadBuildArtifacts@0
inputs:
buildType: 'current' # 'current' | 'specific'. Required. Download artifacts produced by. Default: current.
#project: # string. Required when buildType == specific. Project.
#pipeline: # string. Alias: definition. Required when buildType == specific. Build pipeline.
#specificBuildWithTriggering: false # boolean. Optional. Use when buildType == specific. When appropriate, download artifacts from the triggering build. Default: false.
#buildVersionToDownload: 'latest' # 'latest' | 'latestFromBranch' | 'specific'. Required when buildType == specific. Build version to download. Default: latest.
#allowPartiallySucceededBuilds: false # boolean. Optional. Use when buildType == specific && buildVersionToDownload != specific. Download artifacts even from partially succeeded builds. Default: false.
#branchName: 'refs/heads/master' # string. Required when buildType == specific && buildVersionToDownload == latestFromBranch. Branch name. Default: refs/heads/master.
#buildId: # string. Required when buildType == specific && buildVersionToDownload == specific. Build.
#tags: # string. Optional. Use when buildType == specific && buildVersionToDownload != specific. Build Tags.
downloadType: 'single' # 'single' | 'specific'. Required. Download type. Default: single.
artifactName: # string. Required when downloadType == single. Artifact name.
#itemPattern: '**' # string. Matching pattern. Default: **.
downloadPath: '$(System.ArtifactsDirectory)' # string. Required. Destination directory. Default: $(System.ArtifactsDirectory).
#cleanDestinationFolder: false # boolean. Clean destination folder. Default: false.
# Advanced
#parallelizationLimit: '8' # string. Parallelization limit. Default: 8.
#checkDownloadedFiles: false # boolean. Check downloaded files. Default: false.
#retryDownloadCount: '4' # string. Retry count. Default: 4.
#retryRedirectDownloadCount: '0' # string. Retry count for redirect download. Default: 0.
#extractTars: # boolean. Extract all files that are stored inside tar archives.
# Download build artifacts v0
# Download files that were saved as artifacts of a completed build.
- task: DownloadBuildArtifacts@0
inputs:
buildType: 'current' # 'current' | 'specific'. Required. Download artifacts produced by. Default: current.
#project: # string. Required when buildType == specific. Project.
#pipeline: # string. Alias: definition. Required when buildType == specific. Build pipeline.
#specificBuildWithTriggering: false # boolean. Optional. Use when buildType == specific. When appropriate, download artifacts from the triggering build. Default: false.
#buildVersionToDownload: 'latest' # 'latest' | 'latestFromBranch' | 'specific'. Required when buildType == specific. Build version to download. Default: latest.
#allowPartiallySucceededBuilds: false # boolean. Optional. Use when buildType == specific && buildVersionToDownload != specific. Download artifacts even from partially succeeded builds. Default: false.
#branchName: 'refs/heads/master' # string. Required when buildType == specific && buildVersionToDownload == latestFromBranch. Branch name. Default: refs/heads/master.
#buildId: # string. Required when buildType == specific && buildVersionToDownload == specific. Build.
#tags: # string. Optional. Use when buildType == specific && buildVersionToDownload != specific. Build Tags.
downloadType: 'single' # 'single' | 'specific'. Required. Download type. Default: single.
artifactName: # string. Required when downloadType == single. Artifact name.
#itemPattern: '**' # string. Matching pattern. Default: **.
downloadPath: '$(System.ArtifactsDirectory)' # string. Required. Destination directory. Default: $(System.ArtifactsDirectory).
#cleanDestinationFolder: false # boolean. Clean destination folder. Default: false.
# Advanced
#parallelizationLimit: '8' # string. Parallelization limit. Default: 8.
#checkDownloadedFiles: false # boolean. Check downloaded files. Default: false.
#retryDownloadCount: '4' # string. Retry count. Default: 4.
#extractTars: # boolean. Extract all files that are stored inside tar archives.
# Download build artifacts v0
# Download files that were saved as artifacts of a completed build.
- task: DownloadBuildArtifacts@0
inputs:
buildType: 'current' # 'current' | 'specific'. Required. Download artifacts produced by. Default: current.
#project: # string. Required when buildType == specific. Project.
#pipeline: # string. Alias: definition. Required when buildType == specific. Build pipeline.
#specificBuildWithTriggering: false # boolean. Optional. Use when buildType == specific. When appropriate, download artifacts from the triggering build. Default: false.
#buildVersionToDownload: 'latest' # 'latest' | 'latestFromBranch' | 'specific'. Required when buildType == specific. Build version to download. Default: latest.
#allowPartiallySucceededBuilds: false # boolean. Optional. Use when buildType == specific && buildVersionToDownload != specific. Download artifacts even from partially succeeded builds. Default: false.
#branchName: 'refs/heads/master' # string. Required when buildType == specific && buildVersionToDownload == latestFromBranch. Branch name. Default: refs/heads/master.
#buildId: # string. Required when buildType == specific && buildVersionToDownload == specific. Build.
#tags: # string. Optional. Use when buildType == specific && buildVersionToDownload != specific. Build Tags.
downloadType: 'single' # 'single' | 'specific'. Required. Download type. Default: single.
artifactName: # string. Required when downloadType == single. Artifact name.
#itemPattern: '**' # string. Matching pattern. Default: **.
downloadPath: '$(System.ArtifactsDirectory)' # string. Required. Destination directory. Default: $(System.ArtifactsDirectory).
# Advanced
#parallelizationLimit: '8' # string. Parallelization limit. Default: 8.
# Download Build Artifacts v0
# Download Build Artifacts.
- task: DownloadBuildArtifacts@0
inputs:
buildType: 'current' # 'current' | 'specific'. Required. Download artifacts produced by. Default: current.
#project: # string. Required when buildType == specific. Project.
#pipeline: # string. Alias: definition. Required when buildType == specific. Build pipeline.
#specificBuildWithTriggering: false # boolean. Optional. Use when buildType == specific. When appropriate, download artifacts from the triggering build. Default: false.
#buildVersionToDownload: 'latest' # 'latest' | 'latestFromBranch' | 'specific'. Required when buildType == specific. Build version to download. Default: latest.
#branchName: 'refs/heads/master' # string. Required when buildType == specific && buildVersionToDownload == latestFromBranch. Branch name. Default: refs/heads/master.
#buildId: # string. Required when buildType == specific && buildVersionToDownload == specific. Build.
#tags: # string. Optional. Use when buildType == specific && buildVersionToDownload != specific. Build Tags.
downloadType: 'single' # 'single' | 'specific'. Required. Download type. Default: single.
artifactName: # string. Required when downloadType == single. Artifact name.
#itemPattern: '**' # string. Matching pattern. Default: **.
downloadPath: '$(System.ArtifactsDirectory)' # string. Required. Destination directory. Default: $(System.ArtifactsDirectory).
# Advanced
#parallelizationLimit: '8' # string. Parallelization limit. Default: 8.
入力
buildType
- によって生成された成果物をダウンロードする
string
. 必須です。 使用できる値: current
(現在のビルド)、 specific
(特定のビルド)。 既定値: current
。
現在のビルドによって生成された成果物をダウンロードするか、特定のビルドからダウンロードするか。
project
- プロジェクト
string
. buildType == specific
の場合に必要です。
ビルド成果物のダウンロード元となるプロジェクト。
pipeline
- ビルド パイプライン
入力エイリアス: definition
。 string
. buildType == specific
の場合に必要です。
ビルド パイプライン名を指定します。
specificBuildWithTriggering
- 必要に応じて、トリガーするビルドから成果物をダウンロードします。
boolean
. 省略可能。 の場合は buildType == specific
を使用します。 既定値: false
。
の場合 true
、このビルド タスクは、トリガーするビルドから成果物のダウンロードを試みます。 指定したパイプラインからのトリガー ビルドがない場合は、次のオプションで指定されたビルドから成果物をダウンロードします。
buildVersionToDownload
- ダウンロードするビルド バージョン
string
. buildType == specific
の場合に必要です。 使用できる値: latest
、 latestFromBranch
(特定のブランチと指定されたビルド タグからの最新) specific
、(特定のバージョン)。 既定値: latest
。
allowPartiallySucceededBuilds
- 部分的に成功したビルドからでも成果物をダウンロードします。
boolean
. 省略可能。 の場合は buildType == specific && buildVersionToDownload != specific
を使用します。 既定値: false
。
の場合 true
、このビルド タスクは、ビルドが成功したか部分的に成功したかに関係なく、成果物のダウンロードを試みます。
branchName
- ブランチ名
string
. buildType == specific && buildVersionToDownload == latestFromBranch
の場合に必要です。 既定値: refs/heads/master
。
ブランチ/ref 名でフィルター処理するかどうかを指定します (例: refs/heads/develop
)。
buildId
- ビルド
string
. buildType == specific && buildVersionToDownload == specific
の場合に必要です。
成果物をダウンロードするビルド。
tags
- ビルド タグ
string
. 省略可能。 の場合は buildType == specific && buildVersionToDownload != specific
を使用します。
タグのコンマ区切りのリスト。 これらのタグを持つビルドのみが返されます。
downloadType
- ダウンロードの種類
string
. 必須です。 使用できる値: single
(特定の成果物)、 specific
(特定のファイル)。 既定値: single
。
ビルドから特定の成果物または特定のファイルをダウンロードします。
artifactName
- 成果物名
string
. downloadType == single
の場合に必要です。
ダウンロードする成果物の名前。
itemPattern
- 一致パターン
string
. 既定値: **
。
複数行のミニマッチ パターンとしてダウンロードするファイルを指定します。 詳細については、「 ファイルマッチングパターンリファレンス」を参照してください。
既定のパターン \*\*
では、[特定のファイル] オプションを選択すると、ビルド内のすべての成果物のすべての ファイル がダウンロードされます。 成果物ドロップ内のすべてのファイルをダウンロードするには、 を使用 drop/**
します。
downloadPath
- 宛先ディレクトリ
string
. 必須です。 既定値: $(System.ArtifactsDirectory)
。
成果物がダウンロードされるエージェント コンピューター上のパス。
cleanDestinationFolder
- コピー先フォルダーをクリーンアップする
boolean
. 既定値: false
。
成果物がダウンロードされる前に、コピー先フォルダー内のすべての既存のファイルを削除します。
parallelizationLimit
- 並列化の制限
string
. 既定値: 8
。
同時にダウンロードするファイルの数。
checkDownloadedFiles
- ダウンロードしたファイルを確認する
boolean
. 既定値: false
。
の場合 true
、このビルド タスクは、すべてのファイルが完全にダウンロードされていることを確認します。
retryDownloadCount
- 再試行回数
string
. 既定値: 4
。
ダウンロードが失敗した場合にビルド成果物のダウンロードを再試行する回数。
retryRedirectDownloadCount
- リダイレクトダウンロードの再試行回数
string
. 既定値: 0
。
リダイレクトに基づくダウンロードが失敗した場合にビルド成果物のダウンロードを再試行する回数 (省略可能)。 ネットワークでリダイレクトのフォローが許可されていない場合は、これを -1 に設定して、代わりに常に Azure DevOps からストリーム応答をダウンロードできます。
extractTars
- tar アーカイブ内に格納されているすべてのファイルを抽出する
boolean
.
拡張子を持つダウンロードしたすべてのファイルを .tar
抽出します。 これは、Unix ファイルのアクセス許可を保持する場合は、成果物ファイルを .tar
ファイルにパックする必要があるために役立ちます。 PublishBuildArtifacts タスクでオプションを StoreAsTar
有効にすると、成果物がファイルとして .tar
自動的に格納されます。
タスク制御オプション
すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「 コントロール オプションと一般的なタスク プロパティ」を参照してください。
出力変数
このタスクでは、ダウンストリームのステップ、ジョブ、およびステージで使用できる次の 出力変数を定義します。
BuildNumber
ビルド成果物ソースのビルド番号を格納します。
この入力では、下位互換性のため BuildId が 返されることに注意してください。 詳細については、「 変数」を参照してください。
このタスクでは、ダウンストリームのステップ、ジョブ、およびステージで使用できる次の 出力変数を定義します。
BuildNumber
ビルド成果物ソースのビルド番号を格納します。
要件
要件 | 説明 |
---|---|
パイプラインの種類 | YAML、クラシック ビルド、クラシック リリース |
上で実行 | エージェント、DeploymentGroup |
確認要求 | なし |
Capabilities | このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。 |
コマンドの制限 | Any |
設定可能な変数 | Any |
エージェントのバージョン | サポートされているすべてのエージェント バージョン。 |
タスクのカテゴリ | ユーティリティ |