Partilhar via


JenkinsQueueJob@1 - Tarefa Jenkins Queue Job v1

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

Observação

Esta tarefa está obsoleta; Usa JenkinsQueueJob@2.

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.

Insumos

serverEndpoint - de ponto de extremidade do serviço Jenkins
string. Obrigatório.

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


jobName - Nome do trabalho
string. Obrigatório.

O nome do trabalho Jenkins para a fila. Isso deve corresponder exatamente ao nome do trabalho no servidor Jenkins.


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

Este trabalho é um pipeline multibranch. Se especificado, adicione o nome da ramificação apropriado. Esta entrada requer Team Foundation Server Plugin para Jenkins v5.3.4 ou posterior.


multibranchPipelineBranch - de ramificação de pipeline multifilial
string. Necessário quando isMultibranchJob = true.

Enfileira esse trabalho de pipeline de várias ramificações na ramificação especificada. Esta entrada requer Team Foundation Server Plugin para Jenkins v5.3.4 ou posterior.


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

Se especificado, essa entrada captura a saída do console de compilação do Jenkins, aguarda a conclusão da compilação do Jenkins e tem êxito/falha com base no resultado da compilação do Jenkins. Caso contrário, uma vez que as filas de trabalho do Jenkins, essa etapa será concluída com êxito sem esperar que a compilação do Jenkins seja executada.


capturePipeline - Capture a saída do pipeline e aguarde 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 do pipeline de compilação do Jenkins, aguarda a conclusão do pipeline de construção completo do Jenkins e obtém êxito/falha com base no resultado do pipeline de construção do Jenkins. Caso contrário, assim que o primeiro trabalho do Jenkins for concluído, essa entrada será concluída com êxito sem esperar que o pipeline de construção completo do Jenkins seja executado.


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âmetros padrão forem usados e nenhum parâmetro for realmente 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, o que é útil para substituir um valor padrão, deixe de lado o valor do parâmetro. Por exemplo, especifique <parameterName>=.

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

Os tipos de parâmetros Jenkins suportados são:

  • Boolean
  • Choice
  • Password
  • String

Opções de controlo de tarefas

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

Variáveis de saída

Nenhum.

Requerimentos

Requisito Descrição
Tipos de pipeline YAML, Construção clássica, Versão clássica
Funciona em Agente, DeploymentGroup
Exigências Nenhum
Capacidades Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes no trabalho.
Restrições de comando Qualquer
Variáveis configuráveis Qualquer
Versão do agente Todas as versões de agente suportadas.
Categoria de tarefa Construir