ServiceFabricUpdateManifests@2 - Memperbarui tugas Service Fabric manifests v2

Gunakan tugas ini dalam alur build untuk memperbarui versi aplikasi Service Fabric yang dipaketkan secara otomatis. Tugas ini menambahkan akhiran versi ke semua versi layanan dan aplikasi, yang ditentukan dalam file manifes, dalam paket aplikasi Azure Service Fabric.

Sintaks

# Update Service Fabric manifests v2
# Automatically update portions of application and service manifests in a packaged Azure Service Fabric application.
- task: ServiceFabricUpdateManifests@2
  inputs:
    updateType: 'Manifest versions' # 'Manifest versions' | 'Docker image settings'. Required. Update Type. Default: Manifest versions.
    applicationPackagePath: # string. Required. Application Package. 
    #versionSuffix: '.$(Build.BuildNumber)' # string. Required when updateType = Manifest versions. Version Value. Default: .$(Build.BuildNumber).
    #versionBehavior: 'Append' # 'Append' | 'Replace'. Optional. Use when updateType = Manifest versions. Version Behavior. Default: Append.
    #updateOnlyChanged: false # boolean. Optional. Use when updateType = Manifest versions. Update only if changed. Default: false.
    #pkgArtifactName: # string. Optional. Use when updateType = Manifest versions && updateOnlyChanged = true. Package Artifact Name. 
    #logAllChanges: true # boolean. Optional. Use when updateType = Manifest versions && updateOnlyChanged = true. Log all changes. Default: true.
    #compareType: 'LastSuccessful' # 'LastSuccessful' | 'Specific'. Optional. Use when updateType = Manifest versions && updateOnlyChanged = true. Compare against. Default: LastSuccessful.
    #buildNumber: # string. Optional. Use when updateType = Manifest versions && compareType = Specific. Build Number. 
    #overwriteExistingPkgArtifact: true # boolean. Optional. Use when updateType = Manifest versions && updateOnlyChanged = true. Overwrite Existing Package Artifact. Default: true.
    #imageNamesPath: # string. Optional. Use when updateType = Docker image settings. Image Names Path. 
    #imageDigestsPath: # string. Required when updateType = Docker image settings. Image Digests Path.

Input

updateType - Jenis Pembaruan
string. Wajib diisi. Nilai yang diizinkan: Manifest versions, Docker image settings. Nilai default: Manifest versions.

Menentukan jenis pembaruan yang harus dilakukan pada file manifes. Untuk menggunakan kedua jenis pembaruan, tambahkan instans tugas ini ke alur build untuk setiap jenis pembaruan yang akan dijalankan.

applicationPackagePath - Paket Aplikasi
string. Wajib diisi.

Menentukan jalur ke paket aplikasi. Variabel dan kartubebas dapat digunakan di jalur tersebut. applicationPackagePath tidak boleh memiliki garis miring berikutnya, baik \ atau /.

versionSuffix - Nilai Versi
string. Diperlukan saat updateType = Manifest versions. Nilai default: .$(Build.BuildNumber).

Menentukan versi dalam file manifes.

Tip

Anda dapat mengubah format nomor build secara langsung atau menggunakan perintah pengelogan untuk mengatur variabel secara dinamis dalam format. Misalnya, Anda bisa menggunakan $(VersionSuffix) yang ditentukan dalam tugas PowerShell:

$versionSuffix = ".$([DateTimeOffset]::UtcNow.ToString('yyyyMMdd.HHmmss'))"
Write-Host "##vso[task.setvariable variable=VersionSuffix;]$versionSuffix"

versionBehavior - Perilaku Versi
string. Opsional. Gunakan saat updateType = Manifest versions. Nilai yang diizinkan: Append, Replace. Nilai default: Append.

Menentukan apakah akan menambahkan nilai versi ke nilai yang ada dalam file manifes atau menggantinya.

updateOnlyChanged - Perbarui hanya jika diubah
boolean. Pilihan. Gunakan saat updateType = Manifest versions. Nilai default: false.

Menambahkan akhiran versi baru hanya ke paket yang telah berubah dari build sebelumnya. Jika tidak ada perubahan yang ditemukan, akhiran versi dari build sebelumnya akan ditambahkan.

Catatan

Secara default, pengkompilasi akan membuat output yang berbeda meskipun tidak ada perubahan yang dilakukan. Gunakan bendera kompilator deterministik untuk memastikan build dengan input yang sama menghasilkan output yang sama.

pkgArtifactName - Nama Artefak Paket
string. Opsional. Gunakan saat updateType = Manifest versions && updateOnlyChanged = true.

Menentukan nama artefak yang berisi paket aplikasi untuk perbandingan.

logAllChanges - Catat semua perubahan
boolean. Pilihan. Gunakan saat updateType = Manifest versions && updateOnlyChanged = true. Nilai default: true.

Membandingkan semua file di setiap paket dan log jika file ditambahkan, dihapus, atau jika kontennya berubah. Jika tidak, boolean ini membandingkan file dalam paket hanya sampai perubahan pertama ditemukan untuk performa yang lebih cepat.

compareType - Bandingkan dengan
string. Pilihan. Gunakan saat updateType = Manifest versions && updateOnlyChanged = true. Nilai yang diizinkan: LastSuccessful (Build Terakhir Berhasil), Specific (Build Tertentu). Nilai default: LastSuccessful.

Menentukan apakah akan membandingkan dengan build terakhir yang selesai dan berhasil atau terhadap build tertentu.

buildNumber - Nomor Build
string. Pilihan. Gunakan saat updateType = Manifest versions && compareType = Specific.

Menentukan nomor build untuk perbandingan.

overwriteExistingPkgArtifact - Timpa Artefak Paket yang Ada
boolean. Pilihan. Gunakan saat updateType = Manifest versions && updateOnlyChanged = true. Nilai default: true.

Mengunduh salinan artefak baru. Jika tidak, boolean ini menggunakan salinan yang ada jika ada.

imageNamesPath - Jalur Nama Gambar
string. Pilihan. Gunakan saat updateType = Docker image settings.

Menentukan jalur ke file teks yang berisi nama gambar Docker yang terkait dengan aplikasi Service Fabric yang harus diperbarui dengan hash. Setiap nama gambar harus berada di barisnya sendiri dan harus dalam urutan yang sama dengan hash dalam file Image Digests. Jika gambar dibuat oleh proyek Service Fabric, file ini dihasilkan sebagai bagian dari target Paket, dan lokasi outputnya dikendalikan oleh properti BuiltDockerImagesFilePath.

imageDigestsPath - Jalur Hash Gambar
string. Diperlukan saat updateType = Docker image settings.

Menentukan jalur ke file teks yang berisi nilai hash gambar Docker yang terkait dengan aplikasi Service Fabric. File ini dapat dihasilkan oleh tugas Docker saat menggunakan tindakan pendorongan. File harus berisi baris teks dalam format registry/image_name@digest_value.

Opsi kontrol tugas

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

Variabel output

Tidak ada.

Keterangan

Gunakan tugas ini dalam alur build untuk memperbarui versi aplikasi Service Fabric yang dipaketkan secara otomatis. Tugas ini menambahkan akhiran versi ke semua versi layanan dan aplikasi, yang ditentukan dalam file manifes, dalam paket aplikasi Azure Service Fabric.

Catatan

Tugas ini memerlukan Windows PowerShell.

Tugas ini tidak tersedia dalam alur rilis .

Tugas ini hanya dapat digunakan dalam alur build untuk memperbarui versi aplikasi Service Fabric yang dipaketkan secara otomatis.

Tugas ini mendukung dua jenis pembaruan:

1. Versi manifes: Updates versi Layanan dan Aplikasi yang ditentukan dalam file manifes dalam paket aplikasi Service fabric. Jika ditentukan, manifest version bandingkan file saat ini dengan build sebelumnya dan perbarui versi hanya untuk layanan yang diubah.

2. Pengaturan gambar Docker: Updates pengaturan gambar kontainer docker yang ditentukan dalam file manifes dalam paket aplikasi Service fabric. Pengaturan gambar yang akan ditempatkan dipilih dari dua file:

   a. File nama gambar: File ini dihasilkan oleh tugas build.

   b. File hash gambar: File ini dihasilkan oleh tugas docker saat mendorong gambar ke registri.

Contoh

• *Tugas Penyebaran Aplikasi Service Fabric

Persyaratan

Persyaratan	Deskripsi
Jenis alur	YAML, Build klasik
Berjalan pada	Agen, DeploymentGroup
Permintaan	Agen yang dihost sendiri harus memiliki kemampuan yang sesuai dengan tuntutan berikut untuk menjalankan pekerjaan yang menggunakan tugas ini: Cmd
Kemampuan	Tugas ini tidak memenuhi tuntutan untuk tugas berikutnya dalam pekerjaan.
Pembatasan perintah	Apa pun
Variabel yang dapat diatur	Apa pun
Versi agen	1.95.0 atau lebih tinggi
Kategori tugas	Utilitas