Azure 云服务(经典)配置架构(.cscfg 文件)
重要
从 2024 年 9 月 1 日开始,已弃用所有客户的云服务(经典版)。 从 2024 年 10 月开始,Microsoft 将停止并关闭任何正在运行的现有部署,数据将永久性丢失。 新部署应使用基于 Azure 资源管理器的新型部署模型 Azure 云服务(外延支持)。
服务配置文件指定要为服务中每个角色部署的角色实例数、任何配置设置的值,以及与角色关联的任何证书的缩略图。 如果服务属于虚拟网络,必须在服务配置文件以及虚拟网络配置文件中提供网络的配置信息。 服务配置文件的默认扩展名为 .csdef。
云服务(经典)定义架构介绍了服务模型。
默认情况下,Azure 诊断配置架构文件将安装到 C:\Program Files\Microsoft SDKs\Azure\.NET SDK\<version>\schemas
目录。 将 <version>
替换为 Azure SDK 的已安装版本。
有关在服务中配置角色的详细信息,请参阅什么是云服务模型。
基本服务配置架构
服务配置文件的基本格式如下所示。
<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
元素的属性。 所有属性值均为字符串类型。
Attribute | 说明 |
---|---|
serviceName | 必需。 云服务的名称。 此处提供的名称需要匹配服务定义文件中指定的名称。 |
osFamily | 可选。 指定要在云服务的角色实例上运行的来宾 OS。 有关支持的来宾 OS 版本的信息,请参阅 Azure 来宾 OS 版本和 SDK 兼容性对照表。 如果不包含 osFamily 值,并且未将 osVersion 属性设置为特定的来宾 OS 版本,将使用默认值 1。 |
osVersion | 可选。 指定要在云服务的角色实例上运行的来宾 OS 版本。 有关来宾 OS 版本的详细信息,请参阅 Azure 来宾 OS 版本和 SDK 兼容性对照表。 可以指定应自动将来宾 OS 升级到最新版本。 若要执行此操作,将 osVersion 属性的值设为 * 。 如果设置为 * ,将使用指定 OS 系列的最新来宾 OS 版本部署角色实例,并且在发布新版来宾 OS 后自动进行升级。若要手动指定特定版本,请使用来自 Azure 来宾 OS 版本和 SDK 兼容性对照表的“将来、当前和过渡来宾 OS 版本”部分的表格中的 Configuration String 。osVersion 属性的默认值为 * 。 |
schemaVersion | 可选。 指定服务配置架构的版本。 如果并行安装多个版本的 SDK,架构版本允许 Visual Studio 选择正确的 SDK 工具用于架构验证。 有关架构和版本兼容性的信息,请参阅 Azure 来宾 OS 版本和 SDK 兼容性对照表 |
服务配置文件必须包含一个 ServiceConfiguration
元素。 ServiceConfiguration
元素可包含任意数量的 Role
元素或 0 到 1 个 NetworkConfiguration
元素。