JenkinsQueueJob@2: tarea de trabajo de cola de Jenkins v2

Use esta tarea para poner en cola un trabajo en un servidor Jenkins.

Syntax

# Jenkins queue job v2
# Queue a job on a Jenkins server.
- task: JenkinsQueueJob@2
  inputs:
    serverEndpoint: # string. Required. Jenkins service connection. 
    jobName: # string. Required. Job name. 
    #isMultibranchJob: false # boolean. Job is of multibranch pipeline type. Default: false.
    #multibranchPipelineBranch: # string. Required when isMultibranchJob = true. Multibranch pipeline branch. 
    #captureConsole: true # boolean. Capture console output and wait for completion. Default: true.
    #capturePipeline: true # boolean. Optional. Use when captureConsole = true. Capture pipeline output and wait for pipeline completion. Default: true.
  # Advanced
    #isParameterizedJob: false # boolean. Alias: parameterizedJob. Parameterized job. Default: false.
    #jobParameters: # string. Optional. Use when parameterizedJob = true. Job parameters. 
    #failOnUnstableResult: false # boolean. Fail on unstable result. Default: false.
    #retryCount: '3' # string. Number of retries for failed connection. Default: 3.
    #delayBetweenRetries: '60' # string. Time between retries. Default: 60.

Entradas

serverEndpoint - Conexión de servicio jenkins
string. Obligatorio.

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

jobName - Nombre del trabajo
string. Obligatorio.

Nombre del trabajo de Jenkins que se va a poner en cola. Debe coincidir exactamente con el nombre del trabajo en el servidor Jenkins.

isMultibranchJob - El trabajo es del tipo de canalización multibranch
boolean. Valor predeterminado: false.

Este trabajo es una canalización multibranch. Si se especifica, agregue el nombre de rama adecuado. Esta entrada requiere el complemento team Foundation Server para Jenkins v5.3.4 o posterior.

multibranchPipelineBranch - Rama de canalización multibranch
string. Necesario cuando isMultibranchJob = true.

Pone en cola este trabajo de canalización multibranch en la rama especificada. Esta entrada requiere el complemento team Foundation Server para Jenkins v5.3.4 o posterior.

captureConsole - Captura de la salida de la consola y espera a que finalice
boolean. Valor predeterminado: true.

Si se especifica, esta entrada captura la salida de la consola de compilación de Jenkins, espera a que se complete la compilación de Jenkins y se realice correctamente o se produzca un error en función del resultado de la compilación de Jenkins. De lo contrario, una vez que el trabajo de Jenkins se pone en cola, esta tarea se completa correctamente sin esperar a que se ejecute la compilación de Jenkins.

capturePipeline - Captura de la salida de la canalización y espera a que finalice la canalización
boolean. Opcional. Use cuando captureConsole = true. Valor predeterminado: true.

Si se especifica, esta tarea captura la salida completa de la consola de canalización de compilación de Jenkins, espera a que se complete la canalización de compilación completa de Jenkins y se complete correctamente o no en función del resultado de la canalización de compilación de Jenkins. De lo contrario, una vez completado el primer trabajo de Jenkins, esta tarea se completa correctamente sin esperar a que se ejecute la canalización de compilación completa de Jenkins.

isParameterizedJob - Trabajo con parámetros
Alias de entrada: parameterizedJob. boolean. Valor predeterminado: false.

Especifica si el trabajo de Jenkins acepta parámetros. Use esta entrada incluso si se usan todos los valores de parámetro predeterminados y no se especifica ningún parámetro.

jobParameters - Parámetros de trabajo
string. Opcional. Use cuando parameterizedJob = true.

Especifica los parámetros de trabajo, con uno por línea, en el formato de <parameterName>=<parameterValue>.

Para establecer un parámetro en un valor vacío, que resulta útil para invalidar un valor predeterminado, deje el valor del parámetro. Por ejemplo, especifique parameterName=.

Se admiten variables. Para establecer un commitId valor de parámetro en el identificador de confirmación de Git de la compilación, por ejemplo, puede usar: commitId=$(Build.SourceVersion). Para obtener más información, consulte la documentación sobre variables.

Los tipos de parámetros de Jenkins admitidos son:

• Boolean
• Choice
• Password
• String

failOnUnstableResult - Error en el resultado inestable
boolean. Valor predeterminado: false.

Especifica la exactitud de una definición correcta o si se debe considerar inestable como un error o no. El false valor es para una versión no estricta y es true para una versión estricta. Si se establece en true, un resultado de compilación inestable se trata como un error. De lo contrario, un resultado inestable se trata como un éxito.

retryCount - Número de reintentos para la conexión con errores
string. Valor predeterminado: 3.

Especifica la cantidad de reintentos de conexión cuando se produce un error o error de conexión.

delayBetweenRetries - Tiempo entre reintentos
string. Valor predeterminado: 60.

Especifica la cantidad de tiempo entre reintentos de conexión cuando se produce un error. El valor debe especificarse en segundos.

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.

JENKINS_JOB_ID
Identificador de la instancia de trabajo de Jenkins en cola por esta tarea. Use esta variable en la tarea Descargar artefactos de Jenkins para descargar los artefactos de esta instancia de trabajo en particular.

Comentarios

Use esta tarea para poner en cola un trabajo en un servidor Jenkins.

Complemento Team Foundation Server

Puede usar el complemento Team Foundation Server (versión 5.2.0 o posterior) para recopilar automáticamente archivos del área de trabajo de Jenkins y descargarlos en la compilación.

Para configurarlo:

1. Instale el complemento Team Foundation Server en el servidor Jenkins.

2. En el servidor Jenkins, para cada trabajo del que desea recopilar resultados, agregue la acción Recopilar resultados de Azure Pipelines/TFS después de la compilación y, a continuación, configúrela con uno o varios pares de tipo de resultado e incluya el patrón de archivo.

3. En el trabajo de cola de Jenkins, la tarea de compilación habilita la salida de la consola de captura y espera a que se completen para recopilar los resultados del trabajo de nivel raíz, o la salida de la canalización de captura y espera a la finalización de canalización para recopilar los resultados de todos los trabajos de canalización.

Los resultados se descargarán en $(Build.StagingDirectory)/jenkinsResults/Job Name/team-results.zip y se extraerán en esta ubicación. Cada conjunto de tipos de resultados recopilados por el complemento se encontrará en el directorio team-results, $(Build.StagingDirectory)/jenkinsResults/Job Name/team-results/ResultType/. Este es el directorio donde las tareas de bajada pueden publicar los resultados de la compilación (por ejemplo, Publicar resultados de pruebas y Publicar resultados de cobertura de código).

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:	Build