DownloadPackage@1 – Tarefa Baixar 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.

Entradas

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

feed - Alimentar
string. Obrigatórios.

Para feeds com escopo de projeto, o formato é projectID/feedID. Confira as observações a seguir para saber como obter um feed ou uma ID do projeto ou saiba como usar um projeto e um nome de feed.

view - Ver
string.

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

definition - Pacote
string. Obrigatórios.

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. Obrigatórios.

Especifica a versão do pacote. Use latest para baixar a versão mais recente do pacote em runtime.

files - Arquivos
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 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.

downloadPath - Diretório de destino
string. Obrigatórios. 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 Opções de controle e propriedades comuns da tarefa.

Variáveis de saída

Nenhum.

Comentários

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

Observação

Requer a extensão gerenciamento de pacotes.

Como fazer 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 do 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 precisará ser atualizada ou poderá falhar.

Exemplos

Baixar um pacote NuGet de um feed no 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 no escopo do 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
É executado em	Agent, DeploymentGroup
Demandas	Nenhum
Funcionalidades	Essa tarefa não atende a nenhuma demanda por tarefas subsequentes no trabalho.
Restrições de comando	Qualquer
Variáveis configuráveis	Qualquer
Versão do agente	2.144.0 ou superior
Categoria da tarefa	Utilitário