JenkinsDownloadArtifacts@1 - Jenkins の成果物 v1 タスクのダウンロード

このタスクは、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.

入力

jenkinsServerConnection - Jenkins サービス接続
入力エイリアス: serverEndpoint。 string. 必須です。

Jenkins インスタンスのサービス接続を指定します。 新しいサービス接続を作成するには、[管理] リンクをクリックします。

jobName - ジョブ名
string. 必須です。

成果物をダウンロードする Jenkins ジョブの名前を指定します。 これは、Jenkins サーバー上のジョブ名と完全に一致している必要があります。

jenkinsJobType - Jenkins ジョブの種類
string. 省略可能。 の場合は jobName = invalidjobNameを使用します。

Jenkins ジョブの種類を自動的に指定します。

saveTo - 保存先
string. 必須です。 既定値: jenkinsArtifacts。

Jenkins 成果物をダウンロードして保存するディレクトリを指定します。 このディレクトリが存在しない場合は作成されます。

jenkinsBuild - によって生成された成果物をダウンロードする
string. 必須です。 使用できる値: LastSuccessfulBuild (最後に成功したビルド)、 BuildNumber (ビルド番号)。 既定値: LastSuccessfulBuild。

最後に成功したビルドまたは特定のビルド インスタンスから生成された成果物をダウンロードします。

jenkinsBuildNumber - Jenkins ビルド番号
string. jenkinsBuild == BuildNumber の場合に必要です。 既定値: 1。

このビルドによって生成された成果物をダウンロードします。

itemPattern - 項目パターン
string. 既定値: **。

複数行のミニマッチ パターンとしてダウンロードするファイルを指定します。 ファイルの一致パターンに関する詳細情報。

既定のパターン ** では、Jenkins ジョブによって生成されたすべての成果物にわたってすべてのファイルがダウンロードされます。 成果物ドロップ内のすべてのファイルをダウンロードするには、 を使用 drop/**します。

downloadCommitsAndWorkItems - Commits と WorkItems のダウンロード
boolean. 既定値: false。

Jenkins ジョブに関連付けられているコミットと作業項目の詳細をダウンロードできるようにします。

startJenkinsBuildNumber - コミットと作業項目のダウンロード元
string. 省略可能。 の場合は downloadCommitsAndWorkItems == true && jenkinsBuild == BuildNumberを使用します。

コミットと作業項目をダウンロードするためのビルド番号を開始します。 指定した場合、開始ビルド番号と成果物をダウンロードするための入力として指定されたビルド番号の間のすべてのコミットと作業項目がダウンロードされます。

artifactDetailsFileNameSuffix - Commit と WorkItem FileName
string. 省略可能。 の場合は downloadCommitsAndWorkItems == invalidを使用します。

コミットと作業項目の添付ファイルのファイル名サフィックスを指定します。 添付ファイルは、 と workitem_{suffix}.jsonを使用してcommits_{suffix}.json作成されます。 この入力が指定されていない場合は、名前 commits.json と workitems.jsonを使用して添付ファイルが作成されます。

propagatedArtifacts - 成果物が Azure に伝達される
boolean. 既定値: false。

Jenkins 成果物が Azure に伝達された場合は、この入力を使用します。 Jenkins 成果物を Azure にアップロードするには、こちらの Jenkins プラグインを参照してください。

artifactProvider - 成果物プロバイダー
string. propagatedArtifacts == notValid の場合に必要です。 使用できる値: azureStorage (Azure Storage)。 既定値: azureStorage。

成果物をアップロードするために Jenkins ジョブで使用される外部ストレージ プロバイダーを指定します。

ConnectedServiceNameARM - Azure サブスクリプション
string. propagatedArtifacts == true の場合に必要です。

成果物の Azure Resource Manager サブスクリプションを指定します。

storageAccountName - ストレージ アカウント名
string. propagatedArtifacts == true の場合に必要です。

Azure クラシック または Resource Manager ストレージ アカウントを指定します。 成果物が伝達されるストレージ アカウント名を選択します。

containerName - コンテナー名
string. propagatedArtifacts == true の場合に必要です。

成果物がアップロードされるストレージ アカウント内のコンテナーの名前を指定します。

commonVirtualPath - 共通仮想パス
string. 省略可能。 の場合は propagatedArtifacts == trueを使用します。

Azure ストレージ コンテナー内の成果物へのパスを指定します。

タスク制御オプション

すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「 コントロール オプションと一般的なタスク プロパティ」を参照してください。

出力変数

[なし] :

解説

このタスクは、Jenkins ジョブによって生成された成果物をダウンロードするために使用します。

要件

要件	説明
パイプラインの種類	YAML、クラシック ビルド、クラシック リリース
実行日	エージェント、DeploymentGroup
確認要求	なし
Capabilities	このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。
コマンドの制限	Any
設定可能な変数	Any
エージェントのバージョン	2.144.0 以上
タスクのカテゴリ	ユーティリティ