DownloadPackage@1: tarea Descargar paquete v1

Use esta tarea para descargar un paquete desde una fuente de administración de paquetes en Azure Artifacts.

Sintaxis

# 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 paquete
string. Obligatorio. Valores permitidos: , , , (Python), upack (Universal), cargo. pypinugetnpmmaven Valor predeterminado: nuget.

feed - Alimentar
string. Obligatorio.

En el caso de las fuentes con ámbito de proyecto, el formato es projectID/feedID. Consulte los comentarios siguientes para obtener información sobre cómo obtener una fuente o un identificador de proyecto, o cómo usar un proyecto y un nombre de fuente en su lugar.

view - Vista
string.

Especifica una vista que solo usa versiones promocionadas a esa vista específica.

definition - Paquete
string. Obligatorio.

Si no encuentra el paquete en la lista, puede proporcionar el identificador del paquete, que puede encontrar con las instrucciones que se indican aquí.

version - Versión
string. Obligatorio.

Especifica la versión del paquete. Use latest para descargar la versión más reciente del paquete en tiempo de ejecución.

files - Archivos
string. Opcional. Use cuando packageType = maven || packageType = pypi || packageType = upack. Valor predeterminado: **.

Especifica los archivos que se van a descargar mediante patrones de coincidencia de archivos.

extract - Extracción del contenido del paquete
boolean. Opcional. Use cuando packageType = nuget || packageType = npm. Valor predeterminado: true.

Extrae el contenido del paquete y contiene el archivo del paquete en la carpeta de artefactos.

downloadPath - Directorio de destino
string. Obligatorio. Valor predeterminado: $(System.ArtifactsDirectory).

Especifica la ruta de acceso en el equipo del agente donde se descarga el paquete.

Opciones de control de tareas

Todas las tareas tienen opciones de control además de las entradas de tareas. Para obtener más información, vea Opciones de control y propiedades de tareas comunes.

Variables de salida

Ninguno.

Observaciones

Use esta tarea para descargar un paquete de una fuente de administración de paquetes en Azure Artifacts o TFS.

Nota

Requiere la extensión Administración de paquetes.

Cómo buscar el identificador de la fuente (o proyecto) desde el que quiero descargar mi artefacto

La API get feed se puede usar para recuperar la fuente y el identificador del proyecto de la fuente. La API se documenta aquí.

¿Puedo usar el nombre del proyecto o fuente en lugar de los identificadores?

Sí, puede usar el nombre del proyecto o fuente en la definición. Sin embargo, si el proyecto o la fuente se cambia de nombre en el futuro, la tarea también tendrá que actualizarse o podría producir un error.

Ejemplos

Descarga de un paquete NuGet desde una fuente con ámbito de organización y extracción en el directorio 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)'

Descargar un paquete maven desde una fuente con ámbito de proyecto y descargar solo archivos 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	Descripción
Tipos de canalización	YAML, compilación clásica, versión clásica
Se ejecuta en	Agente, DeploymentGroup
Peticiones	None
Capabilities	Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos	Any
Variables que se pueden establecer	Any
Versión del agente	2.144.0 o superior
Categoría de la tarea:	Utilidad