DownloadPackage@1 - パッケージ v1 タスクをダウンロードする

このタスクを使用して、Azure Artifacts のパッケージ管理フィードからパッケージをダウンロードします。

構文

# Download package v1
# Download a package from a package management feed in Azure Artifacts.
- task: DownloadPackage@1
  inputs:
    packageType: 'nuget' # 'maven' | 'npm' | 'nuget' | 'pypi' | 'upack' | 'cargo'. Required. Package Type. Default: nuget.
    feed: # string. Required. Feed. 
    #view: # string. View. 
    definition: # string. Required. Package. 
    version: # string. Required. Version. 
    downloadPath: '$(System.ArtifactsDirectory)' # string. Required. Destination directory. Default: $(System.ArtifactsDirectory).
  # Advanced
    #files: '**' # string. Optional. Use when packageType = maven || packageType = pypi || packageType = upack. Files. Default: **.
    #extract: true # boolean. Optional. Use when packageType = nuget || packageType = npm. Extract package contents. Default: true.

入力

packageType - パッケージの種類
string. 必須です。 使用できる値: maven、、、 pypinuget(Python)、 upack (ユニバーサル)、cargonpm。 既定値: nuget。

feed - フィード
string. 必須です。

プロジェクト スコープフィードの場合、形式は です projectID/feedID。 フィードまたはプロジェクト ID を取得する方法、または代わりにプロジェクトとフィード名を使用する方法については、次の 解説 を参照してください。

view - ビュー
string.

特定のビューに昇格されたバージョンのみを使用するビューを指定します。

definition - パッケージ
string. 必須です。

一覧にパッケージが見つからない場合は、 こちらの手順を使用してパッケージ ID を指定できます。

version - バージョン
string. 必須です。

パッケージのバージョンを指定します。 を使用して latest 、実行時にパッケージの最新バージョンをダウンロードします。

files - ファイル
string. 任意。 の場合は packageType = maven || packageType = pypi || packageType = upackを使用します。 既定値: **。

ファイル 一致パターンを使用してダウンロードするファイルを指定します。

extract - パッケージの内容を抽出する
boolean. 任意。 の場合は packageType = nuget || packageType = npmを使用します。 既定値: true。

パッケージの内容を抽出し、成果物フォルダー内のパッケージ アーカイブを含みます。

downloadPath - 宛先ディレクトリ
string. 必須です。 既定値: $(System.ArtifactsDirectory)。

パッケージがダウンロードされるエージェント コンピューター上のパスを指定します。

タスク制御オプション

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

出力変数

[なし] :

解説

このタスクを使用して、Azure Artifacts または TFS のパッケージ管理フィードからパッケージをダウンロードします。

注意

パッケージ管理拡張機能が必要です。

成果物をダウンロードするフィード (またはプロジェクト) の ID を見操作方法

フィードの取得 API を使用して、フィードのフィードとプロジェクト ID を取得できます。 API については、 こちらを参照してください。

ID の代わりにプロジェクト名またはフィード名を使用できますか

はい。定義でプロジェクト名またはフィード名を使用できます。 ただし、将来プロジェクトまたはフィードの名前が変更された場合は、タスクも更新する必要があるか、失敗する可能性があります。

例

organization スコープフィードから NuGet パッケージをダウンロードし、宛先ディレクトリに抽出する

# Download an artifact with id 'cfe01b64-ded4-47b7-a569-2ac17cbcedbd' to $(System.ArtifactsDirectory)
- task: DownloadPackage@1
  inputs:
    packageType: 'nuget'
    feed: '6a60ef3b-e29f-41b6-9885-7874278baac7'
    definition: 'cfe01b64-ded4-47b7-a569-2ac17cbcedbd' # Can also be package name
    version: '1.0.0'
    extract: true
    downloadPath: '$(System.ArtifactsDirectory)'

プロジェクト スコープのフィードから maven パッケージをダウンロードし、pom ファイルのみをダウンロードする

# Download an artifact with name 'com.test:testpackage' to $(System.ArtifactsDirectory)
- task: DownloadPackage@1
  inputs:
    packageType: 'maven'
    feed: '132f5c2c-2aa0-475a-8b47-02c79617954b/c85e5de9-7b12-4cfd-9293-1b33cdff540e' # <projectId>/<feedId>
    definition: 'com.test:testpackage' 
    version: '1.0.0-snapshot' # Should be normalized version
    files: '*.pom'
    downloadPath: '$(System.ArtifactsDirectory)'

必要条件

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