Compartir vía


JenkinsDownloadArtifacts@1: tarea de descarga de artefactos de Jenkins v1

Use esta tarea para descargar artefactos producidos por un trabajo de Jenkins.

Syntax

# Jenkins download artifacts v1
# Download artifacts produced by a Jenkins job.
- task: JenkinsDownloadArtifacts@1
  inputs:
    jenkinsServerConnection: # string. Alias: serverEndpoint. Required. Jenkins service connection. 
    jobName: # string. Required. Job name. 
    #jenkinsJobType: # string. Optional. Use when jobName = invalidjobName. Jenkins job type. 
    saveTo: 'jenkinsArtifacts' # string. Required. Save to. Default: jenkinsArtifacts.
  # Advanced
    jenkinsBuild: 'LastSuccessfulBuild' # 'LastSuccessfulBuild' | 'BuildNumber'. Required. Download artifacts produced by. Default: LastSuccessfulBuild.
    #jenkinsBuildNumber: '1' # string. Required when jenkinsBuild == BuildNumber. Jenkins build number. Default: 1.
    #itemPattern: '**' # string. Item Pattern. Default: **.
    #downloadCommitsAndWorkItems: false # boolean. Download Commits and WorkItems. Default: false.
    #startJenkinsBuildNumber: # string. Optional. Use when downloadCommitsAndWorkItems == true && jenkinsBuild == BuildNumber. Download commits and work items from. 
    #artifactDetailsFileNameSuffix: # string. Optional. Use when downloadCommitsAndWorkItems == invalid. Commit and WorkItem FileName. 
  # Propagated Artifacts
    #propagatedArtifacts: false # boolean. Artifacts are propagated to Azure. Default: false.
    #artifactProvider: 'azureStorage' # 'azureStorage'. Required when propagatedArtifacts == notValid. Artifact Provider. Default: azureStorage.
    #ConnectedServiceNameARM: # string. Required when propagatedArtifacts == true. Azure Subscription. 
    #storageAccountName: # string. Required when propagatedArtifacts == true. Storage Account Name. 
    #containerName: # string. Required when propagatedArtifacts == true. Container Name. 
    #commonVirtualPath: # string. Optional. Use when propagatedArtifacts == true. Common Virtual Path.
# Jenkins Download Artifacts v1
# Download artifacts produced by a Jenkins job.
- task: JenkinsDownloadArtifacts@1
  inputs:
    jenkinsServerConnection: # string. Alias: serverEndpoint. Required. Jenkins service connection. 
    jobName: # string. Required. Job name. 
    #jenkinsJobType: # string. Optional. Use when jobName = invalidjobName. Jenkins job type. 
    saveTo: 'jenkinsArtifacts' # string. Required. Save to. Default: jenkinsArtifacts.
  # Advanced
    jenkinsBuild: 'LastSuccessfulBuild' # 'LastSuccessfulBuild' | 'BuildNumber'. Required. Download artifacts produced by. Default: LastSuccessfulBuild.
    #jenkinsBuildNumber: '1' # string. Required when jenkinsBuild == BuildNumber. Jenkins build number. Default: 1.
    #itemPattern: '**' # string. Item Pattern. Default: **.
    #downloadCommitsAndWorkItems: false # boolean. Download Commits and WorkItems. Default: false.
    #startJenkinsBuildNumber: # string. Optional. Use when downloadCommitsAndWorkItems == true && jenkinsBuild == BuildNumber. Download commits and work items from. 
    #artifactDetailsFileNameSuffix: # string. Optional. Use when downloadCommitsAndWorkItems == invalid. Commit and WorkItem FileName. 
  # Propagated Artifacts
    #propagatedArtifacts: false # boolean. Artifacts are propagated to Azure. Default: false.
    #artifactProvider: 'azureStorage' # 'azureStorage'. Required when propagatedArtifacts == notValid. Artifact Provider. Default: azureStorage.
    #ConnectedServiceNameARM: # string. Required when propagatedArtifacts == true. Azure Subscription. 
    #storageAccountName: # string. Required when propagatedArtifacts == true. Storage Account Name. 
    #containerName: # string. Required when propagatedArtifacts == true. Container Name. 
    #commonVirtualPath: # string. Optional. Use when propagatedArtifacts == true. Common Virtual Path.

Entradas

jenkinsServerConnection - Conexión del servicio Jenkins
Alias de entrada: serverEndpoint. string. Obligatorio.

Especifica la conexión de servicio para la instancia de Jenkins. Para crear una nueva conexión de servicio, haga clic en el vínculo Administrar.


jobName - Nombre del trabajo
string. Obligatorio.

Especifica el nombre del trabajo de Jenkins desde el que descargar artefactos. Debe coincidir exactamente con el nombre del trabajo en el servidor Jenkins.


jenkinsJobType - Tipo de trabajo de Jenkins
string. Opcional. Use cuando jobName = invalidjobName.

Especifica automáticamente el tipo de trabajo de Jenkins.


saveTo - Guardar en
string. Obligatorio. Valor predeterminado: jenkinsArtifacts.

Especifica el directorio donde se descargan y guardan los artefactos de Jenkins. Este directorio se crea si no existe.


jenkinsBuild - Descarga de artefactos generados por
string. Obligatorio. Valores permitidos: LastSuccessfulBuild (Última compilación correcta), BuildNumber (número de compilación). Valor predeterminado: LastSuccessfulBuild.

Descarga los artefactos generados por la última compilación correcta o desde una instancia de compilación específica.


jenkinsBuildNumber - Número de compilación de Jenkins
string. Necesario cuando jenkinsBuild == BuildNumber. Valor predeterminado: 1.

Descarga los artefactos generados por esta compilación.


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

Especifica los archivos que se van a descargar como un patrón de minimatch de varias líneas. Más información sobre los patrones de coincidencia de archivos.

El patrón ** predeterminado descarga todos los archivos en todos los artefactos generados por el trabajo de Jenkins. Para descargar todos los archivos dentro de la colocación del artefacto, use drop/**.


downloadCommitsAndWorkItems - Descargar confirmaciones y workItems
boolean. Valor predeterminado: false.

Habilita la descarga de las confirmaciones y los detalles del elemento de trabajo asociados al trabajo de Jenkins.


startJenkinsBuildNumber - Descarga de confirmaciones y elementos de trabajo de
string. Opcional. Use cuando downloadCommitsAndWorkItems == true && jenkinsBuild == BuildNumber.

Inicia el número de compilación para descargar confirmaciones y elementos de trabajo. Si se proporciona, se descargan todas las confirmaciones y los elementos de trabajo entre el número de compilación inicial y el número de compilación proporcionado como entrada para descargar artefactos.


artifactDetailsFileNameSuffix - Commit y WorkItem FileName
string. Opcional. Use cuando downloadCommitsAndWorkItems == invalid.

Especifica el sufijo de nombre de archivo para confirmaciones y datos adjuntos de elementos de trabajo. Los datos adjuntos se crean con commits_{suffix}.json y workitem_{suffix}.json. Si no se proporciona esta entrada, los datos adjuntos se crean con los nombres commits.json y workitems.json.


propagatedArtifacts - Los artefactos se propagan a Azure
boolean. Valor predeterminado: false.

Use esta entrada si los artefactos de Jenkins se propagaron a Azure. Para cargar artefactos de Jenkins en Azure, consulte este complemento de Jenkins.


artifactProvider - Proveedor de artefactos
string. Necesario cuando propagatedArtifacts == notValid. Valores permitidos: azureStorage (Azure Storage). Valor predeterminado: azureStorage.

Especifica el proveedor de almacenamiento externo que se usa en el trabajo de Jenkins para cargar los artefactos.


ConnectedServiceNameARM - Suscripción de Azure
string. Necesario cuando propagatedArtifacts == true.

Especifica la suscripción de Azure Resource Manager para los artefactos.


storageAccountName - Nombre de la cuenta de almacenamiento
string. Necesario cuando propagatedArtifacts == true.

Especifica azure clásico o Resource Manager cuentas de almacenamiento. Seleccione el nombre de la cuenta de almacenamiento donde se propagan los artefactos.


containerName - Nombre del contenedor
string. Necesario cuando propagatedArtifacts == true.

Especifica el nombre del contenedor en la cuenta de almacenamiento donde se cargan los artefactos.


commonVirtualPath - Ruta de acceso virtual común
string. Opcional. Use cuando propagatedArtifacts == true.

Especifica la ruta de acceso a los artefactos dentro del contenedor de Almacenamiento de Azure.


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

Use esta tarea para descargar artefactos producidos por un trabajo de Jenkins.

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