JenkinsQueueJob@1 — задача задания очереди Jenkins версии 1

Статья
03/24/2025

Используйте эту задачу для очереди задания на сервере Jenkins.

Синтаксис

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

Входные данные

serverEndpoint - конечная точка службы Jenkins
string. Обязательное.

Указывает конечную точку службы для экземпляра Jenkins. Щелкните ссылку "Управление" (при использовании помощника по задачам), чтобы создать конечную точку службы Jenkins.

имени задания jobName -
string. Обязательное.

Имя задания Jenkins в очередь. Это должно точно соответствовать имени задания на сервере Jenkins.

isMultibranchJob - задание имеет тип многобранчного конвейера
boolean. Значение по умолчанию: false.

Это задание является многобранчным конвейером. При указании добавьте соответствующее имя ветви. Для этого ввода требуется подключаемый модуль Team Foundation Server для Jenkins версии 5.3.4 или более поздней версии.

многобранчной ветви конвейера multibranchPipelineBranch -
string. Требуется, если isMultibranchJob = true.

Очереди этого многобранчного задания конвейера в указанной ветви. Для этого ввода требуется подключаемый модуль Team Foundation Server для Jenkins версии 5.3.4 или более поздней версии.

captureConsole - Вывод консоли записи и ожидание завершения
boolean. Значение по умолчанию: true.

Если задано, этот вход записывает выходные данные консоли сборки Jenkins, ожидает завершения сборки Jenkins и завершается успешно или завершается сбоем на основе результата сборки Jenkins. В противном случае после очередей заданий Jenkins этот шаг успешно завершается без ожидания выполнения сборки Jenkins.

capturePipeline - Сбор выходных данных конвейера и ожидание завершения конвейера
boolean. Необязательно. Используется при captureConsole = true. Значение по умолчанию: true.

Если задано, этот вход записывает полные выходные данные консоли конвейера сборки Jenkins, ожидает завершения полного конвейера сборки Jenkins и завершается сбоем на основе результата конвейера сборки Jenkins. В противном случае после завершения первого задания Jenkins этот вход успешно завершается без ожидания выполнения полного конвейера сборки Jenkins.

параметризованного задания parameterizedJob -
boolean. Значение по умолчанию: false.

Указывает, принимает ли задание Jenkins параметры. Используйте эти входные данные, даже если используются все значения параметров по умолчанию, а параметры фактически не указаны.

параметры задания jobParameters -
string. Необязательно. Используется при parameterizedJob = true.

Задает параметры задания с одной строкой, например <parameterName>=<parameterValue>.

Чтобы задать параметр пустым значением, которое полезно для переопределения значения по умолчанию, оставьте значение параметра пустым. Например, укажите <parameterName>=.

Поддерживаются переменные. Чтобы задать значение параметра commitId идентификатором фиксации сборки Git, например, можно использовать: commitId=$(Build.SourceVersion). Дополнительные сведения см. в документации по переменным.

Поддерживаемые типы параметров Jenkins:

Boolean
Choice
Password
String

Параметры управления задачами

Помимо входных данных, все задачи имеют параметры управления. Дополнительные сведения см. в разделе Параметры управления и общие свойства задач.

Выходные переменные

Нет.

Требования

Требование	Описание
Типы конвейеров	YAML, классическая сборка, классический выпуск
Выполняется в	Агент, DeploymentGroup
требования	Нет
возможностей	Эта задача не удовлетворяет требованиям к последующим задачам в задании.
ограничения команд	Любое
переменные settable	Любое
Версия агента	Все поддерживаемые версии агента.
Категория задач	Строить

Поделиться через