Compartilhar via


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