DownloadPipelineArtifact@1: descarga de la tarea de artefacto de canalización v1

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

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

Nota:

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

Syntax

# 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 - Descarga de 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.

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

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

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

Identificador de definición de la canalización. En una canalización en ejecución, definitionId puede encontrarse en la variable System.DefinitionId . definitionId También se puede recuperar de la dirección URL en 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, es definitionId 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 los artefactos de la compilación de desencadenador.
boolean. Opcional. Use cuando buildType == specific. Valor predeterminado: false.

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

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

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

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

pipelineId - Construir
Alias de entrada: buildId. string. Necesario cuando buildType == specific && buildVersionToDownload == specific.

Identificador de la ejecución de la canalización desde la que se van a descargar los artefactos. En una canalización buildId en ejecución, puede encontrarse en la variable Build.BuildId . buildId También se puede recuperar de la dirección URL en 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, 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 .

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

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

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.

itemPattern - Patrón de coincidencia
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.

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

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

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.

Comentarios

Hay una versión más reciente de esta tarea. Para obtener más información, consulte 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 id. 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, definitionId se puede encontrar en la variable System.DefinitionId . definitionId También se puede recuperar de la dirección URL en 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, es definitionId 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 la canalización desde la que se van a descargar los artefactos. En una canalización buildId en ejecución, puede encontrarse en la variable Build.BuildId . buildId También se puede recuperar de la dirección URL en 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, 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
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.155.1 o superior
Categoría de la tarea:	Utilidad