求.NET Core 2无状态Service Fabric Web应用改后无需重部署的更新示例

我太懂这种改一行代码就要等5分钟部署的煎熬了！针对.NET Core 2的Service Fabric无状态Web应用，给你分享一个亲测有效的快速调试方案，完全不用每次都全量部署到集群：

核心思路 #

Service Fabric的无状态Web应用本质上还是标准的.NET Core Web项目，我们可以绕过Service Fabric集群，直接用dotnet run启动Web应用。这样修改代码、HTML或脚本后，只需要重启（或配置热重载）就能看到效果，把等待时间从5分钟压缩到几秒。

具体实现步骤 #

1. 改造项目的启动逻辑 #

打开你的无状态Web项目的Program.cs，默认模板里的代码是专为Service Fabric集群设计的，我们需要给它加个“双模式”支持——既能在集群里运行，也能独立启动：

using System;
using System.Fabric;
using System.IO;
using System.Threading;
using Microsoft.AspNetCore.Hosting;
using Microsoft.ServiceFabric.Services.Runtime;

namespace YourWebServiceName
{
    internal static class Program
    {
        private static void Main(string[] args)
        {
            // 判断当前是否在Service Fabric环境中
            if (FabricRuntime.IsServiceFabricRuntimeInstalled)
            {
                // 集群模式：注册Service Fabric服务
                try
                {
                    ServiceRuntime.RegisterServiceAsync("YourWebServiceType",
                        context => new YourWebService(context)).GetAwaiter().GetResult();

                    Thread.Sleep(Timeout.Infinite);
                }
                catch (Exception e)
                {
                    ServiceEventSource.Current.ServiceHostInitializationFailed(e.ToString());
                    throw;
                }
            }
            else
            {
                // 本地独立模式：直接启动Web应用
                var host = new WebHostBuilder()
                    .UseKestrel()
                    .UseContentRoot(Directory.GetCurrentDirectory())
                    .UseStartup<Startup>()
                    .UseUrls("http://localhost:5000") // 自定义本地访问端口
                    .Build();

                host.Run();
            }
        }
    }

    // 原有的StatelessService类保持不变
    internal sealed class YourWebService : StatelessService
    {
        public YourWebService(StatelessServiceContext context) : base(context) { }

        protected override IEnumerable<ServiceInstanceListener> CreateServiceInstanceListeners()
        {
            return this.CreateServiceInstanceListeners(serviceContext =>
                new ServiceInstanceListener(serviceContext =>
                    new KestrelCommunicationListener(serviceContext, "ServiceEndpoint", (url, listener) =>
                    {
                        ServiceEventSource.Current.ServiceMessage(serviceContext, $"Starting Kestrel on {url}");

                        return new WebHostBuilder()
                                    .UseKestrel()
                                    .ConfigureServices(services => services.AddSingleton<StatelessServiceContext>(serviceContext))
                                    .UseContentRoot(Directory.GetCurrentDirectory())
                                    .UseStartup<Startup>()
                                    .UseServiceFabricIntegration(listener, ServiceFabricIntegrationOptions.None)
                                    .UseUrls(url)
                                    .Build();
                    })));
        }
    }
}

2. 启动独立Web应用 #

有两种方式启动：

• 命令行方式：切换到Web项目的根目录（不是解决方案根目录），运行：

  dotnet run
  

  启动后直接访问http://localhost:5000就能看到应用，修改代码后按Ctrl+C停止，再重新运行dotnet run即可更新。
• Visual Studio调试：右键点击Web项目 → 设置为启动项目，按F5直接启动，还能断点调试，修改代码后重启项目就能看到变更。

3. 注意事项 #

• 如果你的代码里用到了Service Fabric特有的API（比如StatelessServiceContext），在独立模式下要做兼容处理，比如在Startup.cs里判断环境再注入：

  public void ConfigureServices(IServiceCollection services)
  {
      if (FabricRuntime.IsServiceFabricRuntimeInstalled)
      {
          services.AddSingleton<StatelessServiceContext>(...);
      }
      // 其他服务配置保持不变
  }
  

• 调试完成后，部署到Service Fabric集群时不需要修改任何代码，程序会自动识别环境并切换到集群模式运行。

额外优化：热重载（可选） #

如果你不想每次修改都重启项目，.NET Core 2.0可以通过添加第三方包实现热重载：

1. 安装包：Install-Package Microsoft.AspNetCore.Razor.RuntimeCompilation -Version 2.2.0
2. 在Startup.cs的ConfigureServices里添加：

   services.AddMvc().AddRazorRuntimeCompilation();
   

   这样修改Razor页面、HTML或脚本后，刷新浏览器就能看到变更，连重启都省了！

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