Azure 雲端服務 (傳統) 設定結構描述 (.cscfg 檔)
重要
截至 2024 年 9 月 1 日，所有客戶的雲端服務 (傳統) 均已淘汰。 從 2024 年 10 月開始，任何現有的執行中部署都會停止並關閉Microsoft，且數據將會永久遺失。 新部署應該使用 Azure Resource Manager 型的新部署模型 Azure 雲端服務 (延伸支援)。
服務組態檔會指定要為服務中每個角色部署的角色執行個體數目、任何組態設定的值，以及與角色相關聯之任何憑證的指紋。 如果服務是虛擬網路的一部分，則必須在服務設定檔以及虛擬網路設定檔中提供網路的設定資訊。 服務組態檔的預設副檔名為 .cscfg。
雲端服務 (傳統) 定義結構描述會描述服務模型。
根據預設，Azure 診斷組態結構描述檔案是安裝於 C:\Program Files\Microsoft SDKs\Windows Azure\.NET SDK\<version>\schemas 目錄中。 請使用安裝的 Azure SDK 版本來取代 <version>。
如需有關在服務中設定角色的詳細資訊，請參閱什麼是雲端服務模型。
基本服務組態結構描述
服務組態檔的基本格式如下所示。
<ServiceConfiguration serviceName="<service-name>" osFamily="<osfamily-number>" osVersion="<os-version>" schemaVersion="<schema-version>">
<Role …>
…
</Role>
<NetworkConfiguration>
…
</NetworkConfiguration>
</ServiceConfiguration>
結構描述定義
下列主題說明 ServiceConfiguration 元素的結構描述：
服務組態命名空間
適用於服務組態檔的 XML 命名空間如下：http://schemas.microsoft.com/ServiceHosting/2008/10/ServiceConfiguration。
ServiceConfiguration 元素
ServiceConfiguration 元素是服務組態檔的最上層元素。
下表說明 ServiceConfiguration 元素的屬性。 所有屬性值是字串類型。
| 屬性 | 描述 |
|---|---|
| serviceName | 必要。 雲端服務的名稱。 這裡指定的名稱必須符合在服務定義檔中指定的名稱。 |
| osFamily | 選擇性。 指定在雲端服務中角色執行個體上執行的客體作業系統。 如需支援之客體 OS 版本的詳細資訊，請參閱 Azure 客體 OS 版本與 SDK 相容性比較表。 如果您未包括 osFamily 值，且未將 osVersion 屬性設定為特定客體作業系統版本，則會使用預設值 1。 |
| osVersion | 選擇性。 指定在雲端服務中角色執行個體上執行的客體作業系統版本。 如需客體 OS 版本的詳細資訊，請參閱 Azure 客體 OS 版本與 SDK 相容性比較表。 您可以指定客體 OS 應自動升級為最新版本。 若要這樣做，請將 osVersion 屬性的值設定為 *。 當設定為 * 時，會使用指定作業系統系列的最新版本客體作業系統來部署角色執行個體，並會在新版本的客體作業系統發行時自動升級。若要手動指定特定版本，請使用 Configuration String，位於 Azure 客體作業系統版本與 SDK 相容性比較表的未來、目前和轉換客體作業系統版本區段的資料表中。osVersion 屬性的預設值為 *。 |
| schemaVersion | 選擇性。 指定服務組態結構描述的版本。 如果已並行安裝一個以上的 SDK 版本，結構描述版本就可讓 Visual Studio 選取要用於結構描述驗證的正確 SDK 工具。 如需結構描述和版本相容性的詳細資訊，請參閱 Azure 客體 OS 版本與 SDK 相容性比較表 |
服務組態檔必須包含一個 ServiceConfiguration 元素。 ServiceConfiguration 元素可能包含任意數目的 Role 元素，以及零或 1 個 NetworkConfiguration 元素。