在 Windows 上容器化 Service Fabric Reliable Services 和 Reliable Actors

项目
08/12/2024

Service Fabric 支持容器化 Service Fabric 微服务（基于 Reliable Services 和 Reliable Actor 的服务）。有关详细信息，请参阅 Service Fabric 容器。

本文档提供了有关使服务在 Windows 容器内运行的指导。

注意

当前此功能仅适用于 Windows。若要运行容器，必须在包含容器的 Windows Server 2016 上运行群集。

容器化 Service Fabric 应用程序的步骤

在 Visual Studio 中打开 Service Fabric 应用程序。
将 SFBinaryLoader.cs 类添加到项目。此类中的代码在容器中运行时，是用于在应用程序中正确加载 Service Fabric 运行时二进制文件的帮助程序。

对于要容器化的每个代码包，在程序入口点初始化加载程序。将以下代码片段中所示的静态构造函数添加到程序入口点文件中。

namespace MyApplication
{
   internal static class Program
   {
       static Program()
       {
           SFBinaryLoader.Initialize();
       }

       /// <summary>
       /// This is the entry point of the service host process.
       /// </summary>
       private static void Main()
       {

生成并打包项目。若要生成并创建包，请在解决方案资源管理器中右键单击应用程序项目，选择“包”命令。

对于每个需要容器化的代码包，运行 PowerShell 脚本 CreateDockerPackage.ps1。用法如下：

完整 .NET

  $codePackagePath = 'Path to the code package to containerize.'
  $dockerPackageOutputDirectoryPath = 'Output path for the generated docker folder.'
  $applicationExeName = 'Name of the Code package executable.'
  CreateDockerPackage.ps1 -CodePackageDirectoryPath $codePackagePath -DockerPackageOutputDirectoryPath $dockerPackageOutputDirectoryPath -ApplicationExeName $applicationExeName

.NET Core

  $codePackagePath = 'Path to the code package to containerize.'
  $dockerPackageOutputDirectoryPath = 'Output path for the generated docker folder.'
  $dotnetCoreDllName = 'Name of the Code package dotnet Core Dll.'
  CreateDockerPackage.ps1 -CodePackageDirectoryPath $codePackagePath -DockerPackageOutputDirectoryPath $dockerPackageOutputDirectoryPath -DotnetCoreDllName $dotnetCoreDllName

该脚本使用位于 $dockerPackageOutputDirectoryPath 的 Docker 项目创建文件夹。可以根据需要修改生成的 Dockerfile 来 expose 任何端口，以及运行设置脚本等。

接下来需要生成 Docker 容器包并将其推送到存储库。

修改 ApplicationManifest.xml 和 ServiceManifest.xml，添加容器映像、存储库信息、注册表身份验证和端口到主机映射。有关修改清单的信息，请参阅创建 Azure Service Fabric 容器应用程序。服务清单中的代码包定义需要替换为相应的容器映像。请确保将入口点更改为 ContainerHost 类型。

<!-- Code package is your service executable. -->

<CodePackage Name="Code" Version="1.0.0">
<EntryPoint>
 <!-- Follow this link for more information about deploying Windows containers to Service Fabric: https://aka.ms/sfguestcontainers -->

 <ContainerHost>
   <ImageName>myregistry.azurecr.cn/samples/helloworldapp</ImageName>
 </ContainerHost>
</EntryPoint>
<!-- Pass environment variables to your container: -->

</CodePackage>

为复制器和服务终结点添加端口到主机映射。由于 Service Fabric 在运行时分配这两个端口，因此 ContainerPort 会设置为零，将分配的端口用于映射。

<Policies>
<ContainerHostPolicies CodePackageRef="Code">
 <PortBinding ContainerPort="0" EndpointRef="ServiceEndpoint"/>
 <PortBinding ContainerPort="0" EndpointRef="ReplicatorEndpoint"/>
</ContainerHostPolicies>
</Policies>

有关配置容器隔离模式，请参阅配置隔离模式。 Windows 支持容器的两种隔离模式：进程和 Hyper-V。以下代码片段展示了如何在应用程序清单文件中指定隔离模式。

<Policies>
<ContainerHostPolicies CodePackageRef="Code" Isolation="process">
...
</ContainerHostPolicies>
</Policies>

<Policies>
<ContainerHostPolicies CodePackageRef="Code" Isolation="hyperv">
...
</ContainerHostPolicies>
</Policies>

注意

根据设计，Service Fabric 群集是单租户，托管应用程序被视为受信任。如果你正在考虑托管不受信任的容器应用程序，请考虑将它们部署为来宾容器，并请参阅在 Service Fabric 群集中托管不受信任的应用程序。

若要测试此应用程序，需要将其部署到正在运行版本 5.7 或更高版本的群集。对于运行时版本 6.1 或更低版本，你需要编辑并更新群集设置来启用此预览版功能。请按照本文中的步骤操作，添加下一步所示的设置。
```
  {
    "name": "Hosting",
    "parameters": [
      {
        "name": "FabricContainerAppsEnabled",
        "value": "true"
      }
    ]
  }
```
接下来，将已编辑的应用程序包部署到此群集。

现在即具有运行群集的容器化 Service Fabric 应用程序。

后续步骤

详细了解如何运行 Service Fabric 上的容器。
了解 Service Fabric 应用程序生命周期。

通过

在 Windows 上容器化 Service Fabric Reliable Services 和 Reliable Actors

容器化 Service Fabric 应用程序的步骤

后续步骤

其他资源