Partilhar via


DownloadPackage@1 - Transferir a tarefa do pacote v1

Utilize esta tarefa para transferir um pacote a partir de um feed de gestão de pacotes nos Artefactos do Azure.

Syntax

# 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. Obrigatório. Valores permitidos: , , , (Python), upack (Universal), cargo. pypinugetnpmmaven Valor predefinido: nuget.


packageType - Tipo de Pacote
string. Obrigatório. Valores permitidos: maven, npm, nuget, pypi (Python), upack (Universal). Valor predefinido: nuget.


feed - Feed
string. Obrigatório.

Para feeds com âmbito de projeto, o formato é projectID/feedID. Veja as seguintes observações para saber como obter um feed ou ID do projeto ou saiba como utilizar um projeto e o nome do feed.


view - Ver
string.

Especifica uma vista que utiliza apenas versões promovidas para essa vista específica.


definition - Pacote
string. Obrigatório.

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


version - Versão
string. Obrigatório.

Especifica a versão do pacote. Utilize latest para transferir a versão mais recente do pacote no runtime.


files - Ficheiros
string. Opcional. Utilize quando packageType = maven || packageType = pypi || packageType = upack. Valor predefinido: **.

Especifica os ficheiros a transferir com padrões de correspondência de ficheiros.


extract - Extrair conteúdo do pacote
boolean. Opcional. Utilize quando packageType = nuget || packageType = npm. Valor predefinido: true.

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


downloadPath - Diretório de destino
string. Obrigatório. Valor predefinido: $(System.ArtifactsDirectory).

Especifica o caminho no computador do agente onde o pacote é transferido.


Opções de controlo de tarefas

Todas as tarefas têm opções de controlo para além das entradas de tarefas. Para obter mais informações, veja Opções de controlo e propriedades de tarefas comuns.

Variáveis de saída

Nenhum.

Observações

Utilize esta tarefa para transferir um pacote a partir de um feed de gestão de pacotes em Artefactos do Azure ou TFS.

Como devo proceder para encontrar o ID do feed (ou projeto) a partir do qual pretendo transferir o meu artefacto

A API get feed pode ser utilizada para obter o feed e o ID do projeto para o seu feed. A API está documentada aqui.

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

Sim, pode utilizar o nome do projeto ou feed na sua definição. No entanto, se o seu projeto ou feed mudar o nome no futuro, a sua tarefa também terá de ser atualizada ou poderá falhar.

Exemplos

Transferir um pacote NuGet a partir de um feed com âmbito de 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)'

Transferir um pacote maven a partir de um feed com âmbito de projeto e transferir apenas ficheiros 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 Description
Tipos de pipeline YAML, Compilação clássica, Versão clássica
É executado em Agente, DeploymentGroup
Exigências Nenhuma
Capacidades Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes na tarefa.
Restrições de comandos Qualquer
Variáveis de tabelas definidas Qualquer
Versão do agente 2.144.0 ou superior
Categoria da tarefa Utilitário
Requisito Description
Tipos de pipeline YAML, Compilação clássica, Versão clássica
É executado em Agente, DeploymentGroup
Exigências Nenhuma
Capacidades Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes na tarefa.
Restrições de comandos Qualquer
Variáveis de tabelas definidas Qualquer
Versão do agente 2.115.0 ou superior
Categoria da tarefa Utilitário