JenkinsQueueJob@2 - Jenkins kuyruk işi v2 görevi

Jenkins sunucusundaki bir işi kuyruğa almak için bu görevi kullanın.

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.

Girişler

serverEndpoint - Jenkins hizmet bağlantısı
string. Gereklidir.

Jenkins örneğinin hizmet bağlantısını belirtir. Yeni bir Jenkins hizmet bağlantısı oluşturmak için Yönet bağlantısına tıklayın.

jobName - İş adı
string. Gereklidir.

Kuyruğa alınacak Jenkins işinin adı. Bu, Jenkins sunucusundaki iş adıyla tam olarak eşleşmelidir.

isMultibranchJob - İş çok faktörlü işlem hattı türünde
boolean. Varsayılan değer: false.

Bu iş çok katmanlı bir işlem hattıdır. Belirtilirse, uygun dal adını ekleyin. Bu giriş, Jenkins v5.3.4 veya üzeri için Team Foundation Server Eklentisi gerektirir.

multibranchPipelineBranch - Çok faktörlü işlem hattı dalı
string. olduğunda isMultibranchJob = truegereklidir.

Bu çok aşamalı işlem hattı işini belirtilen dalda kuyruğa alır. Bu giriş, Jenkins v5.3.4 veya üzeri için Team Foundation Server Eklentisi gerektirir.

captureConsole - Konsol çıkışını yakalayın ve tamamlanmasını bekleyin
boolean. Varsayılan değer: true.

Belirtilirse, bu giriş Jenkins derleme konsolu çıkışını yakalar, Jenkins derlemesinin tamamlanmasını bekler ve Jenkins derleme sonucuna göre başarılı/başarısız olur. Aksi takdirde, Jenkins işi kuyruğa alındıktan sonra bu görev Jenkins derlemesinin çalışmasını beklemeden başarıyla tamamlar.

capturePipeline - İşlem hattı çıkışını yakalayın ve işlem hattının tamamlanmasını bekleyin
boolean. İsteğe bağlı. when captureConsole = truekullanın. Varsayılan değer: true.

Belirtilirse, bu görev tam Jenkins derleme işlem hattı konsol çıkışını yakalar, tam Jenkins derleme işlem hattının tamamlanmasını bekler ve Jenkins derleme işlem hattı sonucuna göre başarılı/başarısız olur. Aksi takdirde, ilk Jenkins işi tamamlandıktan sonra bu görev tam Jenkins derleme işlem hattının çalıştırılmasını beklemeden başarıyla tamamlar.

isParameterizedJob - Parametreli iş
Giriş diğer adı: parameterizedJob. boolean. Varsayılan değer: false.

Jenkins işinin parametreleri kabul etip kabul etmediğini belirtir. Tüm varsayılan parametre değerleri kullanılıp parametre belirtilmemiş olsa bile bu girişi kullanın.

jobParameters - İş parametreleri
string. İsteğe bağlı. when parameterizedJob = truekullanın.

İş parametrelerini, her satırda bir tane olacak şekilde, biçiminde <parameterName>=<parameterValue>belirtir.

Parametreyi, varsayılan değeri geçersiz kılmada yararlı olan boş bir değere ayarlamak için parametre değerinin dışında bırakın. Örneğin, belirtin parameterName=.

Değişkenler desteklenir. Örneğin, derlemenin Git işleme kimliğine bir commitId parametre değeri ayarlamak için şunu kullanabilirsiniz: commitId=$(Build.SourceVersion). Daha fazla bilgi için değişkenlerle ilgili belgelere bakın.

Desteklenen Jenkins parametre türleri şunlardır:

• Boolean
• Choice
• Password
• String

failOnUnstableResult - Kararsız sonuçta başarısız
boolean. Varsayılan değer: false.

Başarı tanımının katılığını veya kararsızlığın hata olarak kabul edilip edilmeyeceğini belirtir. false değeri katı olmayan bir sürüme, değeri ise true katı bir sürüme yöneliktir. olarak ayarlanırsa true, kararsız bir derleme sonucu hata olarak değerlendirilir. Aksi takdirde, kararsız bir sonuç başarılı olarak değerlendirilir.

retryCount - Başarısız bağlantı için yeniden deneme sayısı
string. Varsayılan değer: 3.

Bağlantı hatası veya hata oluştuğunda yeniden bağlantı denemesi miktarını belirtir.

delayBetweenRetries - Yeniden denemeler arasındaki süre
string. Varsayılan değer: 60.

Bir hata oluştuğunda bağlantı yeniden denemeleri arasındaki süreyi belirtir. Bu değer saniye cinsinden belirtilir.

Görev denetim seçenekleri

Tüm görevlerde görev girişlerine ek olarak denetim seçenekleri vardır. Daha fazla bilgi için bkz . Denetim seçenekleri ve ortak görev özellikleri.

Çıkış değişkenleri

Bu görev aşağı akış adımlarında, işlerde ve aşamalarda kullanabileceğiniz aşağıdaki çıkış değişkenlerini tanımlar.

JENKINS_JOB_ID
Bu görev tarafından kuyruğa alınan Jenkins iş örneğinin kimliği. Bu iş örneğinin yapıtlarını indirmek için Jenkins Yapıtları İndir görevinde bu değişkeni kullanın.

Açıklamalar

Jenkins sunucusundaki bir işi kuyruğa almak için bu görevi kullanın.

Team Foundation Server Eklentisi

Dosyaları Jenkins çalışma alanından otomatik olarak toplamak ve derlemeye indirmek için Team Foundation Server Eklentisi'ni (sürüm 5.2.0 veya üzeri) kullanabilirsiniz.

Ayarlamak için:

1. Team Foundation Server Eklentisini Jenkins sunucusuna yükleyin.

2. Jenkins sunucusunda, sonuçları toplamak istediğiniz her iş için Azure Pipelines/TFS derleme sonrası için sonuçları topla eylemini ekleyin ve bunu bir veya daha fazla sonuç türü çiftiyle yapılandırın ve dosya desenini ekleyin.

3. Jenkins Kuyruk İşi'nin derleme görevi, Yakalama konsolu çıkışını etkinleştirir ve kök düzeyindeki işten sonuçları toplamak için tamamlanmasını bekler veya İşlem hattı çıktısını yakalayıp işlem hattının tamamlanmasının tüm işlem hattı işlerinden sonuçları toplamasını bekler.

Sonuçlar $(Build.StagingDirectory)/jenkinsResults/Job Name/team-results.zip konumuna indirilir ve bu konuma ayıklanır. Eklenti tarafından toplanan her sonuç türü kümesi$ (Build.StagingDirectory)/jenkinsResults/Job Name/team-results/ResultType/ takım sonuçları dizininde yer alır. Bu, derleme sonuçlarının aşağı akış görevleri tarafından yayımlandığı dizindir (örneğin, Test Sonuçlarını Yayımla ve Kod Kapsamı Sonuçlarını Yayımla).

Gereksinimler

Gereksinim	Açıklama
İşlem hattı türleri	YAML, Klasik derleme, Klasik sürüm
Üzerinde çalışır	Agent, DeploymentGroup
Talep	Hiçbiri
Özellikler	Bu görev, işteki sonraki görevler için hiçbir talebi karşılamaz.
Komut kısıtlamaları	Herhangi biri
Ayarlanabilir değişkenler	Herhangi biri
Aracı sürümü	2.144.0 veya üzeri
Görev kategorisi	Yapı