DownloadPackage@1 - 下載套件 v1 工作

發行項
10/31/2024

使用此工作可從 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.

# 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'. 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、npm、nuget、pypi（Python）、upackcargo。預設值：nuget。

packageType - 套件類型
string。必填。允許的值：maven、npm、nuget、pypi（Python）、upack（通用）。預設值：nuget。

feed - 摘要
string。必填。

針對專案範圍的摘要，格式為 projectID/feedID。請參閱下列備註瞭解如何取得摘要或專案標識碼，或瞭解如何改用專案和摘要名稱。

view - 檢視
string。

指定僅使用升級至該特定檢視的版本檢視。

definition - 套件
string。必填。

如果您在清單中找不到套件，您可以提供套件識別碼，您可以使用此處的指示找到。

version - 版本
string。必填。

指定封裝的版本。使用 latest 在運行時間下載最新版本的套件。當 packageType = upack時，請使用 * 下載最新版本的套件。

files - 檔案
string。自選。 packageType = maven || packageType = pypi || packageType = upack時使用。預設值：**。

指定要使用檔案比對模式下載的檔案，。

extract - 擷取套件內容
boolean。自選。 packageType = nuget || packageType = npm時使用。預設值：true。

擷取套件內容，並包含成品資料夾中的封裝封存。

downloadPath - 目的地目錄
string。必填。預設值：$(System.ArtifactsDirectory)。

指定下載套件之代理程式電腦上的路徑。

工作控制選項

除了工作輸入之外，所有工作都有控制選項。如需詳細資訊，請參閱控制項選項和一般工作屬性。

輸出變數

沒有。

言論

使用此工作從 Azure Artifacts 或 TFS 中的套件管理摘要下載套件。

注意

需要套件管理延伸模組。

如何尋找想要從下載成品的摘要識別碼（或專案）

取得摘要 API 可用來擷取摘要的摘要和專案標識碼。 API 記載於此處，。

我可以使用專案或摘要名稱，而不是標識符

是，您可以在定義中使用專案或摘要名稱。不過，如果您的專案或摘要在未來重新命名，您的工作也必須更新，否則可能會失敗。

例子

從組織範圍的摘要下載 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、傳統組建、傳統版本
執行於	Agent、DeploymentGroup
需求	沒有
功能	此工作不符合作業中後續工作的任何需求。
命令限制	任何
Settable 變數	任何
代理程式版本	2.144.0 或更新
工作類別	效用

要求	描述
管線類型	YAML、傳統組建、傳統版本
執行於	Agent、DeploymentGroup
需求	沒有
功能	此工作不符合作業中後續工作的任何需求。
命令限制	任何
Settable 變數	任何
代理程式版本	2.115.0 或更新
工作類別	效用

共用方式為