JenkinsQueueJob@2 - Tarefa Jenkins queue job v2

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

Sintaxe

# 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.

Insumos

serverEndpoint - de conexão de serviço Jenkins
string. Obrigatório.

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ório.

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

isMultibranchJob - Job é do tipo pipeline multibranch
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 multibranch
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 tarefa 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 tarefa 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 tem ê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 tarefa será concluída com êxito sem esperar que o pipeline de construção completo do Jenkins seja executado.

isParameterizedJob - de trabalho parametrizado
Alias de entrada: parameterizedJob. 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 os parâmetros do trabalho, com um por linha, no formato de <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

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

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

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

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

delayBetweenRetries - Tempo entre novas tentativas
string. Valor padrão: 60.

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

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

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

JENKINS_JOB_ID
A ID da instância de trabalho Jenkins enfileirada por esta tarefa. Use essa variável na tarefa Jenkins Download Artifacts para baixar os artefatos para essa instância de trabalho específica.

Observações

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

Team Foundation Server Plug-in

Você pode usar o Team Foundation Server Plug-in (versão 5.2.0 ou mais recente) para coletar automaticamente arquivos do espaço de trabalho Jenkins e baixá-los para a compilação.

Para configurá-lo:

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

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

3. No Trabalho de Fila Jenkins, a tarefa de compilação habilite a saída do console do Capture e aguarde a conclusão coletar resultados do trabalho de nível raiz ou da saída do pipeline Capture e aguarde a conclusão do pipeline coletar resultados de todos os trabalhos de pipeline.

Os resultados serão baixados para o $(Build.StagingDirectory)/jenkinsResults/Job Name/team-results.zip e extraídos para este local. Cada conjunto de tipos de resultados coletados pelo plug-in estará sob o diretório team-results, $(Build.StagingDirectory)/jenkinsResults/Job Name/team-results/ResultType/. Este é o diretório onde os resultados da compilação podem ser publicados por tarefas downstream (por exemplo, Publicar resultados de teste e Publicar resultados de cobertura de código).

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	2.144.0 ou superior
Categoria de tarefa	Construir