JenkinsQueueJob@2 - Tugas antrean Jenkins v2

Gunakan tugas ini untuk mengantre pekerjaan di server Jenkins.

Sintaks

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

Input

serverEndpoint - Koneksi layanan Jenkins
string. Wajib diisi.

Menentukan koneksi layanan untuk instans Jenkins Anda. Klik tautan Kelola untuk membuat koneksi layanan Jenkins baru.

jobName - Nama pekerjaan
string. Wajib diisi.

Nama pekerjaan Jenkins untuk mengantre. Ini harus sama persis dengan nama pekerjaan di server Jenkins.

isMultibranchJob - Pekerjaan berjenis alur multibranch
boolean. Nilai default: false.

Pekerjaan ini adalah alur multibranch. Jika ditentukan, tambahkan nama cabang yang sesuai. Input ini memerlukan Plugin Server Team Foundation untuk Jenkins v5.3.4 atau yang lebih baru.

multibranchPipelineBranch - Cabang alur multibranch
string. Diperlukan saat isMultibranchJob = true.

Mengantrekan pekerjaan alur multibranch ini pada cabang yang ditentukan. Input ini memerlukan Plugin Server Team Foundation untuk Jenkins v5.3.4 atau yang lebih baru.

captureConsole - Mengambil output konsol dan menunggu penyelesaian
boolean. Nilai default: true.

Jika ditentukan, input ini menangkap output konsol build Jenkins, menunggu build Jenkins selesai, dan berhasil/gagal berdasarkan hasil build Jenkins. Jika tidak, setelah antrean pekerjaan Jenkins, tugas ini berhasil diselesaikan tanpa menunggu build Jenkins berjalan.

capturePipeline - Mengambil output alur dan menunggu penyelesaian alur
boolean. Pilihan. Gunakan saat captureConsole = true. Nilai default: true.

Jika ditentukan, tugas ini menangkap output konsol alur build Jenkins lengkap, menunggu alur build Jenkins lengkap selesai, dan berhasil/gagal berdasarkan hasil alur build Jenkins. Jika tidak, setelah pekerjaan Jenkins pertama selesai, tugas ini berhasil diselesaikan tanpa menunggu alur build Jenkins penuh dijalankan.

isParameterizedJob - Pekerjaan berparameter
Alias input: parameterizedJob. boolean. Nilai default: false.

Menentukan apakah pekerjaan Jenkins menerima parameter. Gunakan input ini meskipun semua nilai parameter default digunakan dan tidak ada parameter yang benar-benar ditentukan.

jobParameters - Parameter pekerjaan
string. Opsional. Gunakan saat parameterizedJob = true.

Menentukan parameter pekerjaan, dengan satu per baris, dalam format <parameterName>=<parameterValue>.

Untuk mengatur parameter ke nilai kosong, yang berguna untuk mengganti nilai default, biarkan nilai parameter. Misalnya, tentukan parameterName=.

Variabel didukung. Untuk mengatur commitId nilai parameter ke ID penerapan Git dari build, misalnya, Anda dapat menggunakan: commitId=$(Build.SourceVersion). Untuk informasi selengkapnya, lihat dokumentasi tentang variabel.

Jenis parameter Jenkins yang didukung adalah:

• Boolean
• Choice
• Password
• String

failOnUnstableResult - Gagal pada hasil yang tidak stabil
boolean. Nilai default: false.

Menentukan ketatnya definisi keberhasilan, atau apakah akan menganggap tidak stabil sebagai kegagalan atau tidak. Nilainya false adalah untuk versi yang tidak ketat, dan true adalah untuk versi yang ketat. Jika diatur ke true, hasil build yang tidak stabil diperlakukan sebagai kegagalan. Jika tidak, hasil yang tidak stabil diperlakukan sebagai keberhasilan.

retryCount - Jumlah percobaan ulang untuk koneksi yang gagal
string. Nilai default: 3.

Menentukan jumlah percobaan ulang koneksi ketika kegagalan koneksi atau kesalahan terjadi.

delayBetweenRetries - Waktu antara percobaan ulang
string. Nilai default: 60.

Menentukan jumlah waktu antara percobaan kembali koneksi ketika terjadi kesalahan. Nilai ini ditentukan dalam detik.

Opsi kontrol tugas

Semua tugas memiliki opsi kontrol selain input tugas mereka. Untuk informasi selengkapnya, lihat Opsi kontrol dan properti tugas umum.

Variabel output

Tugas ini menentukan variabel output berikut, yang dapat Anda konsumsi dalam langkah-langkah hilir, pekerjaan, dan tahapan.

JENKINS_JOB_ID
ID instans pekerjaan Jenkins yang diantrekan oleh tugas ini. Gunakan variabel ini dalam tugas Jenkins Download Artefak untuk mengunduh artefak untuk instans pekerjaan khusus ini.

Keterangan

Gunakan tugas ini untuk mengantre pekerjaan di server Jenkins.

Team Foundation Server Plug-in

Anda dapat menggunakan Team Foundation Server Plug-in (versi 5.2.0 atau yang lebih baru) untuk mengumpulkan file secara otomatis dari ruang kerja Jenkins dan mengunduhnya ke dalam build.

Untuk menyiapkannya:

1. Instal Plug-in Server Team Foundation di server Jenkins.

2. Di server Jenkins, untuk setiap pekerjaan yang ingin Anda kumpulkan hasilnya, tambahkan tindakan Kumpulkan hasil untuk Azure Pipelines/TFS pasca-build lalu konfigurasikan dengan satu atau beberapa pasangan jenis hasil dan sertakan pola file.

3. Pada Pekerjaan Antrean Jenkins, tugas build mengaktifkan output konsol Capture dan menunggu penyelesaian untuk mengumpulkan hasil dari pekerjaan tingkat akar, atau output alur Capture dan menunggu penyelesaian alur untuk mengumpulkan hasil dari semua pekerjaan alur.

Hasil akan diunduh ke $(Build.StagingDirectory)/jenkinsResults/Nama Pekerjaan/team-results.zip dan diekstraksi ke lokasi ini. Setiap set jenis hasil yang dikumpulkan oleh plug-in, akan berada di bawah direktori hasil tim, $(Build.StagingDirectory)/jenkinsResults/Nama Pekerjaan/team-results/ResultType/. Ini adalah direktori tempat hasil build dapat diterbitkan oleh tugas hilir (misalnya, Menerbitkan Hasil Pengujian, dan Menerbitkan Hasil Cakupan Kode).

Persyaratan

Persyaratan	Deskripsi
Jenis alur	YAML, Build klasik, Rilis klasik
Berjalan pada	Agen, DeploymentGroup
Permintaan	Tidak ada
Kemampuan	Tugas ini tidak memenuhi tuntutan untuk tugas berikutnya dalam pekerjaan.
Pembatasan perintah	Apa pun
Variabel yang dapat diatur	Apa pun
Versi agen	2.144.0 atau lebih tinggi
Kategori tugas	Build