このタスクを使用して、Jenkins ジョブによって生成された成果物をダウンロードします。
構文
# Jenkins download artifacts v1
# Download artifacts produced by a Jenkins job.
- task: JenkinsDownloadArtifacts@1
inputs:
jenkinsServerConnection: # string. Alias: serverEndpoint. Required. Jenkins service connection.
jobName: # string. Required. Job name.
#jenkinsJobType: # string. Optional. Use when jobName = invalidjobName. Jenkins job type.
saveTo: 'jenkinsArtifacts' # string. Required. Save to. Default: jenkinsArtifacts.
# Advanced
jenkinsBuild: 'LastSuccessfulBuild' # 'LastSuccessfulBuild' | 'BuildNumber'. Required. Download artifacts produced by. Default: LastSuccessfulBuild.
#jenkinsBuildNumber: '1' # string. Required when jenkinsBuild == BuildNumber. Jenkins build number. Default: 1.
#itemPattern: '**' # string. Item Pattern. Default: **.
#downloadCommitsAndWorkItems: false # boolean. Download Commits and WorkItems. Default: false.
#startJenkinsBuildNumber: # string. Optional. Use when downloadCommitsAndWorkItems == true && jenkinsBuild == BuildNumber. Download commits and work items from.
#artifactDetailsFileNameSuffix: # string. Optional. Use when downloadCommitsAndWorkItems == invalid. Commit and WorkItem FileName.
# Propagated Artifacts
#propagatedArtifacts: false # boolean. Artifacts are propagated to Azure. Default: false.
#artifactProvider: 'azureStorage' # 'azureStorage'. Required when propagatedArtifacts == notValid. Artifact Provider. Default: azureStorage.
#ConnectedServiceNameARM: # string. Required when propagatedArtifacts == true. Azure Subscription.
#storageAccountName: # string. Required when propagatedArtifacts == true. Storage Account Name.
#containerName: # string. Required when propagatedArtifacts == true. Container Name.
#commonVirtualPath: # string. Optional. Use when propagatedArtifacts == true. Common Virtual Path.
入力
Jenkins サービス接続の jenkinsServerConnection -
入力エイリアス: serverEndpoint。
string. 必須。
Jenkins インスタンスのサービス接続を指定します。 新しいサービス接続を作成するには、[管理] リンクをクリックします。
jobName
-
ジョブ名の
string. 必須。
成果物をダウンロードする Jenkins ジョブの名前を指定します。 これは、Jenkins サーバー上のジョブ名と正確に一致している必要があります。
jenkinsJobType
-
Jenkins ジョブの種類の
string. 任意
jobName = invalidjobNameするときに使用します。
Jenkins ジョブの種類を自動的に指定します。
saveTo
-
に保存
string. 必須。 既定値: jenkinsArtifacts.
Jenkins 成果物をダウンロードして保存するディレクトリを指定します。 このディレクトリが存在しない場合は作成されます。
jenkinsBuild
-
によって生成された成果物をダウンロードする
string. 必須。 使用できる値: LastSuccessfulBuild (最後に成功したビルド)、BuildNumber (ビルド番号)。 既定値: LastSuccessfulBuild.
最後に成功したビルドまたは特定のビルド インスタンスから生成された成果物をダウンロードします。
Jenkins ビルド番号を jenkinsBuildNumber - する
string.
jenkinsBuild == BuildNumberする場合に必要です。 既定値: 1.
このビルドによって生成された成果物をダウンロードします。
itemPattern
-
項目パターンの
string. 既定値: **.
複数行のミニマッチ パターンとしてダウンロードするファイルを指定します。 ファイル マッチング パターン 関する詳細情報。
既定のパターン ** では、Jenkins ジョブによって生成されたすべての成果物のすべてのファイルがダウンロードされます。 成果物ドロップ内のすべてのファイルをダウンロードするには、drop/**を使用します。
コミットと WorkItemsをダウンロードする downloadCommitsAndWorkItems -
boolean. 既定値: false.
Jenkins ジョブに関連付けられているコミットと作業項目の詳細のダウンロードを有効にします。
startJenkinsBuildNumber
-
からコミットと作業項目をダウンロードする
string. 任意
downloadCommitsAndWorkItems == true && jenkinsBuild == BuildNumberするときに使用します。
コミットと作業項目をダウンロードするためのビルド番号を開始します。 指定した場合、開始ビルド番号と成果物をダウンロードするための入力として指定されたビルド番号の間のすべてのコミットと作業項目がダウンロードされます。
コミットと WorkItem FileNameの artifactDetailsFileNameSuffix -
string. 任意
downloadCommitsAndWorkItems == invalidするときに使用します。
コミットと作業項目の添付ファイルのファイル名サフィックスを指定します。 添付ファイルは、commits_{suffix}.json と workitem_{suffix}.jsonで作成されます。 この入力が指定されていない場合は、commits.json と workitems.jsonの名前で添付ファイルが作成されます。
propagatedArtifacts
-
成果物が Azure に伝達される
boolean. 既定値: false.
Jenkins アーティファクトが Azure に伝達された場合は、この入力を使用します。 Jenkins アーティファクトを Azure にアップロードするには、この Jenkins プラグインを参照してください。
artifactProvider
-
Artifact Provider
string.
propagatedArtifacts == notValidする場合に必要です。 使用できる値: azureStorage (Azure Storage)。 既定値: azureStorage.
アーティファクトをアップロードするために Jenkins ジョブで使用される外部ストレージ プロバイダーを指定します。
Azure サブスクリプションの ConnectedServiceNameARM -
string.
propagatedArtifacts == trueする場合に必要です。
成果物の Azure Resource Manager サブスクリプションを指定します。
storageAccountName
-
ストレージ アカウント名の
string.
propagatedArtifacts == trueする場合に必要です。
Azure クラシック または Resource Manager ストレージ アカウントを指定します。 アーティファクトが伝達されるストレージ アカウント名を選択します。
containerName
-
コンテナー名の
string.
propagatedArtifacts == trueする場合に必要です。
アーティファクトがアップロードされるストレージ アカウント内のコンテナーの名前を指定します。
共通仮想パスの commonVirtualPath -
string. 任意
propagatedArtifacts == trueするときに使用します。
Azure ストレージ コンテナー内の成果物へのパスを指定します。
タスク コントロールのオプション
すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「コントロール オプションと一般的なタスク プロパティを参照してください。
出力変数
なし。
注釈
このタスクを使用して、Jenkins ジョブによって生成された成果物をダウンロードします。