tarefa JenkinsQueueJob@2 - Jenkins queue job v2

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

Syntax

# Jenkins queue job v2
# Queue a job on a Jenkins server.
- task: JenkinsQueueJob@2
  inputs:
    serverEndpoint: # string. Required. Jenkins service connection. 
    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
    #isParameterizedJob: false # boolean. Alias: parameterizedJob. Parameterized job. Default: false.
    #jobParameters: # string. Optional. Use when parameterizedJob = true. Job parameters. 
    #failOnUnstableResult: false # boolean. Fail on unstable result. Default: false.
    #retryCount: '3' # string. Number of retries for failed connection. Default: 3.
    #delayBetweenRetries: '60' # string. Time between retries. Default: 60.

Entradas

serverEndpoint - Conexão de serviço do Jenkins
string. Obrigatórios.

Especifica a conexão de serviço para sua instância do Jenkins. Clique no link Gerenciar para criar uma nova conexão 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 de 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 - Ramificação de pipeline multibranch
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 tarefa 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 tarefa 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 tarefa será concluída com êxito sem esperar a execução completa do pipeline de build do Jenkins.

isParameterizedJob - Trabalho parametrizado
Alias de entrada: parameterizedJob. 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, no formato de <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

failOnUnstableResult - Falha no resultado instável
boolean. Valor padrão: false.

Especifica a rigidez de uma definição de êxito ou se deve ser considerado instável como uma falha ou não. O false valor é para uma versão não estrita e o true é para uma versão estrita. Se definido como true, um resultado de build instável será tratado como uma falha. Caso contrário, um resultado instável é tratado como um sucesso.

retryCount - Número de tentativas de conexão com falha
string. Valor padrão: 3.

Especifica a quantidade de tentativas de conexão quando ocorre falha ou erro de conexão.

delayBetweenRetries - Tempo entre repetições
string. Valor padrão: 60.

Especifica a quantidade de tempo entre as tentativas de conexão quando ocorre um erro. Este valor é especificado em segundos.

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

Essa tarefa define as variáveis de saída a seguir, que você pode consumir em etapas downstream, trabalhos e estágios.

JENKINS_JOB_ID
A ID da instância de trabalho jenkins enfileirada por essa tarefa. Use essa variável na tarefa Baixar Artefatos do Jenkins para baixar os artefatos dessa instância de trabalho específica.

Comentários

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

Plug-in do Team Foundation Server

Você pode usar o plug-in do Team Foundation Server (versão 5.2.0 ou mais recente) para coletar automaticamente arquivos do workspace do Jenkins e baixá-los no build.

Para configurá-lo:

1. Instale o plug-in do Team Foundation Server no servidor Jenkins.

2. No servidor Jenkins, para cada trabalho cujos resultados você deseja coletar, adicione a ação pós-build Coletar resultados para o Azure Pipelines/TFS e configure-a com um ou mais pares de tipo de resultado e padrão de arquivo de inclusão.

3. No Trabalho de Fila do Jenkins, a tarefa de build habilita Capturar saída do console e aguardar a conclusão para coletar resultados do trabalho de nível raiz ou Capturar saída do pipeline e aguardar a conclusão do pipeline para coletar resultados de todos os trabalhos de pipeline.

Os resultados serão baixados para $(Build.StagingDirectory)/jenkinsResults/Nome do Trabalho/team-results.zip e extraídos para esse local. Cada conjunto de tipos de resultados coletados pelo plug-in estará no diretório de resultados da equipe, $(Build.StagingDirectory)/jenkinsResults/Nome do Trabalho/team-results/ResultType/. Esse é o diretório em que os resultados do build podem ser publicados por tarefas downstream (por exemplo, Publicar Resultados de Teste e Publicar Resultados de Cobertura de Código).

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	2.144.0 ou superior
Categoria da tarefa	Build