JenkinsQueueJob@1 – Tarefa Jenkins Queue Job v1

Use essa tarefa para enfileirar um trabalho em um servidor Jenkins.

Sintaxe

# 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 - de ponto de extremidade de serviço jenkins
string. Obrigatório

Especifica o ponto de extremidade de serviço para sua instância do Jenkins. Clique no link Gerenciar (ao usar o assistente de tarefa) para criar um novo ponto de extremidade de serviço jenkins.

jobName - nome do trabalho
string. Obrigatório

O nome do trabalho jenkins na fila. Isso deve corresponder exatamente ao nome do trabalho no servidor Jenkins.

isMultibranchJob - Job é do tipo Pipeline Multibranch
boolean. Valor padrão: false.

Este trabalho é um pipeline multibranch. Se especificado, adicione o nome de branch apropriado. Essa entrada requer o Plug-in do Team Foundation Server para Jenkins v5.3.4 ou posterior.

multibranchPipelineBranch - branch de pipeline multibranch
string. Necessário quando isMultibranchJob = true.

Enfileira esse trabalho de pipeline multibranch no branch especificado. Essa entrada requer o Plug-in do Team Foundation Server para Jenkins v5.3.4 ou posterior.

captureConsole - Capturar saída do console e aguardar a conclusão
boolean. Valor padrão: true.

Se especificada, essa entrada capturará a saída do console de build do Jenkins, aguardará a conclusão do build do Jenkins e terá êxito/falha com base no resultado do build do Jenkins. Caso contrário, depois que o trabalho jenkins for enfileirado, essa etapa será concluída com êxito sem aguardar a execução do build do Jenkins.

capturePipeline - Capturar saída do pipeline e aguardar a conclusão do pipeline
boolean. Opcional. Use quando captureConsole = true. Valor padrão: true.

Se especificado, essa entrada captura a saída completa do console de pipeline de build do Jenkins, aguarda a conclusão do pipeline de build completo do Jenkins e é bem-sucedida/falha com base no resultado do pipeline de build do Jenkins. Caso contrário, depois que o primeiro trabalho jenkins for concluído, essa entrada será concluída com êxito sem aguardar a execução completa do pipeline de build do Jenkins.

parameterizedJob - de trabalho parametrizado
boolean. Valor padrão: false.

Especifica se o trabalho jenkins aceita parâmetros. Use essa entrada mesmo se todos os valores de parâmetro padrão forem usados e nenhum parâmetro for realmente especificado.

parâmetros de trabalho jobParameters -
string. Opcional. Use quando parameterizedJob = true.

Especifica parâmetros de trabalho com um por linha, por exemplo: <parameterName>=<parameterValue>.

Para definir um parâmetro como um valor vazio, que é útil para substituir um valor padrão, deixe de fora o valor do parâmetro. Por exemplo, especifique <parameterName>=.

Há suporte para variáveis. Para definir um valor de parâmetro commitId para a ID de confirmação do Git do build, por exemplo, você pode usar: commitId=$(Build.SourceVersion). Para obter mais informações, consulte a documentação sobre variáveis.

Os tipos de parâmetro Jenkins com suporte são:

• Boolean
• Choice
• Password
• String

Opções de controle de tarefa

Todas as tarefas têm opções de controle além de suas entradas de tarefa. Para obter mais informações, consulte as opções de Controle de e as propriedades comuns da tarefa.

Variáveis de saída

Nenhum.

Requisitos

Requisito	Descrição
Tipos de pipeline	YAML, build clássico, versão clássica
Execuções em	Agent, DeploymentGroup
de demandas	Nenhum
recursos	Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
restrições de comando	Qualquer
variáveis settable	Qualquer
Versão do agente	Todas as versões de agente com suporte.
Categoria de tarefa	Construir