Compartilhar via


DownloadPackage@1 – Baixar a tarefa do pacote v1

Use essa 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.

Entradas

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. Veja os comentários a seguir para saber como obter um feed ou uma ID do projeto ou aprender a usar um projeto e um nome de feed.


view - Exibir
string.

Especifica uma exibição que usa apenas versões promovidas para essa exibição específica.


do pacote
string. Necessário.

Se você não encontrar o pacote na lista, poderá fornecer a ID do pacote, que pode ser encontrada 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 runtime. 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 arquivo.


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

Extrai o conteúdo do pacote e contém o arquivo morto do pacote na pasta do artefato.


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

Especifica o caminho no computador do agente em que o pacote é baixado.


Opções de controle de tarefa

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

Variáveis de saída

Nenhum.

Observações

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

Nota

Requer a extensão de Gerenciamento de Pacotes .

Como fazer para encontrar a ID do feed (ou projeto) de onde 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 do feed em vez de IDs

Sim, você pode usar o nome do projeto ou do feed em sua definição. No entanto, se o seu projeto ou feed for renomeado no futuro, sua tarefa também precisará 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)'

Baixar um pacote maven de um feed com escopo de projeto e baixar 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)'

Requisitos

Requisito Descrição
Tipos de pipeline YAML, build clássico, versão clássica
Execuções em Agent, DeploymentGroup
de demandas Nenhum
recursos Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
restrições de comando Qualquer
variáveis settable Qualquer
Versão do agente 2.144.0 ou superior
Categoria de tarefa Utilidade
Requisito Descrição
Tipos de pipeline YAML, build clássico, versão clássica
Execuções em Agent, DeploymentGroup
de demandas Nenhum
recursos Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
restrições de comando Qualquer
variáveis settable Qualquer
Versão do agente 2.115.0 ou superior
Categoria de tarefa Utilidade