如何在 Service Fabric 中参数化配置文件

本文演示如何在 Service Fabric 中参数化配置文件。 如果还不熟悉管理多个环境的应用程序的核心概念，请阅读管理多个环境的应用程序。

参数化配置文件的过程

在此示例中，在应用程序部署中使用参数来替代配置值。

1. 打开服务项目中的 <MyService>\PackageRoot\Config\Settings.xml 文件。

2. 通过添加以下 XML，设置配置参数名称和值，例如高速缓存大小等于 25：

   <Section Name="MyConfigSection">
       <Parameter Name="CacheSize" Value="25" />
   </Section>
   

3. 保存并关闭该文件。

4. 打开 <MyApplication>\ApplicationPackageRoot\ApplicationManifest.xml 文件。

5. 在 ApplicationManifest.xml 文件的 Parameters 元素中声明参数和默认值。 建议参数名称包含服务的名称（例如，“MyService”）。

    <Parameters>
      <Parameter Name="MyService_CacheSize" DefaultValue="80" />
    </Parameters>
   

6. 在 ApplicationManifest.xml 文件的 ServiceManifestImport 节中，添加 ConfigOverrides 和 ConfigOverride 元素，引用配置包、节和参数。

    <ConfigOverrides>
      <ConfigOverride Name="Config">
          <Settings>
            <Section Name="MyConfigSection">
                <Parameter Name="CacheSize" Value="[MyService_CacheSize]" />
            </Section>
          </Settings>
      </ConfigOverride>
    </ConfigOverrides>
   

在代码中访问参数化配置

可以通过编程方式访问 settings.xml 文件中的配置。 例如，以下配置 XML 文件：

<Settings
	xmlns:xsd="http://www.w3.org/2001/XMLSchema"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xmlns="http://schemas.microsoft.com/2011/01/fabric">
	<!-- Add your custom configuration sections and parameters here -->

	<Section Name="MyConfigSection">
		<Parameter Name="MyParameter" Value="Value1" />
	</Section>
</Settings>     

请使用以下代码来访问这些参数：

CodePackageActivationContext context = FabricRuntime.GetActivationContext();
var configSettings = context.GetConfigurationPackageObject("Config").Settings;
var data = configSettings.Sections["MyConfigSection"];
foreach (var parameter in data.Parameters)
{
  ServiceEventSource.Current.ServiceMessage(this.Context, "Working-{0} - {1}", parameter.Name, parameter.Value);
}

此处 Parameter.Name 将会是 MyParameter，Parameter.Value 将会是 Value1

后续步骤

有关 Visual Studio 中其他可用应用管理功能的信息，请参阅在 Visual Studio 中管理 Service Fabric 应用程序。