tarefa JenkinsQueueJob@1 - Jenkins Queue Job v1
Use essa tarefa para enfileirar um trabalho em um 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
- Ponto de extremidade de serviço do Jenkins
string
. Obrigatórios.
Especifica o ponto de extremidade de serviço para sua instância do Jenkins. Clique no link Gerenciar (ao usar a tarefa assistente) para criar um novo ponto de extremidade de serviço jenkins.
jobName
- Nome do trabalho
string
. Obrigatórios.
O nome do trabalho jenkins a ser enfileirado. Isso deve corresponder exatamente ao nome do trabalho no servidor Jenkins.
isMultibranchJob
- O trabalho é do tipo pipeline multibranch
boolean
. Valor padrão: false
.
Esse 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
- Multibranch Pipeline Branch
string
. Obrigató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 a saída do console e aguardar a conclusão
boolean
. Valor padrão: true
.
Se especificada, essa entrada captura a saída do console de build do Jenkins, aguarda a conclusão do build do Jenkins e é bem-sucedida/falha com base no resultado de build do Jenkins. Caso contrário, depois que o trabalho jenkins for enfileirado, essa etapa será concluída com êxito sem esperar a execução do build do Jenkins.
capturePipeline
- Capturar a saída do pipeline e aguardar a conclusão do pipeline
boolean
. Opcional. Use quando captureConsole = true
. Valor padrão: true
.
Se especificada, 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 do Jenkins for concluído, essa entrada será concluída com êxito sem esperar a execução completa do pipeline de build do Jenkins.
parameterizedJob
- Trabalho parametrizado
boolean
. Valor padrão: false
.
Especifica se o trabalho do Jenkins aceita parâmetros. Use essa entrada mesmo que todos os valores de parâmetro padrão sejam usados e nenhum parâmetro seja especificado.
jobParameters
- Parâmetros de trabalho
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 commitId
valor de parâmetro para o git ID do commit 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 da tarefa
Todas as tarefas têm opções de controle além de suas entradas de tarefa. Para obter mais informações, consulte Opções de controle e 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 |
É executado em | Agent, DeploymentGroup |
Demandas | Nenhum |
Funcionalidades | Essa tarefa não atende a nenhuma demanda por tarefas subsequentes no trabalho. |
Restrições de comando | Qualquer |
Variáveis configuráveis | Qualquer |
Versão do agente | Todas as versões do agente com suporte. |
Categoria da tarefa | Build |