Skema WebRole definisi Azure Cloud Services (dukungan diperpanjang)

Artikel
07/24/2024

Peran web Azure adalah peran yang disesuaikan untuk pemrograman aplikasi web yang didukung oleh IIS 7, seperti ASP.NET, PHP, Windows Communication Foundation, dan FastCGI.

Ekstensi default untuk file definisi layanan ini adalah csdef.

Skema definisi layanan dasar untuk peran web

Format dasar file definisi layanan yang berisi peran web adalah sebagai berikut.

<ServiceDefinition …>  
  <WebRole name="<web-role-name>" vmsize="<web-role-size>" enableNativeCodeExecution="[true|false]">  
    <Certificates>  
      <Certificate name="<certificate-name>" storeLocation="<certificate-store>" storeName="<store-name>" />  
    </Certificates>      
    <ConfigurationSettings>  
      <Setting name="<setting-name>" />  
    </ConfigurationSettings>  
    <Imports>  
      <Import moduleName="<import-module>"/>  
    </Imports>  
    <Endpoints>  
      <InputEndpoint certificate="<certificate-name>" ignoreRoleInstanceStatus="[true|false]" name="<input-endpoint-name>" protocol="[http|https|tcp|udp]" localPort="<port-number>" port="<port-number>" loadBalancerProbe="<load-balancer-probe-name>" />  
      <InternalEndpoint name="<internal-endpoint-name>" protocol="[http|tcp|udp|any]" port="<port-number>">  
         <FixedPort port="<port-number>"/>  
         <FixedPortRange min="<minimum-port-number>" max="<maximum-port-number>"/>  
      </InternalEndpoint>  
     <InstanceInputEndpoint name="<instance-input-endpoint-name>" localPort="<port-number>" protocol="[udp|tcp]">  
         <AllocatePublicPortFrom>  
            <FixedPortRange min="<minimum-port-number>" max="<maximum-port-number>"/>  
         </AllocatePublicPortFrom>  
      </InstanceInputEndpoint>  
    </Endpoints>  
    <LocalResources>  
      <LocalStorage name="<local-store-name>" cleanOnRoleRecycle="[true|false]" sizeInMB="<size-in-megabytes>" />  
    </LocalResources>  
    <LocalStorage name="<local-store-name>" cleanOnRoleRecycle="[true|false]" sizeInMB="<size-in-megabytes>" />  
    <Runtime executionContext="[limited|elevated]">  
      <Environment>  
         <Variable name="<variable-name>" value="<variable-value>">  
            <RoleInstanceValue xpath="<xpath-to-role-environment-settings>"/>  
          </Variable>            
      </Environment>  
      <EntryPoint>  
         <NetFxEntryPoint assemblyName="<name-of-assembly-containing-entrypoint>" targetFrameworkVersion="<.net-framework-version>"/>  
      </EntryPoint>  
    </Runtime>  
    <Sites>  
      <Site name="<web-site-name>">  
        <VirtualApplication name="<application-name>" physicalDirectory="<directory-path>"/>  
        <VirtualDirectory name="<directory-path>" physicalDirectory="<directory-path>"/>  
        <Bindings>  
          <Binding name="<binding-name>" endpointName="<endpoint-name-bound-to>" hostHeader="<url-of-the-site>"/>  
        </Bindings>  
      </Site>  
    </Sites>  
    <Startup priority="<for-internal-use-only>">  
      <Task commandLine="<command-to=execute>" executionContext="[limited|elevated]" taskType="[simple|foreground|background]">  
        <Environment>  
         <Variable name="<variable-name>" value="<variable-value>">  
            <RoleInstanceValue xpath="<xpath-to-role-environment-settings>"/>  
          </Variable>            
        </Environment>  
      </Task>  
    </Startup>  
    <Contents>  
      <Content destination="<destination-folder-name>" >  
        <SourceDirectory path="<local-source-directory>" />  
      </Content>  
    </Contents>  
  </WebRole>  
</ServiceDefinition>

Elemen skema

File definisi layanan menyertakan elemen-elemen ini, dijelaskan secara rinci di bagian berikutnya dalam artikel ini:

WebRole

ConfigurationSettings

InstanceInputEndpoint

AllocatePublicPortFrom

Pengikatan-Pengikatan

WebRole

Elemen WebRole menjelaskan peran yang disesuaikan untuk pemrograman aplikasi web, seperti yang didukung oleh IIS 7 dan ASP.NET. Layanan mungkin berisi nol atau beberapa peran web.

Tabel berikut ini menjelaskan atribut WebRole elemen.

Atribut	Tipe	Deskripsi
nama	string	Harus diisi. Nama untuk peran web. Nama perannya pasti unik.
enableNativeCodeExecution	Boolean	Opsional. Nilai default adalah `true`; eksekusi kode asli dan kepercayaan penuh diaktifkan secara default. Atur atribut ini ke `false` untuk menonaktifkan eksekusi kode asli untuk peran web, dan gunakan kepercayaan parsial Azure sebagai gantinya.
vmsize	string	Opsional. Atur nilai ini untuk mengubah ukuran komputer virtual yang dialokasikan ke peran. Nilai defaultnya adalah `Small`. Untuk informasi selengkapnya, lihat Ukuran Komputer Virtual untuk Cloud Services.

ConfigurationSettings

Elemen ConfigurationSettings menjelaskan kumpulan pengaturan konfigurasi untuk peran web. Elemen ini adalah induk dari Setting elemen.

Pengaturan

SettingElemen ini menjelaskan nama dan pasangan nilai yang menentukan pengaturan konfigurasi untuk instans peran.

Tabel berikut ini menjelaskan atribut Setting elemen.

Atribut	Tipe	Deskripsi
nama	string	Harus diisi. Nama unik untuk pengaturan konfigurasi.

Pengaturan konfigurasi untuk peran adalah pasangan nama dan nilai yang dideklarasikan dalam file definisi layanan dan diatur dalam file konfigurasi layanan.

LocalResources

Elemen LocalResources menjelaskan kumpulan sumber daya penyimpanan lokal untuk peran web. Elemen ini adalah induk dari LocalStorage elemen.

LocalStorage

LocalStorageElemen mengidentifikasi sumber daya penyimpanan lokal yang menyediakan ruang sistem file untuk layanan pada waktu proses. Peran dapat menentukan nol atau lebih sumber daya penyimpanan lokal.

Catatan

LocalStorageElemen dapat muncul sebagai anak dari WebRole elemen untuk mendukung kompatibilitas dengan versi Azure SDK yang lebih lama.

Tabel berikut ini menjelaskan atribut LocalStorage elemen.

Atribut	Tipe	Deskripsi
nama	string	Harus diisi. Nama unik untuk toko lokal.
cleanOnRoleRecycle	Boolean	Opsional. Menunjukkan apakah toko lokal harus dibersihkan ketika peran dimulai ulang. Nilai default `true`.
sizeInMb	int	Opsional. Jumlah ruang penyimpanan yang diinginkan untuk digunakan untuk toko lokal, di MB. Jika tidak ditentukan, ruang penyimpanan default yang dialokasikan adalah 100 MB. Jumlah minimum ruang penyimpanan yang mungkin dialokasikan adalah 1 MB. Ukuran maksimum sumber daya lokal tergantung pada ukuran komputer virtual. Untuk informasi selengkapnya, lihat Ukuran Komputer Virtual untuk Cloud Services.

Nama direktori yang dialokasikan ke sumber daya penyimpanan lokal sesuai dengan nilai yang disediakan untuk atribut name.

Titik akhir

EndpointsElemen ini menjelaskan pengumpulan titik akhir input (eksternal), internal, dan instans untuk peran. Elemen ini adalah induk dari InputEndpoint, InternalEndpoint, dan InstanceInputEndpoint elemen.

Titik akhir Input dan Internal dialokasikan secara terpisah. Layanan dapat memiliki total 25 titik akhir input, internal, dan input instans, yang dapat dialokasikan di 25 peran yang diizinkan dalam layanan. Misalnya, jika Anda memiliki lima peran, Anda dapat mengalokasikan lima titik akhir input per peran, atau Anda dapat mengalokasikan 25 titik akhir input ke satu peran atau Anda dapat mengalokasikan masing-masing satu titik akhir input ke 25 peran.

Catatan

Setiap peran yang digunakan memerlukan satu instans per peran. Penyediaan default untuk langganan dibatasi hingga 20 core dan dengan demikian terbatas pada 20 instans peran. Jika aplikasi Anda memerlukan lebih banyak instans daripada disediakan oleh penyediaan default, lihat Dukungan Penagihan, Manajemen Langganan, dan Kuota untuk informasi lebih lanjut tentang peningkatan kuota Anda.

InputEndpoint

Elemen InputEndpoint menjelaskan titik akhir eksternal ke peran web.

Anda dapat menentukan beberapa titik akhir yang merupakan kombinasi dari titik akhir HTTP, HTTPS, UDP, dan TCP. Anda dapat menentukan nomor port yang Anda pilih untuk titik akhir input, tetapi nomor port yang ditentukan untuk setiap peran dalam layanan harus unik. Misalnya, jika Anda menentukan bahwa peran web menggunakan port 80 untuk HTTP dan port 443 untuk HTTPS, Anda kemudian dapat menentukan bahwa peran web kedua menggunakan port 8080 untuk HTTP dan port 8043 untuk HTTPS.

Tabel berikut ini menjelaskan atribut InputEndpoint elemen.

Atribut	Tipe	Deskripsi
nama	string	Harus diisi. Nama unik untuk titik akhir eksternal.
protokol	string	Harus diisi. Protokol transport untuk titik akhir eksternal. Untuk peran web, kemungkinan nilai adalah `HTTP`, `HTTPS`, `UDP`, atau `TCP`.
pelabuhan	int	Harus diisi. Port untuk titik akhir eksternal. Anda dapat menentukan nomor port yang Anda pilih, tetapi nomor port yang ditentukan untuk setiap peran dalam layanan harus unik. Nilai yang mungkin berkisar antara 1 dan 65535, inklusif (Azure SDK versi 1.7 atau lebih tinggi).
sertifikat	string	Diperlukan untuk titik akhir HTTPS. Nama sertifikat yang ditentukan oleh `Certificate` elemen.
localPort	int	Opsional. Menentukan port yang digunakan untuk sambungan internal di titik akhir. `localPort`Atribut memetakan port eksternal pada titik akhir ke port internal pada suatu peran. Atribut ini berguna dalam skenario di mana peran harus berkomunikasi dengan komponen internal pada port yang berbeda dari yang diekspos secara eksternal. Jika tidak ditentukan, nilainya `localPort`sama dengan `port` atribut. Tetapkan nilai `localPort` ke "*" untuk secara otomatis menetapkan port yang tidak dialokasikan yang dapat ditemukan menggunakan runtime API. Nilai yang mungkin berkisar antara 1 dan 65535, inklusif (Azure SDK versi 1.7 atau lebih tinggi). `localPort`Atribut ini hanya tersedia menggunakan Azure SDK versi 1.3 atau yang lebih tinggi.
ignoreRoleInstanceStatus	Boolean	Opsional. Ketika nilai atribut ini diatur ke `true`, status layanan diabaikan, dan load balancer tidak akan menghapus titik akhir. Mengatur nilai ini `true` agar berguna untuk men-debug instans layanan yang sibuk. Nilai defaultnya adalah `false`. Catatan: Titik akhir masih dapat menerima lalu lintas bahkan ketika peran tidak dalam status Siap.
loadBalancerProbe	string	Opsional. Nama probeload balancer yang terkait dengan titik akhir input. Untuk informasi selengkapnya, lihat Skema LoadBalancerProbe.

InternalEndpoint

Elemen InternalEndpoint menjelaskan titik akhir eksternal ke peran web. Titik akhir internal hanya tersedia untuk instans peran lain yang berjalan dalam layanan; tidak tersedia untuk klien di luar layanan. Peran web yang tidak menyertakan Sites elemen hanya dapat memiliki satu titik akhir internal HTTP, UDP, atau TCP.

Tabel berikut ini menjelaskan atribut InternalEndpoint elemen.

Atribut	Tipe	Deskripsi
nama	string	Harus diisi. Nama unik untuk titik akhir internal.
protokol	string	Harus diisi. Protokol transportasi untuk titik akhir internal. Kemungkinan nilainya adalah `HTTP`, `TCP`, `UDP`, atau `ANY`. Nilai yang `ANY` menentukan bahwa protokol apa pun, port apa pun diperbolehkan.
pelabuhan	int	Opsional. Port yang digunakan untuk koneksi seimbang beban internal pada titik akhir. Titik akhir yang seimbang beban menggunakan dua port. Port yang digunakan untuk alamat IP publik, dan porta yang digunakan pada alamat IP privat. Biasanya, nilai-nilai ini diatur ke sama, tetapi Anda dapat memilih untuk menggunakan port yang berbeda. Nilai yang mungkin berkisar antara 1 dan 65535, inklusif (Azure SDK versi 1.7 atau lebih tinggi). `Port`Atribut ini hanya tersedia menggunakan Azure SDK versi 1.3 atau yang lebih tinggi.

InstanceInputEndpoint

Elemen InstanceInputEndpoint menjelaskan titik akhir input instans ke peran web. Titik akhir input instans dikaitkan dengan instans peran tertentu dengan menggunakan penerusan port di load balancer. Setiap titik akhir input instans dipetakan ke port tertentu dari berbagai port yang mungkin. Elemen ini adalah induk dari AllocatePublicPortFrom elemen.

Elemen InstanceInputEndpoint ini hanya tersedia menggunakan Azure SDK versi 1.7 atau yang lebih tinggi.

Tabel berikut ini menjelaskan atribut InstanceInputEndpoint elemen.

Atribut	Tipe	Deskripsi
nama	string	Harus diisi. Nama unik untuk titik akhir.
localPort	int	Harus diisi. Menentukan port internal yang didengarkan semua instans peran untuk menerima lalu lintas masuk yang diteruskan dari load balancer. Nilai yang mungkin berkisar antara 1 dan 65535, termasuk.
protokol	string	Harus diisi. Protokol transportasi untuk titik akhir internal. Nilai yang mungkin adalah `udp` atau `tcp`. Gunakan `tcp` untuk lalu lintas berbasis http/https.

AllocatePublicPortFrom

Elemen ini AllocatePublicPortFrom menjelaskan rentang port publik yang dapat digunakan pelanggan eksternal untuk mengakses setiap titik akhir input instans. Nomor port publik (VIP) dialokasikan dari rentang ini dan ditetapkan ke setiap titik akhir instans peran individu selama penyebaran dan pembaruan penyewa. Elemen ini adalah induk dari FixedPortRange elemen.

Elemen AllocatePublicPortFrom ini hanya tersedia menggunakan Azure SDK versi 1.7 atau yang lebih tinggi.

FixedPort

FixedPortElemen menentukan port untuk titik akhir internal, yang memungkinkan koneksi seimbang beban pada titik akhir.

FixedPortElemen ini hanya tersedia menggunakan Azure SDK versi 1.3 atau yang lebih tinggi.

Tabel berikut ini menjelaskan atribut FixedPort elemen.

Atribut	Tipe	Deskripsi
pelabuhan	int	Harus diisi. Port untuk titik akhir internal. Atribut ini memiliki efek yang sama dengan mengatur `FixedPortRange` min dan maks ke port yang sama. Nilai yang mungkin berkisar antara 1 dan 65535, inklusif (Azure SDK versi 1.7 atau lebih tinggi).

FixedPortRange

FixedPortRangeElemen menentukan rentang port yang ditetapkan ke titik akhir internal atau titik akhir input instans, dan mengatur port yang digunakan untuk koneksi seimbang beban pada titik akhir.

Catatan

FixedPortRangeElemen bekerja secara berbeda tergantung pada elemen tempatnya berada. Ketika FixedPortRange elemen berada di dalam InternalEndpoint elemen, elemen tersebut membuka semua port pada load balancer dalam kisaran atribut min dan maks untuk semua komputer virtual di mana peran berjalan. Ketika FixedPortRange elemen berada di InstanceInputEndpoint elemen, ia hanya membuka satu port dalam kisaran atribut min dan maks pada setiap komputer virtual yang menjalankan peran.

FixedPortRangeElemen ini hanya tersedia menggunakan Azure SDK versi 1.3 atau yang lebih tinggi.

Tabel berikut ini menjelaskan atribut FixedPortRange elemen.

Atribut	Tipe	Deskripsi
mnt	int	Harus diisi. Port minimum dalam rentang. Nilai yang mungkin berkisar antara 1 dan 65535, inklusif (Azure SDK versi 1.7 atau lebih tinggi).
maks	string	Harus diisi. Port maksimum dalam rentang. Nilai yang mungkin berkisar antara 1 dan 65535, inklusif (Azure SDK versi 1.7 atau lebih tinggi).

Sertifikat

Elemen Certificates menjelaskan kumpulan sertifikat untuk peran web. Elemen ini adalah induk dari Certificate elemen. Peran mungkin memiliki sejumlah sertifikat terkait. Untuk informasi selengkapnya tentang menggunakan elemen sertifikat, lihat Memodifikasi file Definisi Layanan dengan sertifikat.

Sertifikat

Elemen Certificate menjelaskan sertifikat yang terkait dengan peran web.

Tabel berikut ini menjelaskan atribut Certificate elemen.

Atribut	Tipe	Deskripsi
nama	string	Harus diisi. Nama untuk sertifikat ini, yang digunakan untuk merujuknya ketika dikaitkan dengan elemen HTTPS `InputEndpoint` .
storeLocation	string	Harus diisi. Lokasi penyimpanan sertifikat tempat sertifikat ini dapat ditemukan pada komputer lokal. Nilai yang mungkin adalah `CurrentUser` dan `LocalMachine`.
storeName	string	Harus diisi. Nama penyimpanan sertifikat tempat sertifikat ini berada pada komputer lokal. Kemungkinan nilai termasuk nama penyimpanan bawaan `My`, `Root`, `CA`, `Trust`, `Disallowed`, `TrustedPeople`, `TrustedPublisher`, `AuthRoot`, `AddressBook`, atau nama penyimpanan kustom apa pun. Jika nama penyimpanan kustom ditentukan, penyimpanan dibuat secara otomatis.
permissionLevel	string	Opsional. Menentukan izin akses yang diberikan pada proses peran. Jika Anda hanya ingin proses yang ditinggikan untuk dapat mengakses kunci pribadi, lalu tentukan `elevated` izin. `limitedOrElevated` izin memungkinkan semua proses peran untuk mengakses kunci pribadi. Nilai yang mungkin adalah `limitedOrElevated` atau `elevated`. Nilai defaultnya adalah `limitedOrElevated`.

Impor

Elemen Imports menjelaskan kumpulan modul impor untuk peran web yang menambahkan komponen ke sistem operasi tamu. Elemen ini adalah induk dari Import elemen. Elemen ini bersifat opsional dan peran hanya dapat memiliki satu blok impor.

ImportsElemen ini hanya tersedia menggunakan Azure SDK versi 1.3 atau yang lebih tinggi.

Impor

ImportElemen ini menentukan modul untuk ditambahkan ke sistem operasi tamu.

ImportElemen ini hanya tersedia menggunakan Azure SDK versi 1.3 atau yang lebih tinggi.

Tabel berikut ini menjelaskan atribut Import elemen.

Atribut	Tipe	Deskripsi
moduleName	string	Harus diisi. Nama modul yang akan diimpor. Modul impor yang valid adalah: - RemoteAccess - RemoteForwarder - Diagnostik Modul RemoteAccess dan RemoteForwarder memungkinkan Anda mengonfigurasi instans peran untuk koneksi desktop jarak jauh. Untuk informasi selengkapnya, lihat Ekstensi. Modul Diagnostik memungkinkan Anda mengumpulkan data diagnostik untuk instans peran.

Runtime

Elemen Runtime menjelaskan kumpulan pengaturan variabel lingkungan untuk peran web yang mengontrol lingkungan runtime proses host Azure. Elemen ini adalah induk dari Environment elemen. Elemen ini bersifat opsional dan peran hanya dapat memiliki satu blok runtime.

RuntimeElemen ini hanya tersedia menggunakan Azure SDK versi 1.3 atau yang lebih tinggi.

Tabel berikut ini menjelaskan atribut Runtime elemen:

Atribut	Tipe	Deskripsi
executionContext	string	Opsional. Menentukan konteks di mana Proses Peran diluncurkan. Konteks defaultnya adalah `limited`. - `limited` – Proses ini diluncurkan tanpa hak istimewa Administrator. - `elevated` – Proses ini diluncurkan dengan hak istimewa Administrator.

Lingkungan

Elemen Environment menjelaskan kumpulan pengaturan variabel lingkungan untuk peran web. Elemen ini adalah induk dari Variable elemen. Peran mungkin memiliki sejumlah variabel lingkungan yang ditetapkan.

Variabel

VariableElemen menentukan variabel lingkungan yang akan diatur dalam tamu yang beroperasi.

VariableElemen ini hanya tersedia menggunakan Azure SDK versi 1.3 atau yang lebih tinggi.

Tabel berikut ini menjelaskan atribut Variable elemen:

Atribut	Tipe	Deskripsi
nama	string	Harus diisi. Nama variabel lingkungan yang akan ditetapkan.
value	string	Opsional. Nilai yang akan ditetapkan untuk variabel lingkungan. Anda harus menyertakan atribut nilai atau `RoleInstanceValue` elemen.

RoleInstanceValue

RoleInstanceValueElemen menentukan xPath dari mana elemen ini mengambil nilai variabel.

Tabel berikut ini menjelaskan atribut RoleInstanceValue elemen.

Atribut	Tipe	Deskripsi
xpath	string	Opsional. Jalur lokasi pengaturan penyebaran untuk instans. Untuk informasi selengkapnya, lihat Variabel konfigurasi dengan XPath. Anda harus menyertakan atribut nilai atau `RoleInstanceValue` elemen.

EntryPoint

EntryPointElemen menentukan entry point untuk sebuah peran. Elemen ini adalah induk dari NetFxEntryPoint elemen. Elemen-elemen ini memungkinkan Anda untuk menentukan aplikasi selain WaWorkerHost.exe default untuk bertindak sebagai entry point peran.

EntryPointElemen ini hanya tersedia menggunakan Azure SDK versi 1.5 atau yang lebih tinggi.

NetFxEntryPoint

NetFxEntryPointElemen ini menentukan program yang akan dijalankan untuk sebuah peran.

Catatan

NetFxEntryPointElemen ini hanya tersedia menggunakan Azure SDK versi 1.5 atau yang lebih tinggi.

Tabel berikut ini menjelaskan atribut NetFxEntryPoint elemen.

Atribut	Tipe	Deskripsi
assemblyName	string	Harus diisi. Jalur dan nama file perakitan yang berisi entry point. Jalur relatif terhadap folder \%ROLEROOT%\Approot (jangan tentukan \%ROLEROOT%\Approot di baris perintah; diasumsikan). %ROLEROOT% adalah variabel lingkungan yang dikelola oleh Azure dan mewakili lokasi folder root untuk peran Anda. Folder \%ROLEROOT%\Approot mewakili folder aplikasi untuk peran Anda. Untuk peran HWC jalur selalu relatif terhadap folder \%ROLEROOT%\Approot\bin. Untuk peran web IIS dan IIS Express penuh, jika rakitan tidak dapat ditemukan relatif terhadap folder \%ROLEROOT%\Approot , \%ROLEROOT%\Approot\bin dicari. Perilaku mundur ini untuk IIS penuh bukanlah praktik terbaik yang direkomendasikan dan mungkin dihapus dalam versi mendatang.
targetFrameworkVersion	string	Harus diisi. Versi .NET framework tempat perakitan dibangun. Contohnya,`targetFrameworkVersion="v4.0"`.

Situs

Elemen Sites menjelaskan kumpulan situs web dan aplikasi web yang dihost dalam peran web. Elemen ini adalah induk dari Site elemen. Jika Anda tidak menentukan Sites elemen, peran web Anda dihosting sebagai peran web warisan, dan Anda hanya dapat memiliki satu situs web yang dihosting dalam peran web Anda. Elemen ini bersifat opsional dan peran hanya dapat memiliki satu blok situs.

SitesElemen ini hanya tersedia menggunakan Azure SDK versi 1.3 atau yang lebih tinggi.

Situs

Elemen Site menentukan situs web atau aplikasi web yang merupakan bagian dari peran web.

SiteElemen ini hanya tersedia menggunakan Azure SDK versi 1.3 atau yang lebih tinggi.

Tabel berikut ini menjelaskan atribut Site elemen.

Atribut	Tipe	Deskripsi
nama	string	Harus diisi. Nama situs web atau aplikasi.
physicalDirectory	string	Lokasi direktori konten untuk akar situs. Lokasi dapat ditentukan sebagai jalur absolut atau relatif terhadap lokasi csdef.

VirtualApplication

Elemen VirtualApplication mendefinisikan aplikasi di Internet Information Services (IIS) 7 adalah pengelompokan file yang mengirimkan konten atau menyediakan layanan melalui protokol, seperti HTTP. Ketika Anda membuat aplikasi di IIS 7, jalur aplikasi menjadi bagian dari URL situs.

VirtualApplicationElemen ini hanya tersedia menggunakan Azure SDK versi 1.3 atau yang lebih tinggi.

Tabel berikut ini menjelaskan atribut VirtualApplication elemen.

Atribut	Tipe	Deskripsi
nama	string	Harus diisi. Menentukan nama untuk mengidentifikasi aplikasi virtual.
physicalDirectory	string	Harus diisi. Menentukan jalur pada komputer pengembangan yang memuat aplikasi virtual. Di emulator komputasi, IIS dikonfigurasi untuk mengambil konten dari lokasi ini. Saat disebarkan ke Azure, konten direktori fisik dibungkus bersama dengan sisa layanan. Saat paket layanan disebarkan ke Azure, IIS dikonfigurasi dengan lokasi konten yang belum dikemas.

VirtualDirectory

Elemen VirtualDirectory menentukan nama direktori (juga disebut sebagai jalur) yang Anda tentukan dalam IIS dan petakan ke direktori fisik di server lokal atau jarak jauh.

VirtualDirectoryElemen ini hanya tersedia menggunakan Azure SDK versi 1.3 atau yang lebih tinggi.

Tabel berikut ini menjelaskan atribut VirtualDirectory elemen.

Atribut	Tipe	Deskripsi
nama	string	Harus diisi. Menentukan nama untuk mengidentifikasi direktori virtual.
value	physicalDirectory	Harus diisi. Menentukan jalur pada komputer pengembangan yang memuat isi direktori situs web atau Virtual. Di emulator komputasi, IIS dikonfigurasi untuk mengambil konten dari lokasi ini. Saat disebarkan ke Azure, konten direktori fisik dibungkus bersama dengan sisa layanan. Saat paket layanan disebarkan ke Azure, IIS dikonfigurasi dengan lokasi konten yang belum dikemas.

Pengikatan

Elemen Bindings menjelaskan kumpulan pengikatan untuk situs web. Ini adalah elemen induk dari Binding elemen . Elemen diperlukan untuk setiap elemen Site. Untuk informasi selengkapnya tentang mengonfigurasi titik akhir, lihat Mengaktifkan Komunikasi untuk Instans Peran.

BindingsElemen ini hanya tersedia menggunakan Azure SDK versi 1.3 atau yang lebih tinggi.

Pengikatan

Elemen Binding menentukan informasi konfigurasi yang diperlukan agar permintaan dapat berkomunikasi dengan situs web atau aplikasi web.

BindingElemen ini hanya tersedia menggunakan Azure SDK versi 1.3 atau yang lebih tinggi.

Atribut	Tipe	Deskripsi
nama	string	Harus diisi. Menentukan nama untuk mengidentifikasi pengikatan.
endpointName	string	Harus diisi. Menentukan nama titik akhir yang akan mengikat.
hostHeader	string	Opsional. Menentukan nama host yang memungkinkan Anda menghosting beberapa situs, dengan nama host yang berbeda, pada satu kombinasi Alamat IP/Nomor port.

Startup

StartupElemen ini menjelaskan kumpulan tugas yang berjalan saat peran dimulai. Elemen ini dapat menjadi induk Variable elemen. Untuk informasi selengkapnya tentang menggunakan tugas startup peran, lihat Cara mengonfigurasi tugas startup. Elemen ini bersifat opsional dan peran hanya dapat memiliki satu blok startup.

Tabel berikut ini menjelaskan atribut Startup elemen.

Atribut	Tipe	Deskripsi
prioritas	int	Hanya untuk penggunaan internal.

Tugas

TaskElemen menentukan tugas startup yang terjadi saat peran dimulai. Tugas permulaan dapat digunakan untuk melakukan tugas yang menyiapkan peran untuk menjalankan komponen perangkat lunak instalasi tersebut atau menjalankan aplikasi lain. Tugas dijalankan dalam urutan muncul dalam Startup blok elemen.

TaskElemen ini hanya tersedia menggunakan Azure SDK versi 1.3 atau yang lebih tinggi.

Tabel berikut ini menjelaskan atribut Task elemen.

Atribut	Tipe	Deskripsi
commandLine	string	Harus diisi. Skrip, seperti file CMD, yang berisi perintah untuk dijalankan. Perintah startup dan file batch harus disimpan dalam format ANSI. Format file yang mengatur penanda urutan byte di awal proses file salah.
executionContext	string	Menentukan konteks di mana skrip dijalankan. - `limited` [Default] – Jalankan dengan hak istimewa yang sama dengan peran yang menghosting proses. - `elevated` – Jalankan dengan hak istimewa administrator.
taskType	string	Menentukan perilaku eksekusi perintah. - `simple` [Default] – Sistem menunggu tugas keluar sebelum tugas lain diluncurkan. - `background` – Sistem tidak menunggu tugas keluar. - `foreground` – Mirip dengan latar belakang, kecuali peran tidak dimulai ulang sampai semua tugas latar depan keluar.

Konten

Elemen Contents menjelaskan kumpulan sertifikat untuk peran web. Elemen ini adalah induk dari Content elemen.

ContentsElemen ini hanya tersedia menggunakan Azure SDK versi 1.5 atau yang lebih tinggi.

Konten

Elemen Content menentukan lokasi sumber konten yang akan disalin ke komputer virtual Azure dan jalur tujuan yang disalin.

ContentElemen ini hanya tersedia menggunakan Azure SDK versi 1.5 atau yang lebih tinggi.

Tabel berikut ini menjelaskan atribut Content elemen.

Atribut	Tipe	Deskripsi
tujuan	string	Harus diisi. Lokasi di komputer virtual Azure tempat konten ditempatkan. Lokasi ini relatif terhadap folder %ROLEROOT%\Approot.

Elemen ini adalah elemen induk dari SourceDirectory elemen.

SourceDirectory

SourceDirectoryElemen ini mendefinisikan direktori lokal dari mana konten disalin. Gunakan elemen ini untuk menentukan konten lokal untuk disalin ke komputer virtual Azure.

SourceDirectoryElemen ini hanya tersedia menggunakan Azure SDK versi 1.5 atau yang lebih tinggi.

Tabel berikut ini menjelaskan atribut SourceDirectory elemen.

Atribut	Tipe	Deskripsi
jalan	string	Harus diisi. Jalur relatif atau absolut direktori lokal yang kontennya disalin ke komputer virtual Azure. Perluasan variabel lingkungan di jalur direktori didukung.

Langkah berikutnya

Skema Definisi Cloud Services (dukungan diperluas).

Bagikan melalui

Skema WebRole definisi Azure Cloud Services (dukungan diperpanjang)

Skema definisi layanan dasar untuk peran web

Elemen skema

WebRole

ConfigurationSettings

Pengaturan

LocalResources

LocalStorage

Titik akhir

InputEndpoint

InternalEndpoint

InstanceInputEndpoint

AllocatePublicPortFrom

FixedPort

FixedPortRange

Sertifikat

Sertifikat

Impor

Impor

Runtime

Lingkungan

Variabel

RoleInstanceValue

EntryPoint

NetFxEntryPoint

Situs

Situs

VirtualApplication

VirtualDirectory

Pengikatan

Pengikatan

Startup

Tugas

Konten

Konten

SourceDirectory

Langkah berikutnya

Saran dan Komentar

Sumber Daya Tambahan: