Compartir a través de

DownloadBuildArtifacts@1: descarga de artefactos de compilación v1

  • Artículo

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

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

Syntax

# Download build artifacts v1
# Download files that were saved as artifacts of a completed build.
- task: DownloadBuildArtifacts@1
  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.
    #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 descargan los 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 se descargarán 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 artefactos de la compilación de desencadenamiento.
boolean. Opcional. Use cuando buildType == specific. Valor predeterminado: false.

Si truees , esta tarea de compilación intenta descargar artefactos de la compilación de desencadenamiento. Si no hay ninguna compilación desencadenada 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 las etiquetas de compilación especificadas), specific (versión específica). Valor predeterminado: latest.

Especifica la versión de la compilación que se va a descargar.

  • Elija latest descargar la versión de compilación más reciente disponible.
  • Elija latestFromBranch descargar la versión de compilación más reciente disponible de la rama especificada por branchName las etiquetas y especificadas por tags.
  • Elija specific descargar la versión de compilación especificada por buildId.

allowPartiallySucceededBuilds - Descargue artefactos incluso de 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 el nombre de rama o 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.

  • Elija single (artefacto específico) cuando solo desee un artefacto específico especificado por artifactName
  • Elija specific (archivos específicos) cuando desee todos los artefactos de la compilación seleccionada.

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, vea 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 el equipo del agente donde se descargan los artefactos.


cleanDestinationFolder - Carpeta de destino limpia
boolean. Valor predeterminado: false.

Elimine todos los archivos existentes en la carpeta de destino antes de la descarga del artefacto.


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

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


checkDownloadedFiles - Comprobación de 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.


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

Establezca en true para extraer todos los archivos descargados que tengan la extensión .tar . Esto resulta útil porque necesita empaquetar los archivos de artefacto en tar si desea conservar los permisos de archivo unix. Al habilitar la StoreAsTar opción en la tarea Publicar artefactos de compilación, los artefactos se almacenarán automáticamente como archivos .tar .


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.

Comentarios

Nota

El equipo de Azure Pipelines recomienda actualizar desde artefactos de compilación a Artefactos de canalización para un rendimiento más rápido.

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.191.1 o superior
Categoría de la tarea: Utilidad