Compartir a través de


DownloadPipelineArtifact@1: tarea Descargar artefacto de canalización v1

Use esta tarea para descargar artefactos de canalización de fases anteriores en esta canalización o desde otra canalización.

Hay una versión más reciente de esta tarea. Para obtener más información, vea DownloadPipelineArtifact@2.

Nota:

Para más información, incluidos los comandos de la CLI de Azure, consulte descarga de artefactos.

Use esta tarea para descargar artefactos de canalización de fases anteriores en esta canalización o desde otra canalización.

Hay una versión más reciente de esta tarea. Para obtener más información, vea DownloadPipelineArtifact@2.

Nota:

Para más información, incluidos los comandos de la CLI de Azure, consulte descarga de artefactos.

Use esta tarea para descargar artefactos de canalización de fases anteriores en esta canalización o desde otra canalización.

Importante

Esta tarea solo se admite en Azure DevOps Services. Si lo usa en Azure DevOps Server, recibirá un mensaje de error similar a Pipeline Artifact Task is not supported in on-premises. Please use Build Artifact Task instead. Usar Descargar artefactos de compilación si usa Azure DevOps Server o TFS 2018.

Sintaxis

# Download Pipeline Artifacts v1
# Download a named artifact from a pipeline to a local path.
- task: DownloadPipelineArtifact@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.
    #branchName: 'refs/heads/master' # string. Required when buildType == specific && buildVersionToDownload == latestFromBranch. Branch name. Default: refs/heads/master.
    #pipelineId: # string. Alias: buildId. Required when buildType == specific && buildVersionToDownload == specific. Build. 
    #tags: # string. Optional. Use when buildType == specific && buildVersionToDownload != specific. Build Tags. 
    #artifactName: # string. Artifact name. 
    #itemPattern: '**' # string. Matching pattern. Default: **.
    targetPath: '$(System.ArtifactsDirectory)' # string. Alias: downloadPath. Required. Destination directory. Default: $(System.ArtifactsDirectory).

Entradas

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

Descarga artefactos generados por la ejecución de canalización actual o desde una ejecución de canalización específica.


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

Especifica el nombre del proyecto o el GUID desde el que se van a descargar los artefactos de canalización.


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

Identificador de definición de la canalización. En una canalización en ejecución, el definitionId se puede encontrar en la variable System.DefinitionId. El definitionId también se puede recuperar de la dirección URL de la página de información general de la canalización en el portal de Azure DevOps. En el ejemplo de dirección URL siguiente, el definitionId es 78: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build?definitionId=78&_a=summary. Para descargar artefactos de una definición de canalización específica, capture el definitionId de esa canalización y especifíquelo como parámetro pipeline.


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

Si está activada, la tarea descarga artefactos de la compilación de desencadenamiento. Si no hay ninguna compilación de desencadenamiento desde la canalización especificada, la tarea 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.

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


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

Especifica el filtro en el nombre de rama/ref. Por ejemplo: refs/heads/develop.


pipelineId - Creación
Alias de entrada: buildId. string. Obligatorio cuando buildType == specific && buildVersionToDownload == specific.

Identificador de la ejecución de canalización desde la que se van a descargar los artefactos. En una canalización en ejecución, el buildId se puede encontrar en la variable Build.BuildId. El buildId también se puede recuperar de la dirección URL de la página de resumen de ejecución de canalización en el portal de Azure DevOps. En el ejemplo de dirección URL siguiente, el buildId es 1088: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build/results?buildId=1088&view=results. Para descargar artefactos de una ejecución de canalización específica, capture el buildId de esa ejecución y especifíquelo como parámetro buildId.


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

Lista delimitada por comas de etiquetas que usa la tarea para devolver compilaciones etiquetadas. No se devuelven compilaciones sin etiqueta.


artifactName - nombre del artefacto
string.

Especifica el nombre del artefacto que se va a descargar. Si el valor se deja vacío, la tarea descarga todos los artefactos asociados a la ejecución de la canalización.


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

Patrones de coincidencia de archivos que limitan los archivos descargados. El valor puede ser uno o varios patrones de coincidencia de archivos que son nuevas líneas delimitadas. Obtenga más información sobre los patrones de coincidencia de archivos .


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

Ruta de acceso en el equipo del agente donde se descargarán los artefactos.


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

Hay una versión más reciente de esta tarea. Para obtener más información, vea DownloadPipelineArtifact@2.

Importante

Esta tarea solo se admite en Azure DevOps Services. Si lo usa en Azure DevOps Server, recibirá un mensaje de error similar a Pipeline Artifact Task is not supported in on-premises. Please use Build Artifact Task instead. Usar Descargar artefactos de compilación si usa Azure DevOps Server o TFS 2018.

De forma predeterminada, los artefactos se descargan en $(Pipeline.Workspace). Si no especifica un nombre de artefacto, se creará un subdirectorio para cada artefacto descargado. Puede usar patrones de coincidencia de archivos para limitar los archivos que desea descargar.

¿Cómo puedo encontrar el identificador de la canalización desde la que quiero descargar un artefacto?

Para buscar el definitionId de una definición de canalización específica

En una canalización en ejecución, el definitionId se puede encontrar en la variable system.DefinitionId de. El definitionId también se puede recuperar de la dirección URL de la página de información general de la canalización en el portal de Azure DevOps. En el ejemplo de dirección URL siguiente, el definitionId es 78: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build?definitionId=78&_a=summary. Para descargar artefactos de una definición de canalización específica, capture el definitionId de esa canalización y especifíquelo como parámetro pipeline.

Para buscar el identificador de compilación de una ejecución de canalización específica

Identificador de la ejecución de canalización desde la que se van a descargar los artefactos. En una canalización en ejecución, el buildId se puede encontrar en la variable Build.BuildId. El buildId también se puede recuperar de la dirección URL de la página de resumen de ejecución de canalización en el portal de Azure DevOps. En el ejemplo de dirección URL siguiente, el buildId es 1088: https://dev.azure.com/fabrikam-inc/FabrikamFiber/_build/results?buildId=1088&view=results. Para descargar artefactos de una ejecución de canalización específica, capture el buildId de esa ejecución y especifíquelo como parámetro buildId.

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 2.155.1 o superior
Categoría de tarea Utilidad