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

Use esta tarea para descargar archivos que se guardaron 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 obtener 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 y PAT de IIS para obtener más información.

Sintaxis

# 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 - Descargar artefactos generados por
string. Obligatorio. Valores permitidos: current (compilación actual), specific (compilación específica). Valor predeterminado: current.

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

de project de project -
string. Obligatorio cuando buildType == specific.

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

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

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

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

Si true, 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 artefactos de la compilación especificada en las opciones siguientes.

buildVersionToDownload - versión de compilación para descargar
string. Obligatorio 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 - Descargar artefactos incluso a partir de compilaciones realizadas parcialmente correctamente.
boolean. Opcional. Use cuando buildType == specific && buildVersionToDownload != specific. Valor predeterminado: false.

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

branchName - nombre de rama
string. Obligatorio 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 - Creación
string. Obligatorio cuando buildType == specific && buildVersionToDownload == specific.

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

de etiquetas de compilación de tags -
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. Obligatorio cuando downloadType == single.

Nombre del artefacto que se va a descargar.

patrón de coincidencia de itemPattern -
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/**.

.

de directorio de destino de
string. Obligatorio. Valor predeterminado: $(System.ArtifactsDirectory).

Ruta de acceso en el equipo 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 archivos descargados
boolean. Valor predeterminado: false.

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

retryDownloadCount - número 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 - recuento de reintentos para el de descarga de redirección
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 - Extraer todos los archivos almacenados en archivos tar
boolean.

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

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

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, consulte Variables.

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	Cualquiera
variables settable	Cualquiera
Versión del agente	Todas las versiones de agente admitidas.
Categoría de tarea	Utilidad