Partilhar via


DownloadPackage@1 - Download pacote v1 tarefa

Use esta tarefa para baixar um pacote de um feed de gerenciamento de pacotes no Azure Artifacts.

Sintaxe

# 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.

Insumos

packageType - Tipo de pacote
string. Necessário. Valores permitidos: maven, npm, nuget, pypi (Python), upack (Universal), cargo. Valor padrão: nuget.


packageType - Tipo de pacote
string. Necessário. Valores permitidos: maven, npm, nuget, pypi (Python), upack (Universal). Valor padrão: nuget.


feed - Feed
string. Necessário.

Para feeds com escopo de projeto, o formato é projectID/feedID. Consulte os seguintes comentários para saber como obter um feed ou ID de projeto, ou aprender a usar um projeto e um nome de feed.


view - Ver
string.

Especifica um modo de exibição que usa apenas versões promovidas para esse modo de exibição específico.


definition - Pacote
string. Necessário.

Se você não encontrar o pacote na lista, você pode fornecer o ID do pacote, que você pode encontrar usando as instruções aqui.


version - Versão
string. Necessário.

Especifica a versão do pacote. Use latest para baixar a versão mais recente do pacote em tempo de execução. Use * para baixar a versão mais recente de um pacote quando packageType = upack.


Arquivos files -
string. Opcional. Use quando packageType = maven || packageType = pypi || packageType = upack. Valor padrão: **.

Especifica quais arquivos baixar usando padrões de correspondência de arquivos.


extract - Extrair o conteúdo da embalagem
boolean. Opcional. Use quando packageType = nuget || packageType = npm. Valor padrão: true.

Extrai o conteúdo do pacote e contém o arquivo do pacote na pasta de artefatos.


downloadPath - Diretório de destino
string. Necessário. Valor padrão: $(System.ArtifactsDirectory).

Especifica o caminho na máquina do agente onde o pacote é baixado.


Opções de controlo de tarefas

Todas as tarefas têm opções de controle, além de suas entradas de tarefas. Para obter mais informações, consulte Opções de controle de e propriedades de tarefas comuns.

Variáveis de saída

Nenhuma.

Comentários

Use esta tarefa para baixar um pacote de um feed de gerenciamento de pacotes no Azure Artifacts ou TFS.

Observação

Requer a extensão Package Management.

Como faço para encontrar a ID do feed (ou projeto) do qual quero baixar meu artefato

A API get feed pode ser usada para recuperar o feed e a ID do projeto para o feed. A API está documentada aqui.

Posso usar o nome do projeto ou feed em vez de IDs

Sim, você pode usar o nome do projeto ou do feed em sua definição. No entanto, se seu projeto ou feed for renomeado no futuro, sua tarefa também terá que ser atualizada ou poderá falhar.

Exemplos

Baixar um pacote NuGet de um feed com escopo da organização e extrair para o diretório de destino

# 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)'

Baixe um pacote maven de um feed com escopo de projeto e baixe apenas arquivos 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)'

Requerimentos

Exigência Descrição
Tipos de pipeline YAML, Construção clássica, Versão clássica
Funciona em Agente, DeploymentGroup
Exigências Nenhum
Capacidades Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes no trabalho.
Restrições de comando Qualquer
Variáveis configuráveis Qualquer
Versão do agente 2.144.0 ou superior
Categoria de tarefa Utilidade
Exigência Descrição
Tipos de pipeline YAML, Construção clássica, Versão clássica
Funciona em Agente, DeploymentGroup
Exigências Nenhum
Capacidades Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes no trabalho.
Restrições de comando Qualquer
Variáveis configuráveis Qualquer
Versão do agente 2.115.0 ou superior
Categoria de tarefa Utilidade