.NET Core应用部署至Linux Service Fabric集群问题咨询

结合你已经完成的准备工作（修改entryPoint.sh和ServiceManifest.xml），下面是具体的部署步骤和需要注意的细节：

1. 确保编译出Linux兼容的服务包 #

首先要保证你的代码是针对Linux环境编译的：

• 如果你用命令行，执行：

  dotnet publish -c Release -r linux-x64
  

  这个命令会生成适配Linux x64的二进制文件，发布到bin/Release/netX/linux-x64/publish目录（X是你的.NET版本，比如6、7）。
• 如果你用Visual Studio，右键服务项目→选择“发布”，在发布配置里：
  • 目标运行时选linux-x64
  • 按需勾选“生成自包含部署”（如果不想依赖集群节点上的.NET Runtime的话）
  • 点击“发布”生成对应包

2. 确认EntryPoint.sh和ServiceManifest的配置正确性 #

你已经修改了EntryPoint，这里再核对几个关键项：

• ServiceManifest.xml的EntryPoint配置：确保Program指向entryPoint.sh，并且WorkingFolder设置正确：

  <EntryPoint>
    <ExeHost>
      <Program>entryPoint.sh</Program>
      <Arguments></Arguments>
      <WorkingFolder>CodePackage</WorkingFolder>
    </ExeHost>
  </EntryPoint>
  

• entryPoint.sh的权限和内容：
  • 要保证脚本有可执行权限，你可以在项目文件（.csproj）里加这段配置，让MSBuild自动处理：

    <ItemGroup>
      <None Update="entryPoint.sh">
        <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
        <Executable>true</Executable>
      </None>
    </ItemGroup>
    

  • 脚本内容要正确指向你的服务DLL，比如yeoman生成的模板要替换成实际的服务名称：

    #!/bin/bash
    set -e
    dotnet YourServiceName.dll
    

3. 打包Service Fabric应用 #

接下来把服务打包成SF可识别的应用包：

• 用Visual Studio的话，右键应用项目→选择“Package”，生成的包会在pkg/Release目录下。
• 用命令行的话，用Service Fabric CLI（sfctl）先切换到应用项目根目录，执行：

  sfctl application package create --path . --output-path pkg/Release
  

4. 连接到Linux SF集群并部署 #

假设你用的是Docker里的onebox实例，先确保sfctl已经连接到集群：

sfctl cluster select --endpoint http://localhost:19080

然后分两步部署：

注册应用类型 #

sfctl application provision --application-type-build-path "YourApplicationType" --timeout 3600

这里的YourApplicationType是pkg/Release下的应用类型文件夹名称（比如MyAppType）。

创建应用实例 #

sfctl application create --app-name fabric:/MyApplication --app-type YourApplicationType --app-version 1.0.0 --timeout 3600

注意替换MyApplication为你的应用名称，版本号要和ApplicationManifest.xml里的ApplicationVersion一致。

5. 验证部署结果 #

部署完成后，用以下命令检查状态：

• 查看所有应用：sfctl application list
• 查看目标应用的健康状况：sfctl application health --application-id fabric:/MyApplication
• 查看服务实例状态：sfctl service list --application-id fabric:/MyApplication

如果出现部署失败，可以查看集群日志（onebox的Docker容器日志），或者用sfctl event store query --start-time-utc "2024-01-01T00:00:00Z"查询事件日志排查问题。

额外注意事项 #

• 确保Linux集群节点上安装了对应版本的.NET Runtime（如果不是自包含部署的话）。
• Docker onebox实例要映射必要的端口：19080（管理端口）、19000（集群通信）、19001（节点到节点通信）等，避免端口不通导致部署失败。
• 如果服务有依赖的环境变量，要在ServiceManifest.xml里添加EnvironmentVariables节点配置。

内容的提问来源于stack exchange，提问作者mccow002