JenkinsQueueJob@2 – Tarefa de fila do Jenkins v2

Use essa 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.

Entradas

serverEndpoint - de conexão de serviço do 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 na fila. Isso deve corresponder exatamente ao nome do trabalho no servidor Jenkins.

isMultibranchJob - Job é do tipo de pipeline multibranch
boolean. Valor padrão: false.

Este 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 - branch de pipeline multibranch
string. Necessá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 saída do console e aguardar a conclusão
boolean. Valor padrão: true.

Se especificada, essa entrada capturará a saída do console de build do Jenkins, aguardará a conclusão do build do Jenkins e terá êxito/falha com base no resultado do build do Jenkins. Caso contrário, depois que o trabalho jenkins for enfileirado, essa tarefa será concluída com êxito sem aguardar a execução do build do Jenkins.

capturePipeline - Capturar 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 capturará a saída completa do console de pipeline de build do Jenkins, aguardará a conclusão do pipeline de build completo do Jenkins e terá êxito/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 - 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âmetro padrão forem usados e nenhum parâmetro for realmente especificado.

parâmetros de trabalho jobParameters -
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 valor de parâmetro commitId para a ID de confirmação do Git 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 em de resultados instáveis
boolean. Valor padrão: false.

Especifica a rigidez de uma definição de êxito ou se deve considerar 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 build instável será tratado como uma falha. Caso contrário, um resultado instável é tratado como um sucesso.

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

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

delayBetweenRetries - Tempo entre novas tentativas
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 de tarefa

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

Variáveis de saída

Essa tarefa define as seguintes variáveis de saída , 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 Download Artifacts do Jenkins para baixar os artefatos para esta instância de trabalho específica.

Observações

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

Team Foundation Server Plug-in

Você pode usar o Plug-in do Team Foundation Server (versão 5.2.0 ou mais recente) para coletar arquivos automaticamente do workspace 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 do qual você deseja coletar resultados, adicione o Coletar resultados para o Azure Pipelines/TFS ação pós-build e configure-o com um ou mais pares de tipo de resultado e inclua o padrão de arquivo.

3. No Trabalho de Fila do Jenkins, a tarefa de build habilita a saída do console do Capture e aguarda a conclusão coletar resultados do trabalho de nível raiz ou a saída do pipeline do Capture e aguardar 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 esse local. Cada conjunto de tipos de resultados coletados pelo plug-in estará no diretório de resultados de equipe, $(Build.StagingDirectory)/jenkinsResults/Nome do Trabalho/team-results/ResultType/. Esse é o diretório em que 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).

Requisitos

Requisito	Descrição
Tipos de pipeline	YAML, build clássico, versão clássica
Execuções em	Agent, DeploymentGroup
de demandas	Nenhum
recursos	Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
restrições de comando	Qualquer
variáveis settable	Qualquer
Versão do agente	2.144.0 ou superior
Categoria de tarefa	Construir