Compartilhar via

Azure 云服务（外延支持）定义架构（csdef 文件）

重要

自 2025 年 3 月 31 日起，云服务（外延支持）被弃用，将于 2027 年 3 月 31 日完全停用。 详细了解此弃用以及如何迁移。

服务定义文件定义应用程序的服务模型。 该文件包含可供云服务使用的角色的定义，它可指定服务终结点并建立服务的配置设置。 配置设置值是在服务配置文件中设置的，如云服务（外延支持）配置架构中所述。

默认情况下，Azure 诊断配置架构文件将安装到 C:\Program Files\Microsoft SDKs\Azure\.NET SDK\<version>\schemas 目录。 将 <version> 替换为 Azure SDK 的已安装版本。

服务定义文件的默认扩展名为 csdef。

基本服务定义架构

服务定义文件必须包含一个 ServiceDefinition 元素。 服务定义必须包含至少一个角色（WebRole 或 WorkerRole）元素。 它可以包含在单个定义中定义的最多 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 元素是服务定义文件的顶层元素。

下表介绍了 ServiceDefinition 元素的属性。

特征 描述
姓名 必需。 服务的名称。 该名称在服务帐户中必须是唯一的。
拓扑变化发现 可选。 指定拓扑更改通知的类型。 可能的值包括：

- Blast - 将更新尽早发送到所有角色实例。 如果选择此选项，则角色应该能够在不重启的情况下处理拓扑更新。
- UpgradeDomainWalk - 在前一个实例成功接受更新后，按顺序将更新发送到每个角色实例。
schemaVersion 可选。 指定服务定义架构的版本。 如果并行安装多个版本的 SDK，架构版本允许 Visual Studio 选择正确的 SDK 工具用于架构验证。
升级域计数 可选。 指定在其中分配了此服务中的角色的升级域的数目。 在部署服务时会将角色实例分配到升级域。 有关详细信息，请参阅更新云服务角色或部署和管理虚拟机的可用性。最多可指定 20 个升级域。 如果未指定，则升级域的默认数目为 5 个。

请参阅

Azure 云服务（外延支持）配置架构（cscfg 文件）。