Bagikan melalui


Azure Cloud Services (dukungan diperpanjang) definisi Skema WorkerRole

Peran pekerja Azure adalah peran yang berguna untuk pengembangan umum, dan dapat melakukan pemrosesan latar belakang untuk peran web.

Ekstensi default untuk file definisi layanan ini adalah csdef.

Skema definisi layanan dasar untuk peran pekerja.

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

<ServiceDefinition …>
  <WorkerRole name="<worker-role-name>" vmsize="<worker-role-size>" enableNativeCodeExecution="[true|false]">
    <Certificates>
      <Certificate name="<certificate-name>" storeLocation="[CurrentUser|LocalMachine]" storeName="[My|Root|CA|Trust|Disallow|TrustedPeople|TrustedPublisher|AuthRoot|AddressBook|<custom-store>" />
    </Certificates>
    <ConfigurationSettings>
      <Setting name="<setting-name>" />
    </ConfigurationSettings>
    <Endpoints>
      <InputEndpoint name="<input-endpoint-name>" protocol="[http|https|tcp|udp]" localPort="<local-port-number>" port="<port-number>" certificate="<certificate-name>" 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>
    <Imports>
      <Import moduleName="[RemoteAccess|RemoteForwarder|Diagnostics]"/>
    </Imports>
    <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>"/>
         <ProgramEntryPoint commandLine="<application>" setReadyOnProcessStart="[true|false]"/>
      </EntryPoint>
    </Runtime>
    <Startup priority="<for-internal-use-only>">
      <Task commandLine="" 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>
  </WorkerRole>
</ServiceDefinition>

Elemen skema

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

WorkerRole

ConfigurationSettings

Pengaturan

LocalResources

LocalStorage

Titik Akhir

InputEndpoint

InternalEndpoint

InstanceInputEndpoint

AllocatePublicPortFrom

FixedPort

FixedPortRange

Sertifikat

Sertifikat

Impor

Impor

Runtime

Lingkungan

EntryPoint

NetFxEntryPoint

ProgramEntryPoint

Variabel

RoleInstanceValue

Startup

Tugas

Konten

Konten

SourceDirectory

WorkerRole

WorkerRoleElemen ini menjelaskan peran yang berguna untuk pengembangan umum, dan dapat melakukan pemrosesan latar belakang untuk peran web. Layanan mungkin berisi nol atau lebih peran pekerja.

Tabel berikut ini menjelaskan atribut WorkerRole elemen.

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

ConfigurationSettings

ConfigurationSettingsElemen ini menjelaskan pengumpulan pengaturan konfigurasi untuk peran pekerja. 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

LocalResourcesElemen ini menjelaskan pengumpulan sumber daya penyimpanan lokal untuk peran pekerja. 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 WorkerRole 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

InputEndpointElemen ini menjelaskan titik akhir eksternal untuk peran pekerja.

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 menggunakan port 80 untuk HTTP dan port 443 untuk HTTPS, Anda kemudian dapat menentukan bahwa peran 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 pekerja, nilai yang mungkin 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. localPortAtribut 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 localPortsama 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).

localPortAtribut 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 titik akhir tidak akan dihapus oleh load balancer. 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

InternalEndpointElemen ini menjelaskan titik akhir internal untuk peran pekerja. Titik akhir internal hanya tersedia untuk instans peran lain yang berjalan dalam layanan; tidak tersedia untuk klien di luar layanan. Peran pekerja mungkin memiliki hingga lima 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).

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

InstanceInputEndpoint

InstanceInputEndpointElemen ini menjelaskan titik akhir input instans ke peran pekerja. 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

CertificatesElemen ini menjelaskan pengumpulan sertifikat untuk peran pekerja. 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

CertificateElemen ini menjelaskan sertifikat yang terkait dengan peran pekerja.

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

ImportsElemen ini menjelaskan kumpulan modul impor untuk peran pekerja 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 runtime.

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

RuntimeElemen ini menjelaskan kumpulan pengaturan variabel lingkungan untuk peran pekerja 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

EnvironmentElemen ini menjelaskan kumpulan pengaturan variabel lingkungan untuk peran pekerja. 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.
targetFrameworkVersion string Harus diisi. Versi .NET framework tempat perakitan dibangun. Contohnya,targetFrameworkVersion="v4.0".

ProgramEntryPoint

ProgramEntryPointElemen ini menentukan program yang akan dijalankan untuk sebuah peran. Elemen ini ProgramEntryPoint memungkinkan Anda menentukan titik masuk program yang tidak didasarkan pada rakitan .NET.

Catatan

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

Tabel berikut ini menjelaskan atribut ProgramEntryPoint elemen.

Atribut Tipe Deskripsi
commandLine string Harus diisi. Jalur, nama file, dan argumen baris perintah program untuk dijalankan. 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.

Jika program berakhir, peran didaur ulang, jadi umumnya mengatur program untuk terus berjalan, alih-alih menjadi program yang baru memulai dan menjalankan tugas terbatas.
setReadyOnProcessStart Boolean Harus diisi. Menentukan apakah instans peran menunggu program baris perintah memberi sinyal saat dimulai. Nilai ini harus disetel true saat ini. Mengatur nilai yang false dicadangkan untuk digunakan di masa mendatang.

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

ContentsElemen ini menjelaskan pengumpulan konten untuk peran pekerja. 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.

Lihat juga

Skema Definisi Cloud Services (dukungan diperluas).