ASP.NET Core 应用的零停机部署策略

上线新版本时，最怕什么？不是代码没测好，而是------用户访问时看到"503 服务不可用"或页面直接白屏。 这不仅是体验问题，更是业务损失。零停机部署（Zero Downtime Deployment），就是让你在发布新版本时，用户完全无感 ------ 页面不卡、接口不断、会话不丢。

本文将手把手教你：

如何在 IIS + Windows Server 环境下，实现真正的"零停机"部署，并结合 Jenkins 或 GitHub Actions 实现自动化发布。

2. 为什么零停机部署如此重要？

想象一下：

你正在给一个银行系统升级，部署过程需要 2 分钟。在这 2 分钟里：

IIS 应用池重启 → 所有请求挂起
用户点击"提交订单" → 返回 503
客服电话被打爆："你们系统又崩了？"

听起来夸张？但这就是现实。

✅ 零停机部署能确保：

不出现 503 错误
用户会话不中断
出问题能秒回滚
真正实现"持续交付"

3. 零停机的核心理念

要实现零停机，靠的是三个关键：

多实例并行：旧版和新版同时跑
流量切换：通过负载均衡或代理，灵活引导流量
原子级切换：新版本验证通过后，一次性切流，不拖泥带水

在 IIS 环境下，常用方式有：

蓝绿部署（Blue-Green）→ 最经典、最安全
滚动更新（Rolling Update）→ 多台服务器交替更新
部署插槽（Azure App Service）→ 云原生方案
负载均衡器（ARR、Nginx、硬件 LB）→ 控制流量入口

4. 技术流程图（一句话看懂）

复制代码

开发者提交代码
       ↓
CI/CD 自动构建 & 测试
       ↓
发布到 Green 站点（预发布环境）
       ↓
健康检查 → 成功？
       ↓
是 → 切换流量到 Green
       ↓
监控运行状态 → 正常？
       ↓
是 → 蓝站下线；否 → 立即回滚到 Blue

★

✅ 核心思想：先上新，再切流，最后下旧

5. 实现步骤详解（以 Jenkins + IIS 为例）

Step 1：准备 IIS 的蓝绿站点

你需要两个 IIS 站点：

myapp-blue → 当前生产版本
myapp-green → 即将上线的新版本

它们指向不同的物理目录：

复制代码

C:\inetpub\wwwroot\myapp-blue
C:\inetpub\wwwroot\myapp-green

要求：

使用相同的应用程序池（避免资源竞争）
绑定相同的域名（同机部署可用不同端口，比如 8080 和 8081）
数据库和配置文件保持一致（除版本差异外）

Step 2：构建并发布 ASP.NET Core 应用

在 Jenkins 中执行：

复制代码

dotnet clean
dotnet restore
dotnet build --configuration Release
dotnet publish -c Release -o ./publish

生成可部署的发布包。

Step 3：部署到 Green 环境

将发布包复制到 Green 目录：

复制代码

Copy-Item -Path "C:\Jenkins\workspace\MyApp\publish\*" `
          -Destination "C:\inetpub\wwwroot\myapp-green" `
          -Recurse -Force

然后仅重启 Green 站点：

复制代码

Restart-WebAppPool "MyAppPool"
Start-Website "myapp-green"

★

⚠️ 注意：不要重启整个 IIS，只重启目标站点！

Step 4：健康检查（Health Check）

在你的应用中，定义一个健康检查端点：

复制代码

app.MapGet("/health", () => Results.Ok("Healthy"));

然后在 Jenkins 中执行健康检查：

复制代码

curl http://localhost:8081/health

如果返回 "Healthy"，说明新版本正常运行。

Step 5：流量切换（Blue → Green）

你可以通过以下方式切换：

✅ 方式 1：DNS 切换（简单但慢）

修改 DNS 记录，让域名指向 Green 站点（适合多机部署）

✅ 方式 2：IIS ARR 负载均衡

修改 ARR 规则，把所有流量导向 Green：

复制代码

<rule name="SwitchToGreen" enabled="true">
  <match url="(.*)" />
  <action type="Rewrite" url="http://myapp-green/{R:1}" />
</rule>

✅ 方式 3：Jenkins 自动化脚本

复制代码

Stop-Website 'myapp-blue'
Start-Website 'myapp-green'

这样用户访问将无缝切换到新版本。

Step 6：监控与回滚

上线后，立即监控：

响应时间
错误率
CPU/内存使用率

如果发现异常，立即回滚：

复制代码

Stop-Website 'myapp-green'
Start-Website 'myapp-blue'

并通知团队排查。

6. Jenkinsfile 示例

以下是一个简化版 Jenkinsfile，展示完整部署流程：

复制代码

pipeline {
    agent any
    stages {
        stage('Build') {
            steps {
                bat 'dotnet clean'
                bat 'dotnet restore'
                bat 'dotnet publish -c Release -o publish'
            }
        }
        stage('Deploy to Green') {
            steps {
                powershell '''
                Copy-Item -Path "publish/*" -Destination "C:\\inetpub\\wwwroot\\myapp-green" -Recurse -Force
                Restart-WebAppPool "MyAppPool"
                Start-Website "myapp-green"
                '''
            }
        }
        stage('Health Check') {
            steps {
                script {
                    def response = bat(script:'curl http://localhost:8081/health', returnStdout:true).trim()
                    if (!response.contains("Healthy")) {
                        error("Health check failed for Green site")
                    }
                }
            }
        }
        stage('Switch Traffic') {
            steps {
                powershell '''
                Stop-Website "myapp-blue"
                Start-Website "myapp-green"
                '''
            }
        }
    }
}

7. ASP.NET Core 平滑重启配置

为了防止应用池重启时请求中断，可配置优雅关闭：

复制代码

builder.WebHost.ConfigureKestrel(options =>
{
    options.AddServerHeader = false;
    options.Limits.KeepAliveTimeout = TimeSpan.FromMinutes(2);
});

app.Lifetime.ApplicationStopping.Register(() =>
{
    Console.WriteLine("App is shutting down gracefully...");
});

这样，正在处理的请求会在应用关闭前完成，避免"半路断掉"。

8. 部署后监控

上线后，必须监控：

Application Insights 或 ELK（Elastic Stack）
跟踪响应时间、错误率、CPU/内存使用率
保留 Blue 环境作为备用，便于随时回滚

示例配置（Program.cs）：

复制代码

builder.Services.AddApplicationInsightsTelemetry();

9. IIS + Jenkins 零停机最佳实践

✅ 始终保持 Blue / Green 双环境

✅ 每次部署后自动执行 Smoke Test

✅ 若维护用户会话，使用负载均衡会话亲和（Session Affinity）

✅ 使用 appsettings.Production.json 或环境变量进行配置隔离

✅ 在部署前备份数据库结构

✅ 使用预热脚本加载缓存

✅ 明确文档化回滚流程

10. 实际案例

在 SilverXis Pvt Ltd，我们为一个大型 ASP.NET Core + Angular ERP 系统实现了零停机部署。

原先每次发布都会造成数秒的服务中断。

实施蓝绿部署后，QA 可以在 Green 环境验证新版本，

只需一条 PowerShell 命令即可切换到生产流量。

结果：

✅ 0 停机

✅ 快速回滚

✅ 更高的上线信心

11. 流程总结

阶段	描述	工具
Code Commit	开发者推送代码	GitHub
CI Build	构建、测试、发布	Jenkins + .NET CLI
Deploy Green	文件复制、站点启动	PowerShell + IIS
Health Check	验证健康状态	Curl / API Test
Switch Traffic	蓝→绿流量切换	Jenkins + IIS
Monitor & Rollback	监控与回滚	App Insights / ELK

12. 结语

零停机部署，不是 DevOps 的"锦上添花"，

而是企业系统稳定运行的必要条件 。借助 ASP.NET Core + IIS + Jenkins，你可以可靠且高效地实现这一目标。通过蓝绿部署模型、CI/CD 自动化和健康检查机制，你的应用可以在任何时间上线新版本 ------ 而无需牺牲一秒钟的可用性。