Partilhar via


JenkinsQueueJob@1 - Tarefa de Fila do Jenkins v1

Utilize esta tarefa para colocar uma tarefa em fila num 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 final de serviço do Jenkins
string. Obrigatório.

Especifica o ponto final de serviço da instância do Jenkins. Clique na ligação Gerir (ao utilizar a tarefa assistente) para criar um novo ponto final de serviço do Jenkins.


jobName - Nome da tarefa
string. Obrigatório.

O nome da tarefa do Jenkins para a fila. Isto tem de corresponder exatamente ao nome da tarefa no servidor Jenkins.


isMultibranchJob - A tarefa é do tipo de Pipeline Multibranch
boolean. Valor predefinido: false.

Esta tarefa é um pipeline multibranch. Se especificado, adicione o nome do ramo adequado. Esta entrada requer o Plug-in do Team Foundation Server para Jenkins v5.3.4 ou posterior.


multibranchPipelineBranch - Multibranch Pipeline Branch
string. Necessário quando isMultibranchJob = true.

Coloca em fila esta tarefa de pipeline multibranch no ramo especificado. Esta entrada requer o Plug-in do Team Foundation Server para Jenkins v5.3.4 ou posterior.


captureConsole - Capturar o resultado da consola e aguardar a conclusão
boolean. Valor predefinido: true.

Se for especificado, esta entrada captura a saída da consola de compilação do Jenkins, aguarda a conclusão da compilação do Jenkins e é bem-sucedida/falha com base no resultado da compilação do Jenkins. Caso contrário, uma vez que as filas de trabalho do Jenkins são concluídas com êxito, sem esperar pela execução da compilação do Jenkins.


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

Se especificado, esta entrada captura a saída completa da consola do pipeline de compilação do Jenkins, aguarda a conclusão do pipeline completo da compilação do Jenkins e é bem-sucedida/falha com base no resultado do pipeline de compilação do Jenkins. Caso contrário, uma vez concluída a primeira tarefa do Jenkins, esta entrada é concluída com êxito sem aguardar a execução do pipeline completo da compilação do Jenkins.


parameterizedJob - Tarefa parametrizada
boolean. Valor predefinido: false.

Especifica se a tarefa do Jenkins aceita parâmetros. Utilize esta entrada mesmo que todos os valores de parâmetros predefinidos sejam utilizados e não sejam realmente especificados parâmetros.


jobParameters - Parâmetros da tarefa
string. Opcional. Utilize quando parameterizedJob = true.

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

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

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

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

  • Boolean
  • Choice
  • Password
  • String

Opções de controlo de tarefas

Todas as tarefas têm opções de controlo para além das entradas de tarefas. Para obter mais informações, veja Opções de controlo e propriedades de tarefas comuns.

Variáveis de saída

Nenhum.

Requisitos

Requisito Description
Tipos de pipeline YAML, Compilação clássica, Versão clássica
É executado em Agente, DeploymentGroup
Exigências Nenhuma
Capacidades Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes na tarefa.
Restrições de comandos Qualquer
Variáveis de tabelas definidas Qualquer
Versão do agente Todas as versões de agente suportadas.
Categoria da tarefa Compilação