Skema Konfigurasi (File.cscfg) Azure Cloud Services (klasik)

  • Artikel

Penting

Cloud Services (klasik) sekarang tidak lagi digunakan untuk pelanggan baru dan akan dihentikan untuk semua pelanggan pada 31 Agustus 2024. Penyebaran baru sebaiknya menggunakan Azure Resource Manager yang baru berdasarkan model penyebaran Azure Cloud Services (dukungan tambahan) .

File konfigurasi layanan menentukan jumlah instans peran yang akan disebarkan untuk setiap peran dalam layanan, nilai pengaturan konfigurasi apa pun, dan thumbprint untuk setiap sertifikat yang terkait dengan peran. Jika layanan merupakan bagian dari Virtual Network, informasi konfigurasi untuk jaringan harus disediakan dalam file konfigurasi layanan, serta dalam file konfigurasi virtual network. Ekstensi default untuk file konfigurasi layanan adalah .cscfg.

Model layanan dijelaskan oleh Skema Definisi Cloud Service (klasik).

Secara default, file skema konfigurasi Azure Diagnostics diinstal ke direktori C:\Program Files\Microsoft SDKs\Windows Azure\.NET SDK\<version>\schemas. Ganti <version> dengan versi Azure SDK yang terinstal.

Untuk informasi selengkapnya tentang mengonfigurasi peran dalam layanan, lihat Apa itu model Cloud Service.

Skema Konfigurasi Layanan Dasar

Format dasar file konfigurasi layanan adalah sebagai berikut.

<ServiceConfiguration serviceName="<service-name>" osFamily="<osfamily-number>" osVersion="<os-version>" schemaVersion="<schema-version>">

  <Role …>
    …
  </Role>

  <NetworkConfiguration>
    …
  </NetworkConfiguration>

</ServiceConfiguration>

Definisi skema

Topik berikut ini menjelaskan skema untuk elemen ServiceConfiguration:

Namespace Konfigurasi Layanan

Kumpulan nama XML untuk file konfigurasi layanan adalah: http://schemas.microsoft.com/ServiceHosting/2008/10/ServiceConfiguration.

Elemen ServiceConfiguration

Elemen ServiceConfiguration ini adalah elemen tingkat atas dari file konfigurasi layanan.

Tabel berikut ini menjelaskan atribut ServiceConfiguration elemen. Semua nilai atribut merupakan jenis string.

Atribut Deskripsi
serviceName Wajib diisi. Nama layanan awan. Nama yang diberikan di sini harus cocok dengan nama yang ditentukan dalam file definisi layanan.
osFamily Opsional. Menentukan OS Tamu yang akan berjalan pada instans peran di layanan awan. Untuk informasi tentang rilis OS Tamu yang didukung, lihat Rilis OS Tamu Azure dan Matriks Kompatibilitas SDK.

Jika Anda tidak menyertakan nilai osFamily dan belum menetapkan atribut osVersion untuk versi OS Tamu tertentu, nilai default 1 akan digunakan.
osVersion Opsional. Menentukan versi OS Tamu yang akan berjalan pada instans peran di layanan awan. Untuk informasi selengkapnya tentang versi OS Tamu, lihat Rilis OS Tamu Azure dan Matriks Kompatibilitas SDK.

Anda dapat menentukan bahwa OS Tamu harus ditingkatkan secara otomatis ke versi terbaru. Untuk melakukan ini, atur nilai atribut osVersion ke *. Ketika diatur ke *, instans peran disebarkan menggunakan versi terbaru OS Tamu untuk keluarga OS yang ditentukan dan akan secara otomatis ditingkatkan ketika versi baru OS Tamu dirilis.

Untuk menentukan versi tertentu secara manual, gunakan Configuration String dari tabel di bagian Versi OS Tamu Transisi, Saat Ini, dan Mendatang di Rilis OS Tamu Azure dan Matriks Kompatibilitas SDK.

Nilai default untuk atribut osVersion adalah *.
schemaVersion Opsional. Menentukan versi skema Konfigurasi Layanan. Versi skema memungkinkan Visual Studio memilih alat SDK yang benar yang akan digunakan untuk validasi skema jika lebih dari satu versi SDK diinstal secara berdampingan. Untuk informasi selengkapnya tentang kompatibilitas skema dan versi, lihat Rilis OS Tamu Azure dan Matriks Kompatibilitas SDK

File konfigurasi layanan harus berisi satu elemen ServiceConfiguration. Elemen ServiceConfiguration ini dapat mencakup sejumlah elemen Role dan nol atau 1 elemen NetworkConfiguration.