您在哪里为服务结构的每个环境设置和访问 运行 时间配置参数?

Where do you set and access run-time configuration parameters per environment for service fabric?

对于本地和云两种环境,我将如何为 Sql 数据库、存储帐户等资源设置自定义设置或参数...理想情况下,它会是一个在代码中调用的参数名称也就是说,将 DbContext 指向特定数据库,本地或云环境的配置不同。谢谢你。

为了在本地和云中为 运行 Service Fabric 设置每个环境变量,您必须这样做:

  1. 将您的自定义配置部分和参数添加到 Service/Actor 项目的 Settings.xml 文件(位于项目根目录的 \PackageRoot\Config\Settings.xml 处)。将参数留空,因为我们将在每个环境的其他地方设置这些参数。这是一个例子。
<?xml version="1.0" encoding="utf-8" ?>
<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="UserDatabase">
        <Parameter Name="UserDatabaseConnectionString" Value="" />
    </Section>
</Settings>
  1. 在您的 Service Fabric 项目的 ApplicationManifest.xml 文件中,每个包含的项目都有 <ServiceManifestImport> 个元素。在其下方将是一个 <ConfigOverrides> 元素,我们将在其中声明我们的配置的哪些值将被本地和云 xml 文件中 Service Fabric 项目中 ApplicationParameters 下的每个环境设置的值所取代。在同一个 ApplicationManifest.xml 文件中,您需要添加将出现在本地和云 xml 文件中的参数,否则它们将在构建时被覆盖。

继续上面的例子,这就是它的设置方式。

<Parameters>
    <Parameter Name="ServiceName_InstanceCount" DefaultValue="-1" />
    <Parameter Name="UserDatabaseConnectionString" DefaultValue="" />
</Parameters>
<ConfigOverrides>
    <ConfigOverride Name="Config">
        <Settings>
            <Section Name="UserDatabase">
                <Parameter Name="UserDatabaseConnectionString" Value="[UserDatabaseConnectionString]" />
            </Section>
        </Settings>
    </ConfigOverride>
</ConfigOverrides>
  1. 在 Service Fabric 项目的 ApplicationParameters 下的 local.xml 和 cloud.xml 文件中,您将像这样指定您的环境特定变量。
<?xml version="1.0" encoding="utf-8"?>
<Application xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" Name="fabric:/AppFabricName.ServiceFabric" xmlns="http://schemas.microsoft.com/2011/01/fabric">
    <Parameters>
        <Parameter Name="ServiceName_InstanceCount" Value="1" />
        <Parameter Name="UserDatabaseConnectionString" Value="Server=(localdb)\MsSqlLocalDb;Database=Users;User=ReadOnlyUser;Password=XXXXX;" />
    </Parameters>
</Application>
  1. 最后,在您的 Service/Actor 中,您可以像这样访问这些每个环境的配置变量。
var configurationPackage = Context.CodePackageActivationContext.GetConfigurationPackageObject("Config");

var connectionStringParameter = configurationPackage.Settings.Sections["UserDatabase"].Parameters["UserDatabaseConnectionString"];

您可以像任何其他应用程序一样使用环境变量,这也适用于服务结构中的来宾可执行文件,这与settings.xml 因为这需要内置的服务结构运行时。

在您的应用程序中,您可以通过 Environment class:

上的 GetEnvironmentVariable 方法像访问任何其他 .net 应用程序一样访问环境变量
var baseUri = Environment.GetEnvironmentVariable("SuperWebServiceBaseUri");

然后我们需要设置一些默认环境变量值,这是在服务的 ServiceManifest.xml 清单文件中完成的。

<?xml version="1.0" encoding="utf-8" ?>
<ServiceManifest Name="MyServicePkg" Version="1.0.0" xmlns="http://schemas.microsoft.com/2011/01/fabric" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <!-- snip -->
    <CodePackage Name="Code" Version="1.0.0">
        <!-- snip -->
        <EnvironmentVariables>
            <EnvironmentVariable Name="SuperWebServiceBaseUri" Value="http://localhost:12345"/>
        </EnvironmentVariables>
    </CodePackage>
    <!-- snip -->
</ServiceManifest>

然后可以使用以下代码在 ApplicationManifest.xml 文件中覆盖这些环境变量:

<?xml version="1.0" encoding="utf-8"?>
<ApplicationManifest xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" ApplicationTypeName="ChileTargetType" ApplicationTypeVersion="1.0.0" xmlns="http://schemas.microsoft.com/2011/01/fabric">
    <Parameters>
        <!-- snip -->
    </Parameters>
    <ServiceManifestImport>
        <ServiceManifestRef ServiceManifestName="MyServicePkg" ServiceManifestVersion="1.0.0" />
        <EnvironmentOverrides CodePackageRef="Code">
            <EnvironmentVariable Name="SuperWebServiceBaseUri" Value="https://the-real-live-super-base-uri.com/"/>
        </EnvironmentOverrides>
    </ServiceManifestImport>
    <!-- snip -->
</ApplicationManifest>

这可以像使用 local.xmlcloud.xml 的任何其他应用程序清单设置一样进行参数化。

<?xml version="1.0" encoding="utf-8"?>
<Application xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" Name="fabric:/AppFabricName.ServiceFabric" xmlns="http://schemas.microsoft.com/2011/01/fabric">
    <Parameters>
        <Parameter Name="MyService_SuperWebServiceBaseUri" Value="https://another-base-uri.com/" />
    </Parameters>
</Application>

然后我们必须更新 ApplicationManifest.xml 以支持这些参数;

<?xml version="1.0" encoding="utf-8"?>
<ApplicationManifest xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" ApplicationTypeName="ChileTargetType" ApplicationTypeVersion="1.0.0" xmlns="http://schemas.microsoft.com/2011/01/fabric">
    <Parameters>
        <Parameter Name="MyService_SuperWebServiceBaseUri" DefaultValue="https://the-real-live-super-base-uri.com/" />
    </Parameters>
    <ServiceManifestImport>
        <ServiceManifestRef ServiceManifestName="MyServicePkg" ServiceManifestVersion="1.0.0" />
        <EnvironmentOverrides CodePackageRef="Code">
            <EnvironmentVariable Name="SuperWebServiceBaseUri" Value="[MyService_SuperWebServiceBaseUri]"/>
        </EnvironmentOverrides>
    </ServiceManifestImport>
    <!-- snip -->
</ApplicationManifest>

上面的答案很好地解释了它是如何完成的。我想添加一个边注,为什么是 'convoluted':

必须是这样,因为服务应该是独立的。默认情况下,它们在链接到的任何应用程序中都应该 运行。独立于应用程序的清单。所以服务只能依赖参数,这些参数至少是在它自己的配置中预定义的。

然后这些预设可以被应用程序覆盖。这是唯一通用的方法。