匯出 (0) 列印
全部展開

Windows Azure 服務定義結構描述 (.csdef 檔)

更新日期: 2014年2月

服務定義檔可定義應用程式的服務模型。該檔案包含雲端服務所能使用的角色定義、指定服務端點和建立服務的組態設定。如 Windows Azure 服務組態結構描述 (.cscfg 檔) 所述,組態設定值是在服務組態檔中設定。

根據預設,Windows Azure 診斷組態結構描述檔案會安裝在 C:\Program Files\Microsoft SDKs\Windows Azure\.NET SDK\<version>\schemas 目錄。將 <version> 取代為 Windows Azure SDK 的安裝版本。

服務定義檔的預設副檔名為 .csdef。

服務定義檔必須包含一個 ServiceDefinition 元素。服務定義至少需包含一個角色 (WebRoleWorkerRole) 元素。每次定義最多可以包含 25 個角色定義,且您可以混合角色類型。服務定義也包含選擇性 NetworkTrafficRules 元素,可限制能與指定的內部端點通訊的角色。服務定義也包含選擇性 LoadBalancerProbes 元素,其內含客戶定義的端點健全狀態探查。

服務定義檔的基本格式如下。


<ServiceDefinition name="<service-name>" topologyChangeDiscovery="<change-type>" xmlns=”http://schemas.microsoft.com/ServiceHosting/2008/10/ServiceDefinition” upgradeDomainCount="<number-of-upgrade-domains>" schemaVersion=”<version>”>

  <LoadBalancerProbes>
         …
  </LoadBalancerProbes>

  <WebRole …>
         …
  </WebRole>

  <WorkerRole …>
         …
  </WorkerRole>
 
  <NetworkTrafficRules>
         …
  </NetworkTrafficRules>
</ServiceDefinition>

ServiceDefinition 元素是服務定義檔的最上層元素。

下表描述 ServiceDefinition 元素的屬性。

 

屬性 描述

name

必要項。服務的名稱。此名稱在服務帳戶中必須是唯一的。

topologyChangeDiscovery

選擇性。指定拓撲變更通知的類型。可能的值為:

  • Blast - 盡快將更新傳送給所有角色執行個體。如果選擇此選項,角色應該要不必重新啟動就能夠處理拓撲更新。

  • UpgradeDomainWalk – 以循序方式在前一個執行個體已成功接受更新之後,將更新傳送給每個角色執行個體。

schemaVersion

選擇性。指定服務定義結構描述的版本。如果已並存安裝多個 SDK 版本,則結構描述版本可讓 Visual Studio 選擇正確的 SDK 工具,以驗證結構描述。

upgradeDomainCount

選擇性。指定此服務中的角色所要配置的升級網域數目。部署服務時,會將角色執行個體配置給升級網域。如需詳細資訊,請參閱如何:更新雲端服務角色或部署

您最多可以指定 20 個升級網域。如果沒有指定,預設的升級網域數目是 5。

顯示:
© 2014 Microsoft