JenkinsQueueJob@2: tarea trabajo de cola de Jenkins v2

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

Sintaxis

# 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 - de conexión del 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.

nombre del trabajo de jobName -
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 - Trabajo es de 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 - de rama de canalización multibranch
string. Obligatorio 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 - salida de la consola capture y espere 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 complete 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 se complete 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 de Jenkins completa y se complete correctamente o se produzca un error 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.

de trabajo con parámetros de isParameterizedJob -
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.

parámetros jobParameters - Job
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 valor de parámetro de commitId 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 de sobre variables.

Los tipos de parámetros de Jenkins admitidos son:

• Boolean
• Choice
• Password
• String

failOnUnstableResult - Error al de resultados inestables
boolean. Valor predeterminado: false.

Especifica la rigurosidad de una definición correcta o si se debe considerar inestable como un error o no. El valor false es para una versión no estricta y el true es 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 de conexión con error
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 sus entradas de tarea. Para obtener más información, consulte 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
el 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.

Observaciones

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 los Recopilar resultados de Azure Pipelines/TFS acción posterior a la compilación y configúrelo 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 de y espera la finalización recopilar resultados del trabajo de nivel raíz o la salida de la canalización de captura de y esperar a que la finalización de la canalización recopilar resultados de todos los trabajos de canalización.

Los resultados se descargarán en el $(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 estará 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
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.144.0 o superior
Categoría de tarea	Construir