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.
# 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 paquete
string
. Obligatorio. Valores permitidos: , , , (Python), upack
(Universal), cargo
. pypi
nuget
npm
maven
Valor predeterminado: nuget
.
packageType
- Tipo de paquete
string
. Obligatorio. Valores permitidos: maven
, npm
, nuget
, pypi
(Python), upack
(Universal). 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 |
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.115.0 o superior |
Categoría de la tarea: | Utilidad |