Compartir vía


JenkinsQueueJob@1: tarea Trabajo de cola de Jenkins v1

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

Syntax

# Jenkins Queue Job v1
# Queue a job on a Jenkins server.
- task: JenkinsQueueJob@1
  inputs:
    serverEndpoint: # string. Required. Jenkins service endpoint. 
    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
    #parameterizedJob: false # boolean. Parameterized job. Default: false.
    #jobParameters: # string. Optional. Use when parameterizedJob = true. Job parameters.

Entradas

serverEndpoint - Punto de conexión de servicio de Jenkins
string. Obligatorio.

Especifica el punto de conexión de servicio para la instancia de Jenkins. Haga clic en el vínculo Administrar (al usar la tarea asistente) para crear un nuevo punto de 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, este paso 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 entrada 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 realiza correctamente o se produce 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 entrada se completa correctamente sin esperar a que se ejecute la canalización de compilación completa de Jenkins.


parameterizedJob - Trabajo con parámetros
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 parámetros de trabajo con una por línea, por ejemplo: <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

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.

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 Todas las versiones de agente admitidas.
Categoría de la tarea: Build