DownloadPackage@1: tarea Descargar paquete v1

Use esta tarea para descargar un paquete de 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: maven, npm, nuget, pypi (Python), upack (Universal), cargo. Valor predeterminado: nuget.

de fuente de
string. Obligatorio.

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

view - Ver
string.

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

paquete de
string. Obligatorio.

Si no encuentra el paquete en la lista, puede proporcionar el identificador de paquete, que puede encontrar mediante las instrucciones 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. Use * para descargar la versión más reciente de un paquete cuando packageType = upack.

archivos de
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 artifact.

de directorio de destino de
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 sus entradas de tarea. Para obtener más información, consulte 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 encuentro el identificador de la fuente (o proyecto) desde el que quiero descargar mi artefacto?

La API de obtención de fuente 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 se cambia el nombre del proyecto o la fuente 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
demandas	Ninguno
funcionalidades de	Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
restricciones de comandos	Cualquier
variables settable	Cualquier
Versión del agente	2.144.0 o superior
Categoría de tarea	Utilidad