Azure Cloud Services (genişletilmiş destek) tanımı WebRole şeması

Azure web rolü, ASP.NET, PHP, Windows Communication Foundation ve FastCGI gibi IIS 7 tarafından desteklenen web uygulaması programlaması için özelleştirilmiş bir roldür.

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

Web rolü için temel hizmet tanımı şeması

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

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

Şema öğeleri

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

WebRole

Yapılandırma Ayarlar

Ayar

LocalResources

Yerel Depolama

Uç Noktalar

InternalEndpoint

InstanceInputEndpoint

AllocatePublicPortFrom

Sabit Bağlantı Noktası

FixedPortRange

Sertifikalar

Sertifika

Ithalat

İçeri Aktar

Çalışma Zamanı

Ortam

Değişken

RoleInstanceValue

NetFxEntryPoint

Site

Tesis

VirtualApplication

VirtualApplication

Bağlamalar

Bağlama

Startup

Görev

İçerik

İçerik

SourceDirectory

WebRole

WebRole öğesi, IIS 7 ve ASP.NET tarafından desteklenen web uygulaması programlaması için özelleştirilmiş bir rolü açıklar. Bir hizmet sıfır veya daha fazla web rolü içerebilir.

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

Öznitelik	Türü	Tanım
name	Dize	Gerekli. Web rolünün adı. Rolün adı benzersiz olmalıdır.
enableNativeCodeExecution	boolean	isteğe bağlı. Varsayılan değerdir true; yerel kod yürütme ve tam güven varsayılan olarak etkinleştirilir. Web 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	Dize	isteğe bağlı. Role ayrılan sanal makinenin boyutunu değiştirmek için bu değeri ayarlayın. Small varsayılan değerdir. Daha fazla bilgi için bkz . Cloud Services için Sanal Makine boyutları.

Yapılandırma Ayarlar

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

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ü	Tanım
name	Dize	Gerekli. Yapılandırma ayarı için benzersiz bir ad.

Bir 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

öğesi, LocalResources bir web rolü için yerel depolama kaynaklarının koleksiyonunu açıklar. Bu öğe, öğesinin LocalStorage üst öğesidir.

Yerel Depolama

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

Dekont

öğesi, Azure SDK'nın LocalStorage WebRole ö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ü	Tanım
name	Dize	Gerekli. Yerel mağaza için benzersiz bir ad.
cleanOnRoleRecycle	boolean	isteğ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	isteğ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.

Dekont

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

öğesi, InputEndpoint bir web 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 web rolünün HTTP için 80, HTTPS için 443 numaralı bağlantı noktasını kullandığını belirtirseniz, ikinci bir web rolünü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ü	Tanım
name	Dize	Gerekli. Dış uç nokta için benzersiz bir ad.
Protokolü	Dize	Gerekli. Dış uç nokta için aktarım protokolü. Bir web rolü için olası değerler , , HTTPSUDPveya TCPşeklindedirHTTP.
port	int	Gerekli. 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 1 ile 65535 (azure SDK sürüm 1.7 veya üzeri) arasında değişir.
sertifika	Dize	HTTPS uç noktası için gereklidir. Bir öğe tarafından tanımlanan sertifikanın Certificate adı.
localPort	int	isteğe bağlı. Uç nokta üzerindeki iç bağlantılar için kullanılan bir bağlantı noktasını belirtir. özniteliği, localPort uç nokta üzerindeki dış bağlantı noktasını bir roldeki iç bağlantı noktasıyla 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 kullanışlı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 1 ile 65535 (azure SDK sürüm 1.7 veya üzeri) 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	isteğe bağlı. Bu özniteliğin değeri olarak trueayarlandığında hizmetin durumu yoksayılır ve uç nokta yük dengeleyici tarafından kaldırılmaz. Bir hizmetin meşgul örneklerinde hata ayıklamak için bu değeri true yararlı olacak şekilde ayarlayın. false varsayılan değerdir. Not: Rol Hazır durumda olmasa bile uç nokta trafiği almaya devam edebilir.
loadBalancerProbe	Dize	isteğe bağlı. Giriş uç noktasıyla ilişkili yük dengeleyici yoklaması adı. Daha fazla bilgi için bkz . LoadBalancerProbe Şeması.

InternalEndpoint

öğesi, InternalEndpoint bir web 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. öğesini içermeyen Sites web rolleri yalnızca tek bir HTTP, UDP veya TCP iç uç noktasına sahip olabilir.

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

Öznitelik	Türü	Tanım
name	Dize	Gerekli. İç uç nokta için benzersiz bir ad.
Protokolü	Dize	Gerekli. İç uç nokta için aktarım protokolü. Olası değerler HTTP: , TCP, UDPveya ANY. değeri ANY , herhangi bir protokole, herhangi bir bağlantı noktasına izin verildiğini belirtir.
port	int	isteğe bağlı. Uç nokta üzerindeki 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 1 ile 65535 (azure SDK sürüm 1.7 veya üzeri) 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 web 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, öğesinin AllocatePublicPortFrom üst öğesidir.

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ü	Tanım
name	Dize	Gerekli. Uç nokta için benzersiz bir ad.
localPort	int	Gerekli. Yük dengeleyiciden iletilen gelen 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ü	Dize	Gerekli. İç 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, öğesinin FixedPortRange üst öğesidir.

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

Sabit Bağlantı Noktası

FixedPort öğesi, iç uç noktanın bağlantı noktasını belirtir ve bu da uç noktada yük dengeli bağlantıları etkinleştirir.

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ü	Tanım
port	int	Gerekli. İç 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 1 ile 65535 (azure SDK sürüm 1.7 veya üzeri) arasında değişir.

FixedPortRange

öğesi, FixedPortRange 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.

Dekont

öğesi, FixedPortRange içinde bulunduğu öğeye bağlı olarak farklı çalışır. öğesi öğesinde olduğunda, rolün FixedPortRange InternalEndpoint çalıştığı tüm sanal makineler için en düşük ve en yüksek öznitelik aralığındaki yük dengeleyicideki 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ü	Tanım
min	int	Gerekli. Aralıktaki en düşük bağlantı noktası. Olası değerler 1 ile 65535 (azure SDK sürüm 1.7 veya üzeri) arasında değişir.
max	Dize	Gerekli. Aralıktaki en yüksek bağlantı noktası. Olası değerler 1 ile 65535 (azure SDK sürüm 1.7 veya üzeri) arasında değişir.

Sertifikalar

öğesi, Certificates bir web rolü için sertifika koleksiyonunu açıklar. Bu öğe, öğesinin Certificate üst öğesidir. 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

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

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

Öznitelik	Türü	Tanım
name	Dize	Gerekli. Bir HTTPS InputEndpoint öğesiyle ilişkilendirildiğinde bu sertifikaya başvurmak için kullanılan bu sertifikanın adı.
Storelocation	Dize	Gerekli. Bu sertifikanın yerel makinede bulunabileceği sertifika deposunun konumu. Olası değerler ve LocalMachineşeklindedirCurrentUser.
Storename	Dize	Gerekli. Bu sertifikanın yerel makinede bulunduğu sertifika deposunun adı. Olası değerler yerleşik depo adları My, , Root, CA, Trust, , Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, , AddressBookveya herhangi bir özel depo adıdır. Özel bir mağaza adı belirtilirse, mağaza otomatik olarak oluşturulur.
permissionLevel	Dize	isteğe bağlı. Rol işlemlerine verilen erişim izinlerini belirtir. Yalnızca yükseltilmiş işlemlerin özel anahtara erişebilmesini istiyorsanız, izin belirtin elevated . limitedOrElevated izni, tüm rol işlemlerinin özel anahtara erişmesini sağlar. Olası değerler: limitedOrElevated veya elevated. limitedOrElevated varsayılan değerdir.

İçeri aktarmalar

öğesi, Imports konuk işletim sistemine bileşen ekleyen bir web rolü için içeri aktarma modülleri koleksiyonunu açıklar. Bu öğe, öğesinin Import üst öğesidir. Bu öğe isteğe bağlıdır ve bir rolün yalnızca bir içeri aktarma bloğu olabilir.

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

İçe aktar

öğesi, Import 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ü	Tanım
Modulename	Dize	Gerekli. İç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 . Uzantılar. 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 web rolü için ortam değişkeni ayarları koleksiyonunu açıklar. Bu öğe, öğesinin Environment üst öğesidir. Bu öğe isteğe bağlıdır ve bir rolün yalnızca bir çalışma zamanı bloğu 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ü	Tanım
Executioncontext	Dize	isteğe bağlı. Rol İşleminin başlatıldığı bağlamı belirtir. Varsayılan bağlamdır limited. - limited– İşlem, Yönetici istrator ayrıcalıkları olmadan başlatılır. - elevated– İşlem Yönetici istrator ayrıcalıklarıyla başlatılır.

Ortam

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

Değişken

öğesi, Variable 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ü	Tanım
name	Dize	Gerekli. Ayarlanacağı ortam değişkeninin adı.
value	Dize	isteğ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ü	Tanım
Xpath	Dize	isteğ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ün 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

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

Dekont

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ü	Tanım
Assemblyname	Dize	Gerekli. Giriş noktasını içeren derlemenin yolu ve dosya adı. Yol \%ROLEROOT%\Approot klasörüne göredir (içinde commandLine\%ROLEROOT%\Approot belirtmeyin) olduğu 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. HWC rolleri için yol her zaman \%ROLEROOT%\Approot\bin klasörüne göredir. Tam IIS ve IIS Express web rolleri için, derleme \%ROLEROOT%\Approot klasörüne göre bulunamazsa, \%ROLEROOT%\Approot\bin aranılır. Tam IIS için bu geri dönüş davranışı önerilen en iyi yöntem değildir ve gelecekteki sürümlerde kaldırılabilir.
targetFrameworkVersion	Dize	Gerekli. Derlemenin oluşturulduğu .NET framework sürümü. Örneğin, targetFrameworkVersion="v4.0".

Siteler

öğesi, Sites bir web rolünde barındırılan web siteleri ve web uygulamaları koleksiyonunu açıklar. Bu öğe, öğesinin Site üst öğesidir. Bir Sites öğe belirtmezseniz, web rolünüz eski web rolü olarak barındırılır ve web rolünüzde yalnızca bir web sitesi barındırabilirsiniz. Bu öğe isteğe bağlıdır ve bir rolün yalnızca bir site bloğu olabilir.

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

Tesis

öğesi, Site web rolünün parçası olan bir web sitesini veya web uygulamasını belirtir.

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

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

Öznitelik	Türü	Tanım
name	Dize	Gerekli. Web sitesinin veya uygulamanın adı.
physicalDirectory	Dize	Site kökü için içerik dizininin konumu. Konum, mutlak bir yol olarak veya csdef konumuna göre belirtilebilir.

VirtualApplication

VirtualApplication öğesi, Internet Information Services (IIS) 7'deki bir uygulamayı tanımlar; içerik teslim eden veya HTTP gibi protokoller üzerinden hizmet sağlayan bir dosya grubudur. IIS 7'de bir uygulama oluşturduğunuzda, uygulamanın yolu sitenin URL'sinin bir parçası olur.

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

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

Öznitelik	Türü	Tanım
name	Dize	Gerekli. Sanal uygulamayı tanımlamak için bir ad belirtir.
physicalDirectory	Dize	Gerekli. Sanal uygulamayı içeren geliştirme makinesindeki yolu belirtir. İşlem öykünücüsunda IIS, bu konumdan içerik alacak şekilde yapılandırılır. Azure'a dağıtılırken, fiziksel dizinin içeriği hizmetin geri kalanıyla birlikte paketlenir. Hizmet paketi Azure'a dağıtıldığında IIS, paketlenmemiş içeriğin konumuyla yapılandırılır.

Virtualdirectory

öğesi, IIS'de VirtualDirectory belirttiğiniz ve yerel veya uzak sunucudaki bir fiziksel dizinle eşlediğiniz bir dizin adı (yol olarak da adlandırılır) belirtir.

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

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

Öznitelik	Türü	Tanım
name	Dize	Gerekli. Sanal dizini tanımlamak için bir ad belirtir.
value	physicalDirectory	Gerekli. Web sitesi veya Sanal dizin içeriğini içeren geliştirme makinesindeki yolu belirtir. İşlem öykünücüsunda IIS, bu konumdan içerik alacak şekilde yapılandırılır. Azure'a dağıtılırken, fiziksel dizinin içeriği hizmetin geri kalanıyla birlikte paketlenir. Hizmet paketi Azure'a dağıtıldığında IIS, paketlenmemiş içeriğin konumuyla yapılandırılır.

Bağlamalar

öğesi, Bindings bir web sitesi için bağlama koleksiyonunu açıklar. Öğesinin üst öğesidir Binding . öğesi her Site öğe için gereklidir. Uç noktaları yapılandırma hakkında daha fazla bilgi için bkz . Rol Örnekleri için İletişimi Etkinleştirme.

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

Bağlama

öğesi, Binding bir web sitesi veya web uygulamasıyla iletişim kurma istekleri için gereken yapılandırma bilgilerini belirtir.

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

Öznitelik	Türü	Tanım
name	Dize	Gerekli. Bağlamayı tanımlamak için bir ad belirtir.
endpointName	Dize	Gerekli. Bağlanacak uç nokta adını belirtir.
hostHeader	Dize	isteğe bağlı. Tek bir IP Adresi/Bağlantı noktası numarası bileşiminde farklı ana bilgisayar adlarına sahip birden çok siteyi barındırmanıza olanak tanıyan bir konak adı belirtir.

Başlangıç

öğesi, Startup rol başlatıldığında çalışan bir görev koleksiyonunu açıklar. Bu öğe öğenin üst Variable öğesi 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ü	Tanım
Ö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 yükleme 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ü	Tanım
Commandline	Dize	Gerekli. Ç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	Dize	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	Dize	Komutun 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

öğesi, Contents bir web rolü için içerik koleksiyonunu açıklar. Bu öğe, öğesinin Content üst öğesidir.

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

İçerik

öğ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ü	Tanım
destination	Dize	Gerekli. İçeriğin yerleştirildiği Azure sanal makinesindeki konum. Bu konum %ROLEROOT%\Approot klasörüne göredir.

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

SourceDirectory

öğesi, SourceDirectory 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ü	Tanım
yol	Dize	Gerekli. İçeriği Azure sanal makinesine kopyalanacak yerel dizinin göreli veya mutlak yolu. Dizin yolunda ortam değişkenlerinin genişletilmesi desteklenir.

Ayrıca bkz.

Bulut Hizmeti (genişletilmiş destek) Tanım Şeması.