DownloadBuildArtifacts@0: descarga de la tarea de artefactos de compilación v0

Use esta tarea para descargar archivos guardados como artefactos de una compilación completada.

Si usa Azure DevOps Services, se recomienda usar Descargar artefactos de canalización y Publicar artefactos de canalización para un rendimiento más rápido.

Nota

Deshabilite la autenticación básica de IIS si usa Azure DevOps Server para permitir la autenticación con el token de acceso personal. Consulte Autenticación básica de IIS y PAT para más información.

Syntax

# Download build artifacts v0
# Download files that were saved as artifacts of a completed build.
- task: DownloadBuildArtifacts@0
  inputs:
    buildType: 'current' # 'current' | 'specific'. Required. Download artifacts produced by. Default: current.
    #project: # string. Required when buildType == specific. Project. 
    #pipeline: # string. Alias: definition. Required when buildType == specific. Build pipeline. 
    #specificBuildWithTriggering: false # boolean. Optional. Use when buildType == specific. When appropriate, download artifacts from the triggering build. Default: false.
    #buildVersionToDownload: 'latest' # 'latest' | 'latestFromBranch' | 'specific'. Required when buildType == specific. Build version to download. Default: latest.
    #allowPartiallySucceededBuilds: false # boolean. Optional. Use when buildType == specific && buildVersionToDownload != specific. Download artifacts even from partially succeeded builds. Default: false.
    #branchName: 'refs/heads/master' # string. Required when buildType == specific && buildVersionToDownload == latestFromBranch. Branch name. Default: refs/heads/master.
    #buildId: # string. Required when buildType == specific && buildVersionToDownload == specific. Build. 
    #tags: # string. Optional. Use when buildType == specific && buildVersionToDownload != specific. Build Tags. 
    downloadType: 'single' # 'single' | 'specific'. Required. Download type. Default: single.
    artifactName: # string. Required when downloadType == single. Artifact name. 
    #itemPattern: '**' # string. Matching pattern. Default: **.
    downloadPath: '$(System.ArtifactsDirectory)' # string. Required. Destination directory. Default: $(System.ArtifactsDirectory).
    #cleanDestinationFolder: false # boolean. Clean destination folder. Default: false.
  # Advanced
    #parallelizationLimit: '8' # string. Parallelization limit. Default: 8.
    #checkDownloadedFiles: false # boolean. Check downloaded files. Default: false.
    #retryDownloadCount: '4' # string. Retry count. Default: 4.
    #retryRedirectDownloadCount: '0' # string. Retry count for redirect download. Default: 0.
    #extractTars: # boolean. Extract all files that are stored inside tar archives.

Entradas

buildType - Descarga de artefactos generados por
string. Obligatorio. Valores permitidos: current (compilación actual), specific (compilación específica). Valor predeterminado: current.

Si se deben descargar artefactos generados por la compilación actual o desde una compilación específica.

project - Proyecto
string. Necesario cuando buildType == specific.

Proyecto desde el que desea descargar los artefactos de compilación.

pipeline - Canalización de compilación
Alias de entrada: definition. string. Necesario cuando buildType == specific.

Especifica el nombre de la canalización de compilación.

specificBuildWithTriggering - Cuando corresponda, descargue los artefactos de la compilación de desencadenador.
boolean. Opcional. Use cuando buildType == specific. Valor predeterminado: false.

Si truees , esta tarea de compilación intenta descargar artefactos de la compilación desencadenada. Si no hay ninguna compilación de desencadenamiento desde la canalización especificada, descarga los artefactos de la compilación especificada en las opciones siguientes.

buildVersionToDownload - Versión de compilación para descargar
string. Necesario cuando buildType == specific. Valores permitidos: latest, latestFromBranch (Más reciente de una rama específica y etiquetas de compilación especificadas), specific (versión específica). Valor predeterminado: latest.

allowPartiallySucceededBuilds - Descargue artefactos incluso desde compilaciones parcialmente realizadas correctamente.
boolean. Opcional. Use cuando buildType == specific && buildVersionToDownload != specific. Valor predeterminado: false.

Si truees , esta tarea de compilación intenta descargar artefactos si la compilación se realiza correctamente o parcialmente.

branchName - Nombre de rama
string. Necesario cuando buildType == specific && buildVersionToDownload == latestFromBranch. Valor predeterminado: refs/heads/master.

Especifica si se va a filtrar por nombre de rama/ref, por ejemplo: refs/heads/develop.

buildId - Construir
string. Necesario cuando buildType == specific && buildVersionToDownload == specific.

La compilación desde la que desea descargar los artefactos.

tags - Etiquetas de compilación
string. Opcional. Use cuando buildType == specific && buildVersionToDownload != specific.

Una lista delimitada por comas de etiquetas. Solo se devuelven compilaciones con estas etiquetas.

downloadType - Tipo de descarga
string. Obligatorio. Valores permitidos: single (artefacto específico), specific (archivos específicos). Valor predeterminado: single.

Descarga un artefacto específico o archivos específicos de la compilación.

artifactName - Nombre del artefacto
string. Necesario cuando downloadType == single.

Nombre del artefacto que se va a descargar.

itemPattern - Patrón de coincidencia
string. Valor predeterminado: **.

Especifica los archivos que se van a descargar como un patrón de minimatch de varias líneas. Para obtener más información, consulte Referencia de patrones de coincidencia de archivos.

El patrón \*\* predeterminado descarga todos los archivos en todos los artefactos de la compilación si elige la opción Archivos específicos . Para descargar todos los archivos dentro de la colocación del artefacto, use drop/**.

.

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

Ruta de acceso en la máquina del agente donde se descargan los artefactos.

cleanDestinationFolder - Limpiar carpeta de destino
boolean. Valor predeterminado: false.

Elimina todos los archivos existentes de la carpeta de destino antes de descargar el artefacto.

parallelizationLimit - Límite de paralelización
string. Valor predeterminado: 8.

Número de archivos que se van a descargar simultáneamente.

checkDownloadedFiles - Comprobar los archivos descargados
boolean. Valor predeterminado: false.

Si truees , esta tarea de compilación comprueba que todos los archivos se descargan por completo.

retryDownloadCount - Recuento de reintentos
string. Valor predeterminado: 4.

Número de veces que se reintenta la descarga de un artefacto de compilación si se produce un error en la descarga.

retryRedirectDownloadCount - Número de reintentos para la descarga de redireccionamiento
string. Valor predeterminado: 0.

Número opcional de veces para reintentar la descarga de un artefacto de compilación si se produce un error en la descarga basada en el redireccionamiento. Si la red no permite seguir el redireccionamiento, puede establecer esta opción en -1 para descargar siempre la respuesta transmitida de Azure DevOps en su lugar.

extractTars - Extracción de todos los archivos almacenados en archivos tar
boolean.

Extrae todos los archivos descargados que tienen una .tar extensión. Esto resulta útil porque necesita empaquetar los archivos de artefacto en un .tar archivo si desea conservar los permisos de archivo unix. Al habilitar la StoreAsTar opción en la tarea PublishBuildArtifacts se almacenan artefactos como .tar archivos automáticamente.

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

Esta tarea define las siguientes variables de salida, que puede consumir en pasos, trabajos y fases de bajada.

BuildNumber
Almacena el número de compilación del origen del artefacto de compilación.

Tenga en cuenta que esta entrada devuelve BuildId debido a la compatibilidad con versiones anteriores. Para obtener más información, vea Variables.

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	Todas las versiones de agente compatibles.
Categoría de la tarea:	Utilidad