Azure Cloud Services (klasik) Tanım WorkerRole Şeması

Önemli

Cloud Services (klasik) artık yeni müşteriler için kullanımdan kaldırılmıştır ve tüm müşteriler için 31 Ağustos 2024'te kullanımdan kaldırılacaktır. Yeni dağıtımlarda yeni Azure Resource Manager tabanlı dağıtım modeli Azure Cloud Services (genişletilmiş destek) kullanılmalıdır.

Azure çalışan rolü, genelleştirilmiş geliştirme için yararlı olan ve bir web rolü için arka plan işleme gerçekleştirebilen bir roldür.

Hizmet tanımı dosyasının varsayılan uzantısı .csdef'tir.

Çalışan rolü için temel hizmet tanımı şeması.

Çalışan rolü içeren hizmet tanımı dosyasının temel biçimi aşağıdaki gibidir.

<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>

Şema Öğeleri

Hizmet tanımı dosyası, bu konunun sonraki bölümlerinde ayrıntılı olarak açıklanan şu öğeleri içerir:

WorkerRole

Configurationsettings

Ayar

LocalResources

Localstorage

Uç Noktalar

InputEndpoint

InternalEndpoint

InstanceInputEndpoint

AllocatePublicPortFrom

FixedPort

FixedPortRange

Sertifikalar

Sertifika

Ithalat

İçeri Aktar

Çalışma Zamanı

Ortam

EntryPoint

NetFxEntryPoint

ProgramEntryPoint

Değişken

RoleInstanceValue

Başlangıç

Görev

İçerik

İçerik

SourceDirectory

WorkerRole

WorkerRole öğesi, genelleştirilmiş geliştirme için yararlı olan ve bir web rolü için arka plan işleme gerçekleştirebilen bir rolü açıklar. Bir hizmet sıfır veya daha fazla çalışan rolü içerebilir.

Aşağıdaki tabloda öğesinin öznitelikleri WorkerRole açıklanmaktadır.

Öznitelik	Tür	Açıklama
name	string	Gereklidir. Çalışan rolünün adı. Rolün adı benzersiz olmalıdır.
enableNativeCodeExecution	boolean	İsteğe bağlı. Varsayılan değer; trueyerel kod yürütme ve tam güven varsayılan olarak etkindir. Çalışan rolü için yerel kod yürütmeyi devre dışı bırakmak için bu özniteliği false olarak ayarlayın ve bunun yerine Azure kısmi güveni kullanın.
vmsize	string	İsteğe bağlı. Bu role ayrılan sanal makinenin boyutunu değiştirmek için bu değeri ayarlayın. Small varsayılan değerdir. Olası sanal makine boyutlarının ve özniteliklerinin listesi için bkz. Cloud Services için Sanal Makine boyutları.

Configurationsettings

ConfigurationSettings öğesi, bir çalışan rolü için yapılandırma ayarlarının koleksiyonunu açıklar. Bu öğe öğenin üst öğesidir Setting .

Ayar

öğesi, Setting bir rolün örneği için yapılandırma ayarını belirten bir ad ve değer çiftini açıklar.

Aşağıdaki tabloda öğesinin öznitelikleri Setting açıklanmaktadır.

Öznitelik	Tür	Açıklama
name	string	Gereklidir. Yapılandırma ayarı için benzersiz bir ad.

Rolün yapılandırma ayarları, hizmet tanımı dosyasında bildirilen ve hizmet yapılandırma dosyasında ayarlanan ad ve değer çiftleridir.

LocalResources

LocalResources öğesi, bir çalışan rolü için yerel depolama kaynaklarının toplanmasını açıklar. Bu öğe öğenin üst öğesidir LocalStorage .

Localstorage

öğesi, LocalStorage çalışma zamanında hizmet için dosya sistemi alanı sağlayan bir yerel depolama kaynağı tanımlar. Bir rol sıfır veya daha fazla yerel depolama kaynağı tanımlayabilir.

Not

öğesi, Azure SDK'nın LocalStorageWorkerRole önceki sürümleriyle uyumluluğu desteklemek için öğesinin alt öğesi olarak görünebilir.

Aşağıdaki tabloda öğesinin öznitelikleri LocalStorage açıklanmaktadır.

Öznitelik	Tür	Açıklama
name	string	Gereklidir. Yerel mağaza için benzersiz bir ad.
cleanOnRoleRecycle	boolean	İsteğe bağlı. Rol yeniden başlatıldığında yerel deponun temizlenip temizlenmeyeceğini gösterir. Varsayılan değer true olarak belirlenmiştir.
sizeInMb	int	İsteğe bağlı. Mb cinsinden yerel depo için ayrılacak istenen depolama alanı miktarı. Belirtilmezse, ayrılan varsayılan depolama alanı 100 MB'tır. Ayrılabilecek en düşük depolama alanı miktarı 1 MB'tır. Yerel kaynakların en büyük boyutu sanal makine boyutuna bağlıdır. Daha fazla bilgi için bkz. Cloud Services için Sanal Makine boyutları.

Yerel depolama kaynağına ayrılan dizinin adı, name özniteliği için sağlanan değere karşılık gelir.

Uç Noktalar

öğesi, Endpoints bir rol için giriş (dış), iç ve örnek giriş uç noktalarının koleksiyonunu açıklar. Bu öğe , InternalEndpointve InstanceInputEndpoint öğelerinin InputEndpointüst öğesidir.

Giriş ve İç uç noktalar ayrı ayrı ayrılır. Bir hizmette izin verilen 25 rol arasında ayrılabilen toplam 25 giriş, iç ve örnek giriş uç noktası olabilir. Örneğin, 5 rol varsa rol başına 5 giriş uç noktası ayırabilir veya tek bir role 25 giriş uç noktası ayırabilir veya her biri 25 role 1 giriş uç noktası ayırabilirsiniz.

Not

Dağıtılan her rol için rol başına bir örnek gerekir. Bir abonelik için varsayılan sağlama 20 çekirdekle sınırlıdır ve bu nedenle bir rolün 20 örneğiyle sınırlıdır. Uygulamanız varsayılan sağlama tarafından sağlanandan daha fazla örnek gerektiriyorsa kotanızı artırma hakkında daha fazla bilgi için bkz. Faturalama, Abonelik Yönetimi ve Kota Desteği .

InputEndpoint

InputEndpoint öğesi, bir çalışan rolü için dış uç noktayı açıklar.

HTTP, HTTPS, UDP ve TCP uç noktalarının birleşimi olan birden çok uç nokta tanımlayabilirsiniz. Giriş uç noktası için seçtiğiniz herhangi bir bağlantı noktası numarasını belirtebilirsiniz, ancak hizmetteki her rol için belirtilen bağlantı noktası numaraları benzersiz olmalıdır. Örneğin, bir rolün HTTP için 80, HTTPS için 443 numaralı bağlantı noktasını kullandığını belirtirseniz, ikinci bir rolün HTTP için 8080 numaralı bağlantı noktasını ve HTTPS için 8043 numaralı bağlantı noktasını kullandığını belirtebilirsiniz.

Aşağıdaki tabloda öğesinin öznitelikleri InputEndpoint açıklanmaktadır.

Öznitelik	Tür	Açıklama
name	string	Gereklidir. Dış uç nokta için benzersiz bir ad.
protokol	string	Gereklidir. Dış uç nokta için aktarım protokolü. Bir çalışan rolü için olası değerler , HTTPS, UDPveya TCP'dırHTTP.
port	int	Gereklidir. Dış uç noktanın bağlantı noktası. Seçtiğiniz herhangi bir bağlantı noktası numarasını belirtebilirsiniz, ancak hizmetteki her rol için belirtilen bağlantı noktası numaraları benzersiz olmalıdır. Olası değerler (Azure SDK sürüm 1.7 veya üzeri) dahil olmak üzere 1 ile 65535 arasında değişir.
sertifika	string	HTTPS uç noktası için gereklidir. Bir öğe tarafından Certificate tanımlanan sertifikanın adı.
localPort	int	İsteğe bağlı. Uç nokta üzerindeki iç bağlantılar için kullanılan bağlantı noktasını belirtir. özniteliği, localPort uç nokta üzerindeki dış bağlantı noktasını bir roldeki iç bağlantı noktasına eşler. Bu, bir rolün dış kullanıma sunulandan farklı bir bağlantı noktasındaki bir iç bileşenle iletişim kurması gereken senaryolarda yararlıdır. Belirtilmezse değeri localPort özniteliğiyle port aynıdır. Çalışma zamanı API'sini localPort kullanarak bulunabilen ayrılmamış bir bağlantı noktasını otomatik olarak atamak için değerini "*" olarak ayarlayın. Olası değerler (Azure SDK sürüm 1.7 veya üzeri) dahil olmak üzere 1 ile 65535 arasında değişir. localPort Özniteliği yalnızca Azure SDK sürüm 1.3 veya üzeri kullanılarak kullanılabilir.
ignoreRoleInstanceStatus	boolean	İsteğe bağlı. Bu özniteliğin değeri olarak trueayarlandığında, bir hizmetin durumu yoksayılır ve uç nokta yük dengeleyici tarafından kaldırılmaz. Bu değeri true bir hizmetin meşgul örneklerinde hata ayıklamak için yararlı olacak şekilde ayarlama. false varsayılan değerdir. Not: Rol Hazır durumda olmasa bile uç nokta trafiği almaya devam edebilir.
loadBalancerProbe	string	İsteğe bağlı. Giriş uç noktasıyla ilişkili yük dengeleyici araştırmasının adı. Daha fazla bilgi için bkz . LoadBalancerProbe Şeması.

InternalEndpoint

InternalEndpoint öğesi, bir çalışan rolü için iç uç noktayı açıklar. İç uç nokta yalnızca hizmet içinde çalışan diğer rol örnekleri tarafından kullanılabilir; hizmet dışındaki istemciler tarafından kullanılamaz. Bir çalışan rolünde en fazla beş HTTP, UDP veya TCP iç uç noktası olabilir.

Aşağıdaki tabloda öğesinin öznitelikleri InternalEndpoint açıklanmaktadır.

Öznitelik	Tür	Açıklama
name	string	Gereklidir. İç uç nokta için benzersiz bir ad.
protokol	string	Gereklidir. İç uç nokta için aktarım protokolü. Olası değerler , TCP, UDPveya ANYdeğerleridirHTTP. değeri ANY , herhangi bir protokolün, herhangi bir bağlantı noktasının izin verildiğini belirtir.
port	int	İsteğe bağlı. Uç noktada iç yük dengeli bağlantılar için kullanılan bağlantı noktası. Yük dengeli uç nokta iki bağlantı noktası kullanır. Genel IP adresi için kullanılan bağlantı noktası ve özel IP adresinde kullanılan bağlantı noktası. Bunlar genellikle aynı şekilde ayarlanır, ancak farklı bağlantı noktaları kullanmayı seçebilirsiniz. Olası değerler (Azure SDK sürüm 1.7 veya üzeri) dahil olmak üzere 1 ile 65535 arasında değişir. Port Özniteliği yalnızca Azure SDK sürüm 1.3 veya üzeri kullanılarak kullanılabilir.

InstanceInputEndpoint

öğesi, InstanceInputEndpoint bir çalışan rolüne örnek giriş uç noktasını açıklar. Örnek giriş uç noktası, yük dengeleyicide bağlantı noktası iletme kullanılarak belirli bir rol örneğiyle ilişkilendirilir. Her örnek giriş uç noktası, bir dizi olası bağlantı noktasından belirli bir bağlantı noktasına eşlenir. Bu öğe öğenin üst öğesidir AllocatePublicPortFrom .

InstanceInputEndpoint öğesi yalnızca Azure SDK sürüm 1.7 veya üzeri kullanılarak kullanılabilir.

Aşağıdaki tabloda öğesinin öznitelikleri InstanceInputEndpoint açıklanmaktadır.

Öznitelik	Tür	Açıklama
name	string	Gereklidir. Uç nokta için benzersiz bir ad.
localPort	int	Gereklidir. Yük dengeleyiciden iletilen trafiği almak için tüm rol örneklerinin dinleyeceği iç bağlantı noktasını belirtir. Olası değerler 1 ile 65535 (dahil) arasında değişir.
protokol	string	Gereklidir. İç uç nokta için aktarım protokolü. Olası değerler: udp veya tcp. http/https tabanlı trafik için kullanın tcp .

AllocatePublicPortFrom

öğesi, AllocatePublicPortFrom dış müşteriler tarafından her örnek giriş uç noktasına erişmek için kullanılabilecek genel bağlantı noktası aralığını açıklar. Genel (VIP) bağlantı noktası numarası bu aralıktan ayrılır ve kiracı dağıtımı ve güncelleştirmesi sırasında her bir rol örneği uç noktasına atanır. Bu öğe öğenin üst öğesidir FixedPortRange .

AllocatePublicPortFrom öğesi yalnızca Azure SDK sürüm 1.7 veya üzeri kullanılarak kullanılabilir.

FixedPort

FixedPort öğesi, uç noktada yük dengeli bağlantıları etkinleştiren iç uç nokta için bağlantı noktasını belirtir.

FixedPort öğesi yalnızca Azure SDK sürüm 1.3 veya üzeri kullanılarak kullanılabilir.

Aşağıdaki tabloda öğesinin öznitelikleri FixedPort açıklanmaktadır.

Öznitelik	Tür	Açıklama
port	int	Gereklidir. İç uç noktanın bağlantı noktası. Bu, min ve max değerlerini aynı bağlantı noktasına ayarlamakla FixedPortRange aynı etkiye sahiptir. Olası değerler (Azure SDK sürüm 1.7 veya üzeri) dahil olmak üzere 1 ile 65535 arasında değişir.

FixedPortRange

FixedPortRange öğesi, iç uç noktaya veya örnek giriş uç noktasına atanan bağlantı noktası aralığını belirtir ve uç noktada yük dengeli bağlantılar için kullanılan bağlantı noktasını ayarlar.

Not

FixedPortRange öğesi, içinde bulunduğu öğeye bağlı olarak farklı çalışır. öğesi öğesinde InternalEndpoint olduğunda, rolün FixedPortRange çalıştığı tüm sanal makineler için en düşük ve en yüksek öznitelik aralığında yük dengeleyici üzerindeki tüm bağlantı noktalarını açar. FixedPortRange öğesi öğesinde InstanceInputEndpoint olduğunda, rolü çalıştıran her sanal makinede min ve max öznitelikleri aralığında yalnızca bir bağlantı noktası açar.

FixedPortRange öğesi yalnızca Azure SDK sürüm 1.3 veya üzeri kullanılarak kullanılabilir.

Aşağıdaki tabloda öğesinin öznitelikleri FixedPortRange açıklanmaktadır.

Öznitelik	Tür	Açıklama
dk	int	Gereklidir. Aralıktaki en düşük bağlantı noktası. Olası değerler (Azure SDK sürüm 1.7 veya üzeri) dahil olmak üzere 1 ile 65535 arasında değişir.
max	string	Gereklidir. Aralıktaki en büyük bağlantı noktası. Olası değerler (Azure SDK sürüm 1.7 veya üzeri) dahil olmak üzere 1 ile 65535 arasında değişir.

Sertifikalar

Certificates öğesi, bir çalışan rolü için sertifika koleksiyonunu açıklar. Bu öğe öğenin üst öğesidir Certificate . Bir rolün herhangi bir sayıda ilişkili sertifikası olabilir. certificates öğesini kullanma hakkında daha fazla bilgi için bkz. Hizmet Tanımı dosyasını bir sertifikayla değiştirme.

Sertifika

Certificate öğesi, bir çalışan rolüyle ilişkili bir sertifikayı açıklar.

Aşağıdaki tabloda öğesinin öznitelikleri Certificate açıklanmaktadır.

Öznitelik	Tür	Açıklama
name	string	Gereklidir. Bir HTTPS InputEndpoint öğesiyle ilişkilendirildiğinde bu sertifikaya başvurmak için kullanılan bu sertifikanın adı.
Storelocation	string	Gereklidir. Bu sertifikanın yerel makinede bulunabileceği sertifika deposunun konumu. Olası değerler ve LocalMachinedeğerleridirCurrentUser.
Storename	string	Gereklidir. Bu sertifikanın yerel makinede bulunduğu sertifika deposunun adı. Olası değerler yerleşik depo adları My, , Root, CA, Trust, , DisallowedTrustedPeople, TrustedPublisher, AuthRootAddressBookveya herhangi bir özel depo adıdır. Özel bir mağaza adı belirtilirse, mağaza otomatik olarak oluşturulur.
permissionLevel	string	İsteğe bağlı. Rol işlemlerine verilen erişim izinlerini belirtir. Yalnızca yükseltilmiş işlemlerin özel anahtara erişebilmesini istiyorsanız, izni belirtin elevated . limitedOrElevated izni, tüm rol işlemlerinin özel anahtara erişmesine izin verir. Olası değerler: limitedOrElevated veya elevated. limitedOrElevated varsayılan değerdir.

Ithalat

öğesi, Imports konuk işletim sistemine bileşen ekleyen bir çalışan rolü için içeri aktarma modülleri koleksiyonunu açıklar. Bu öğe öğenin üst öğesidir Import . Bu öğe isteğe bağlıdır ve bir rol yalnızca bir çalışma zamanı bloğuna sahip olabilir.

Imports öğesi yalnızca Azure SDK sürüm 1.3 veya üzeri kullanılarak kullanılabilir.

İçeri Aktar

Import öğesi konuk işletim sistemine eklenecek modülü belirtir.

Import öğesi yalnızca Azure SDK sürüm 1.3 veya üzeri kullanılarak kullanılabilir.

Aşağıdaki tabloda öğesinin öznitelikleri Import açıklanmaktadır.

Öznitelik	Tür	Açıklama
Modulename	string	Gereklidir. İçeri aktaracak modülün adı. Geçerli içeri aktarma modülleri şunlardır: -Remoteaccess - RemoteForwarder -Tanılama RemoteAccess ve RemoteForwarder modülleri, rol örneğinizi uzak masaüstü bağlantıları için yapılandırmanıza olanak tanır. Daha fazla bilgi için bkz. Uzak Masaüstü Bağlantısını Etkinleştirme. Tanılama modülü, bir rol örneği için tanılama verileri toplamanıza olanak tanır

Çalışma Zamanı

öğesi, Runtime Azure konak işleminin çalışma zamanı ortamını denetleen bir çalışan rolü için ortam değişkeni ayarları koleksiyonunu açıklar. Bu öğe öğenin üst öğesidir Environment . Bu öğe isteğe bağlıdır ve bir rol yalnızca bir çalışma zamanı bloğuna sahip olabilir.

Runtime öğesi yalnızca Azure SDK sürüm 1.3 veya üzeri kullanılarak kullanılabilir.

Aşağıdaki tabloda öğesinin öznitelikleri Runtime açıklanmaktadır:

Öznitelik	Tür	Açıklama
Executioncontext	string	İsteğe bağlı. Rol İşleminin başlatıldığı bağlamı belirtir. Varsayılan bağlam şudur: limited. - limited – İşlem Yönetici ayrıcalıkları olmadan başlatılır. - elevated – İşlem Yönetici ayrıcalıklarıyla başlatılır.

Ortam

Environment öğesi, bir çalışan rolü için ortam değişkeni ayarları koleksiyonunu açıklar. Bu öğe öğenin üst öğesidir Variable . Bir rolün ayarlanmış çok sayıda ortam değişkeni olabilir.

Değişken

Variable öğesi, konuk işletiminde ayarlanacağı ortam değişkenini belirtir.

Variable öğesi yalnızca Azure SDK sürüm 1.3 veya üzeri kullanılarak kullanılabilir.

Aşağıdaki tabloda öğesinin öznitelikleri Variable açıklanmaktadır:

Öznitelik	Tür	Açıklama
name	string	Gereklidir. Ayarlanacağı ortam değişkeninin adı.
değer	string	İsteğe bağlı. Ortam değişkeni için ayarlanacağı değer. Bir değer özniteliği veya RoleInstanceValue öğesi eklemeniz gerekir.

RoleInstanceValue

öğesi, RoleInstanceValue değişkenin değerinin alındığı xPath'i belirtir.

Aşağıdaki tabloda öğesinin öznitelikleri RoleInstanceValue açıklanmaktadır.

Öznitelik	Tür	Açıklama
Xpath	string	İsteğe bağlı. Örnek için dağıtım ayarlarının konum yolu. Daha fazla bilgi için bkz . XPath ile yapılandırma değişkenleri. Bir değer özniteliği veya RoleInstanceValue öğesi eklemeniz gerekir.

EntryPoint

EntryPoint öğesi bir rol için giriş noktasını belirtir. Bu öğe, öğelerin üst öğesidir NetFxEntryPoint . Bu öğeler, rol giriş noktası olarak görev yapmak için varsayılan WaWorkerHost.exe dışında bir uygulama belirtmenize olanak sağlar.

EntryPoint öğesi yalnızca Azure SDK sürüm 1.5 veya üzeri kullanılarak kullanılabilir.

NetFxEntryPoint

NetFxEntryPoint öğesi, bir rol için çalıştırılacak programı belirtir.

Not

NetFxEntryPoint öğesi yalnızca Azure SDK sürüm 1.5 veya üzeri kullanılarak kullanılabilir.

Aşağıdaki tabloda öğesinin öznitelikleri NetFxEntryPoint açıklanmaktadır.

Öznitelik	Tür	Açıklama
Assemblyname	string	Gereklidir. Giriş noktasını içeren derlemenin yolu ve dosya adı. Yol \%ROLEROOT%\Approot klasörüne göredir (içinde commandLine\%ROLEROOT%\Approot belirtmeyin). %ROLEROOT% Azure tarafından tutulan bir ortam değişkenidir ve rolünüz için kök klasör konumunu temsil eder. \%ROLEROOT%\Approot klasörü, rolünüz için uygulama klasörünü temsil eder.
targetFrameworkVersion	string	Gereklidir. Derlemenin oluşturulduğu .NET çerçevesinin sürümü. Örneğin, targetFrameworkVersion="v4.0".

ProgramEntryPoint

ProgramEntryPoint öğesi, bir rol için çalıştırılacak programı belirtir. öğesi, ProgramEntryPoint .NET derlemesini temel almayan bir program giriş noktası belirtmenize olanak tanır.

Not

ProgramEntryPoint öğesi yalnızca Azure SDK sürüm 1.5 veya üzeri kullanılarak kullanılabilir.

Aşağıdaki tabloda öğesinin öznitelikleri ProgramEntryPoint açıklanmaktadır.

Öznitelik	Tür	Açıklama
Commandline	string	Gereklidir. Yürütülecek programın yolu, dosya adı ve komut satırı bağımsız değişkenleri. Yol % ROLEROOT%\Approot klasörüne göredir (commandLine içinde %ROLEROOT%\Approot belirtmeyin, varsayılır). %ROLEROOT% Azure tarafından tutulan bir ortam değişkenidir ve rolünüz için kök klasör konumunu temsil eder. %ROLEROOT%\Approot klasörü, rolünüz için uygulama klasörünü temsil eder. Program sona ererse rol geri dönüştürülür, bu nedenle genellikle programı yalnızca başlatıp sonlu bir görev çalıştıran bir program olmak yerine çalışmaya devam etmek üzere ayarlayın.
setReadyOnProcessStart	boolean	Gereklidir. Rol örneğinin komut satırı programının başlatılıp başlatılmadığını bildirmesini bekleyip beklemediğini belirtir. Bu değer şu anda olarak true ayarlanmalıdır. değerini false olarak ayarlamak, gelecekte kullanmak üzere ayrılmıştır.

Başlangıç

öğesi, Startup rol başlatıldığında çalışan bir görev koleksiyonunu açıklar. Bu öğe öğenin üst öğesi Variable olabilir. Rol başlangıç görevlerini kullanma hakkında daha fazla bilgi için bkz. Başlangıç görevlerini yapılandırma. Bu öğe isteğe bağlıdır ve bir rolün yalnızca bir başlangıç bloğu olabilir.

Aşağıdaki tabloda öğesinin özniteliği Startup açıklanmaktadır.

Öznitelik	Tür	Açıklama
Öncelik	int	Yalnızca dahili kullanım içindir.

Görev

öğesi, Task rol başlatıldığında gerçekleşen başlangıç görevini belirtir. Başlangıç görevleri, bu tür yazılım bileşenlerini çalıştırmak veya diğer uygulamaları çalıştırmak için rolü hazırlayan görevleri gerçekleştirmek için kullanılabilir. Görevler, öğe bloğu içinde göründükleri Startup sırayla yürütülür.

Task öğesi yalnızca Azure SDK sürüm 1.3 veya üzeri kullanılarak kullanılabilir.

Aşağıdaki tabloda öğesinin öznitelikleri Task açıklanmaktadır.

Öznitelik	Tür	Açıklama
Commandline	string	Gereklidir. Çalıştırılacak komutları içeren CMD dosyası gibi bir betik. Başlangıç komutu ve toplu iş dosyaları ANSI biçiminde kaydedilmelidir. Dosyanın başında bayt sırası işaretçisi ayarlayan dosya biçimleri düzgün işlenmez.
Executioncontext	string	Betiğin çalıştırıldığı bağlamı belirtir. - limited [Varsayılan] – İşlemi barındıran rolle aynı ayrıcalıklarla çalıştırın. - elevated – Yönetici ayrıcalıklarıyla çalıştırın.
Tasktype	string	komutunun yürütme davranışını belirtir. - simple [Varsayılan] – Sistem, diğer görevler başlatılmadan önce görevin çıkmasını bekler. - background – Sistem, görevin çıkmasını beklemez. - foreground – Arka plana benzer, ancak tüm ön plan görevleri çıkana kadar rol yeniden başlatılmaz.

İçindekiler

Contents öğesi, bir çalışan rolü için içerik koleksiyonunu açıklar. Bu öğe öğenin üst öğesidir Content .

Contents öğesi yalnızca Azure SDK sürüm 1.5 veya üzeri kullanılarak kullanılabilir.

Content

öğesi, Content Azure sanal makinesine kopyalanacak içeriğin kaynak konumunu ve kopyalandığı hedef yolu tanımlar.

Content öğesi yalnızca Azure SDK sürüm 1.5 veya üzeri kullanılarak kullanılabilir.

Aşağıdaki tabloda öğesinin öznitelikleri Content açıklanmaktadır.

Öznitelik	Tür	Açıklama
hedef	string	Gereklidir. Azure sanal makinesinde içeriğin yerleştirildiği konum. Bu konum %ROLEROOT%\Approot klasörüne göredir.

Bu öğe, öğesinin üst öğesidir SourceDirectory .

SourceDirectory

SourceDirectory öğesi, içeriğin kopyalandığı yerel dizini tanımlar. Azure sanal makinesine kopyalanacak yerel içeriği belirtmek için bu öğeyi kullanın.

SourceDirectory öğesi yalnızca Azure SDK sürüm 1.5 veya üzeri kullanılarak kullanılabilir.

Aşağıdaki tabloda öğesinin öznitelikleri SourceDirectory açıklanmaktadır.

Öznitelik	Tür	Açıklama
path	string	Gereklidir. İçeriği Azure sanal makinesine kopyalanacak yerel dizinin göreli veya mutlak yolu. Dizin yolundaki ortam değişkenlerinin genişletilmesi desteklenir.

Ayrıca Bkz.

Bulut Hizmeti (klasik) Tanım Şeması