ServiceFabricDeploy@1 - Tugas penyebaran aplikasi Service Fabric v1

Gunakan tugas ini untuk menyebarkan aplikasi Service Fabric ke kluster. Tugas ini menyebarkan aplikasi Azure Service Fabric ke kluster sesuai dengan pengaturan yang ditentukan dalam profil penerbitan.

Catatan

Tugas ini tidak mendukung autentikasi Azure Resource Manager dengan federasi identitas alur kerja.

Sintaks

# Service Fabric application deployment v1
# Deploy an Azure Service Fabric application to a cluster.
- task: ServiceFabricDeploy@1
  inputs:
    applicationPackagePath: # string. Required. Application Package. 
    serviceConnectionName: # string. Required. Cluster Service Connection. 
    #publishProfilePath: # string. Publish Profile. 
    #applicationParameterPath: # string. Application Parameters. 
    #overrideApplicationParameter: false # boolean. Override Application Parameters. Default: false.
  # Advanced Settings
    #compressPackage: false # boolean. Compress Package. Default: false.
    #copyPackageTimeoutSec: # string. CopyPackageTimeoutSec. 
    #registerPackageTimeoutSec: # string. RegisterPackageTimeoutSec. 
    overwriteBehavior: 'SameAppTypeAndVersion' # 'Always' | 'Never' | 'SameAppTypeAndVersion'. Required. Overwrite Behavior. Default: SameAppTypeAndVersion.
    #skipUpgradeSameTypeAndVersion: false # boolean. Skip upgrade for same Type and Version. Default: false.
    #skipPackageValidation: false # boolean. Skip package validation. Default: false.
  # Upgrade Settings
    #useDiffPackage: false # boolean. Use Diff Package. Default: false.
    #overridePublishProfileSettings: false # boolean. Override All Publish Profile Upgrade Settings. Default: false.
    #isUpgrade: true # boolean. Optional. Use when overridePublishProfileSettings = true. Upgrade the Application. Default: true.
    #unregisterUnusedVersions: true # boolean. Unregister Unused Versions. Default: true.
    #upgradeMode: 'Monitored' # 'Monitored' | 'UnmonitoredAuto' | 'UnmonitoredManual'. Required when overridePublishProfileSettings = true && isUpgrade = true. Upgrade Mode. Default: Monitored.
    #FailureAction: 'Rollback' # 'Rollback' | 'Manual'. Required when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. FailureAction. Default: Rollback.
    #UpgradeReplicaSetCheckTimeoutSec: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true. UpgradeReplicaSetCheckTimeoutSec. 
    #TimeoutSec: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true. TimeoutSec. 
    #ForceRestart: false # boolean. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true. ForceRestart. Default: false.
    #HealthCheckRetryTimeoutSec: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. HealthCheckRetryTimeoutSec. 
    #HealthCheckWaitDurationSec: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. HealthCheckWaitDurationSec. 
    #HealthCheckStableDurationSec: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. HealthCheckStableDurationSec. 
    #UpgradeDomainTimeoutSec: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. UpgradeDomainTimeoutSec. 
    #ConsiderWarningAsError: false # boolean. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. ConsiderWarningAsError. Default: false.
    #DefaultServiceTypeHealthPolicy: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. DefaultServiceTypeHealthPolicy. 
    #MaxPercentUnhealthyDeployedApplications: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. MaxPercentUnhealthyDeployedApplications. 
    #UpgradeTimeoutSec: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. UpgradeTimeoutSec. 
    #ServiceTypeHealthPolicyMap: # string. Optional. Use when overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. ServiceTypeHealthPolicyMap. 
  # Docker Settings
    #configureDockerSettings: false # boolean. Configure Docker settings. Default: false.
    #registryCredentials: 'AzureResourceManagerEndpoint' # 'AzureResourceManagerEndpoint' | 'ContainerRegistryEndpoint' | 'UsernamePassword'. Required when configureDockerSettings = true. Registry Credentials Source. Default: AzureResourceManagerEndpoint.
    #dockerRegistryConnection: # string. Alias: dockerRegistryEndpoint. Required when configureDockerSettings = true && registryCredentials = ContainerRegistryEndpoint. Docker Registry Service Connection. 
    #azureSubscription: # string. Alias: azureSubscriptionEndpoint. Required when configureDockerSettings = true && registryCredentials = AzureResourceManagerEndpoint. Azure subscription. 
    #registryUserName: # string. Optional. Use when configureDockerSettings = true && registryCredentials = UsernamePassword. Registry User Name. 
    #registryPassword: # string. Optional. Use when configureDockerSettings = true && registryCredentials = UsernamePassword. Registry Password. 
    #passwordEncrypted: true # boolean. Optional. Use when configureDockerSettings = true && registryCredentials = UsernamePassword. Password Encrypted. Default: true.

Input

applicationPackagePath - Paket Aplikasi
string. Wajib diisi.

Menentukan jalur ke paket aplikasi yang akan disebarkan. Variabel dan kartubebas dapat digunakan di jalur tersebut.

serviceConnectionName - Koneksi Layanan Kluster
string. Wajib diisi.

Menentukan koneksi layanan Azure Service Fabric yang akan digunakan untuk menyambungkan ke kluster. Pengaturan yang ditentukan dalam koneksi layanan yang dirujuk ini mengambil alih yang ditentukan dalam profil penerbitan. Pilih Manage untuk mendaftarkan koneksi layanan baru.

Untuk terhubung ke kluster, tugas service fabric menggunakan penyimpanan sertifikasi mesin untuk menyimpan informasi tentang sertifikat. Jika dua rilis berjalan bersama-sama pada satu komputer menggunakan sertifikat yang sama, rilis akan dimulai dengan benar. Namun, jika salah satu tugas selesai, maka sertifikat dari penyimpanan sertifikasi mesin akan dibersihkan, yang memengaruhi rilis kedua.

publishProfilePath - Terbitkan Profil
string.

Pilihan. Menentukan jalur ke file profil publikasi yang menentukan pengaturan yang akan digunakan. Variabel dan kartubebas dapat digunakan di jalur tersebut. Pelajari selengkapnya tentang cara membuat profil penerbitan di Visual Studio.

applicationParameterPath - Parameter Aplikasi
string.

Pilihan. Menentukan jalur ke file parameter aplikasi. Variabel dan kartubebas dapat digunakan di jalur tersebut. Jika ditentukan, ini akan mengambil alih nilai dalam profil penerbitan. Pelajari selengkapnya tentang cara membuat file parameter aplikasi di Visual Studio.

overrideApplicationParameter - Mengesampingkan Parameter Aplikasi
boolean. Nilai default: false.

Pilihan. Menentukan variabel yang ditentukan dalam alur build atau rilis dicocokkan dengan Parameter Name entri dalam file manifes aplikasi. Pelajari selengkapnya tentang cara membuat file parameter aplikasi di Visual Studio. Contoh:

 <Parameters> 
 <Parameter Name="SampleApp_PartitionCount" Value="1" /> 
 <Parameter Name="SampleApp_InstanceCount" DefaultValue="-1" /> 
 </Parameters>

Jika aplikasi Anda memiliki parameter yang didefinisikan seperti dalam contoh di atas, dan Anda ingin mengubah jumlah partisi menjadi 2, Anda dapat menentukan alur rilis atau variabel SampleApp_PartitionCount lingkungan dan nilainya sebagai 2.

Catatan

Jika variabel yang sama didefinisikan dalam alur rilis dan di lingkungan, maka variabel lingkungan akan menggantikan variabel alur rilis.

compressPackage - Kompres Paket
boolean. Nilai default: false.

Opsional. Menentukan apakah paket aplikasi harus dikompresi sebelum menyalin ke penyimpanan citra. Jika diaktifkan, ini akan menggantikan nilai di profil penerbitan. Pelajari selengkapnya tentang mengompresi paket.

copyPackageTimeoutSec - CopyPackageTimeoutSec
string.

Pilihan. Menentukan batas waktu dalam detik untuk menyalin paket aplikasi ke penyimpanan citra. Jika ditentukan, ini akan mengambil alih nilai dalam profil penerbitan.

registerPackageTimeoutSec - RegisterPackageTimeoutSec
string.

Opsional. Menentukan batas waktu dalam detik untuk mendaftarkan atau membatalkan pendaftaran paket aplikasi.

overwriteBehavior - Timpa Perilaku
string. Wajib diisi. Nilai yang diizinkan: Always, Never, dan SameAppTypeAndVersion. Nilai default: SameAppTypeAndVersion.

Menimpa perilaku jika aplikasi ada di kluster dengan nama dan peningkatan yang sama belum dikonfigurasi.

Never tidak akan menghapus aplikasi yang ada. Ini adalah perilaku default.

Always akan menghapus aplikasi yang ada, bahkan jika jenis dan versi aplikasinya berbeda dari aplikasi yang dibuat.

SameAppTypeAndVersion akan menghapus aplikasi yang ada hanya jika jenis dan versi aplikasinya sama dengan aplikasi yang sedang dibuat.

skipUpgradeSameTypeAndVersion - Lewati peningkatan untuk Jenis dan Versi yang sama
boolean. Nilai default: false.

Pilihan. Menentukan apakah peningkatan akan dilewati jika jenis dan versi aplikasi yang sama sudah ada di kluster; jika tidak, peningkatan gagal selama validasi. Jika diaktifkan, penyebaran ulang bersifat idempotensi.

skipPackageValidation - Lewati validasi paket
boolean. Nilai default: false.

Pilihan. Menentukan apakah paket harus divalidasi atau tidak sebelum penyebaran. Pelajari selengkapnya tentang validasi paket.

useDiffPackage - Gunakan Paket Diff
boolean. Nilai default: false.

Pilihan. Peningkatan dengan menggunakan paket diff yang hanya berisi file aplikasi yang diperbarui, manifes aplikasi yang diperbarui, dan file manifes layanan.

Paket diff dibuat dengan membandingkan paket yang ditentukan dalam input paket aplikasi dengan paket yang saat ini terdaftar di kluster target. Jika versi layanan dalam paket kluster saat ini sama dengan paket baru, maka paket layanan ini akan dihapus dari paket aplikasi baru. Pelajari selengkapnya tentang paket diff.

overridePublishProfileSettings - Mengesampingkan Semua Pengaturan Pemutakhiran Profil Penerbitan
boolean. Nilai default: false.

Pilihan. Mengambil alih semua pengaturan peningkatan dengan nilai yang ditentukan atau nilai default (jika tidak ditentukan). Pelajari selengkapnya tentang pengaturan peningkatan.

isUpgrade - Meningkatkan Aplikasi
boolean. Opsional. Gunakan saat overridePublishProfileSettings = true. Nilai default: true.

Menimpa aplikasi jika nilai diatur ke false.

unregisterUnusedVersions - Membatalkan Pendaftaran Versi yang Tidak Digunakan
boolean. Nilai default: true.

Pilihan. Menunjukkan apakah semua versi jenis aplikasi yang tidak digunakan akan dihapus setelah peningkatan.

upgradeMode - Mode Peningkatan
string. Diperlukan saat overridePublishProfileSettings = true && isUpgrade = true. Nilai yang diizinkan: Monitored, UnmonitoredAuto, dan UnmonitoredManual. Nilai default: Monitored.

FailureAction - FailureAction
string. Diperlukan saat overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. Nilai yang diizinkan: Rollback, Manual. Nilai default: Rollback.

UpgradeReplicaSetCheckTimeoutSec - UpgradeReplicaSetCheckTimeoutSec
string. Pilihan. Gunakan saat overridePublishProfileSettings = true && isUpgrade = true.

TimeoutSec - TimeoutSec
string. Opsional. Gunakan saat overridePublishProfileSettings = true && isUpgrade = true.

ForceRestart - ForceRestart
boolean. Opsional. Gunakan saat overridePublishProfileSettings = true && isUpgrade = true. Nilai default: false.

HealthCheckRetryTimeoutSec - HealthCheckRetryTimeoutSec
string. Opsional. Gunakan saat overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

HealthCheckWaitDurationSec - HealthCheckWaitDurationSec
string. Opsional. Gunakan saat overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

HealthCheckStableDurationSec - HealthCheckStableDurationSec
string. Opsional. Gunakan saat overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

UpgradeDomainTimeoutSec - UpgradeDomainTimeoutSec
string. Opsional. Gunakan saat overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

ConsiderWarningAsError - PertimbangkanWarningAsError
boolean. Opsional. Gunakan saat overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored. Nilai default: false.

DefaultServiceTypeHealthPolicy - DefaultServiceTypeHealthPolicy
string. Opsional. Gunakan saat overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

MaxPercentUnhealthyDeployedApplications - MaxPercentUnhealthyDeployedApplications
string. Opsional. Gunakan saat overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

UpgradeTimeoutSec - UpgradeTimeoutSec
string. Opsional. Gunakan saat overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

ServiceTypeHealthPolicyMap - ServiceTypeHealthPolicyMap
string. Opsional. Gunakan saat overridePublishProfileSettings = true && isUpgrade = true && upgradeMode = Monitored.

configureDockerSettings - Mengonfigurasi pengaturan Docker
boolean. Nilai default: false.

Mengonfigurasi aplikasi dengan pengaturan Docker yang ditentukan.

registryCredentials - Sumber Kredensial Registri
string. Diperlukan saat configureDockerSettings = true. Nilai yang diizinkan: AzureResourceManagerEndpoint (Azure Resource Manager Service Connection), ContainerRegistryEndpoint (Container Registry Service Connection), UsernamePassword (Nama Pengguna dan Kata Sandi). Nilai default: AzureResourceManagerEndpoint.

Menentukan bagaimana kredensial untuk registri Docker disediakan.

dockerRegistryConnection - Koneksi Layanan Docker Registry
Alias input: dockerRegistryEndpoint. string. Diperlukan saat configureDockerSettings = true && registryCredentials = ContainerRegistryEndpoint.

Menentukan koneksi layanan registri Docker. Diperlukan untuk perintah yang perlu mengautentikasi dengan registri.

Catatan

Tugas ini mencoba mengenkripsi rahasia registri sebelum mengirimkannya ke kluster service fabric. Namun, tugas memerlukan sertifikat server kluster untuk diinstal pada mesin agen. Jika sertifikat tidak ada, rahasia registri tidak akan dienkripsi.

azureSubscription - Langganan Azure
Alias input: azureSubscriptionEndpoint. string. Diperlukan saat configureDockerSettings = true && registryCredentials = AzureResourceManagerEndpoint.

Menentukan langganan Azure.

Catatan

Tugas ini akan mencoba mengenkripsi rahasia registri sebelum mengirimkannya ke kluster service fabric. Namun, tugas memerlukan sertifikat server kluster untuk diinstal pada mesin agen. Jika sertifikat tidak ada, rahasia registri tidak akan dienkripsi.

registryUserName - Nama Pengguna Registri
string. Pilihan. Gunakan saat configureDockerSettings = true && registryCredentials = UsernamePassword.

Menentukan nama pengguna untuk registri Docker.

registryPassword - Kata Sandi Registri
string. Pilihan. Gunakan saat configureDockerSettings = true && registryCredentials = UsernamePassword.

Menentukan kata sandi untuk registri Docker. Jika kata sandi tidak dienkripsi, Anda harus menggunakan variabel rahasia alur rilis kustom untuk menyimpannya.

passwordEncrypted - Kata Sandi Terenkripsi
boolean. Pilihan. Gunakan saat configureDockerSettings = true && registryCredentials = UsernamePassword. Nilai default: true.

Anda harus mengenkripsi kata sandi Anda menggunakan Invoke-ServiceFabricEncryptText. Jika tidak, dan sertifikat yang cocok dengan Thumbprint Sertifikat Server di Koneksi Layanan Kluster diinstal pada agen build, sertifikat tersebut akan digunakan untuk mengenkripsi kata sandi; jika tidak, kesalahan akan terjadi.

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 untuk menyebarkan aplikasi Service Fabric ke kluster. Tugas ini menyebarkan aplikasi Azure Service Fabric ke kluster sesuai dengan pengaturan yang ditentukan dalam profil penerbitan.

Service Fabric

Tugas ini menggunakan penginstalan Service Fabric untuk menyambungkan dan menyebarkan ke kluster Service Fabric. Unduh dan instal Service Fabric pada agen build.

Persyaratan

Persyaratan	Deskripsi
Jenis alur	YAML, Build klasik, Rilis 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 apa pun 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	Sebarkan