CI/CD with GitHub Actions & DevOps Pipelines · 课时

使用 Actions 实现金丝雀发布

Q: 「使用 Actions 实现金丝雀发布」这节课中我会学到什么？

实现灰度发布模式，逐步向部分用户推出新功能，同时监控性能和稳定性 你通过在浏览器中直接运行的动手代码来练习 CI/CD with GitHub Actions & DevOps Pipelines，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

实现灰度发布模式，逐步向部分用户推出新功能，同时监控性能和稳定性

使用 Actions 实现金丝雀发布 是 CoddyKit 上的免费 CI/CD with GitHub Actions & DevOps Pipelines 课时。这是第 2 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 CI/CD with GitHub Actions & DevOps Pipelines 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 CI/CD with GitHub Actions & DevOps Pipelines 课程共包含 4 节课。

金丝雀发布简介

想象一下，您要发布一项新功能或更新。如果其中存在影响所有用户的错误，该怎么办？是不是很可怕？

金丝雀发布通过先将变更逐步推出给一小部分用户，帮助降低这种风险。这就像先把一只“矿井中的金丝雀”送进去测试空气，然后其他人再进入。

金丝雀发布的好处

金丝雀发布有多项重要优势：

降低风险：将问题的影响限制在一小部分用户范围内。
真实反馈：获取有关性能和稳定性的生产数据。
快速回滚：如果出现问题，可以快速仅回滚小范围的金丝雀用户，或回滚整个服务。
可控暴露：随着信心增强，逐步扩大用户覆盖范围。

金丝雀发布与蓝绿部署

您可能还记得蓝绿部署：它会在两个完全相同的环境之间立即切换流量。

金丝雀发布则有所不同。它不是立即切换，而是进行逐步流量转移。新版本与旧版本并行运行，最初只有一小部分用户能看到新版本。这样便可以在全面发布前进行详细监控。

金丝雀发布的工作方式

下面是金丝雀发布的基本流程：

部署新版本：将应用的新版本部署到一小组服务器或实例上，同时保留现有的稳定版本。
导入少量流量：配置负载均衡器或服务网格，将一小部分（例如 5% 到 10%）的用户流量发送到新版本。
监控：密切监控金丝雀用户群体的性能、错误率和用户反馈。
提升版本或回滚：如果一切正常，逐步增加流量，或将新版本提升到 100% 的覆盖范围。如果出现问题，则回滚金丝雀版本，并将流量转回稳定版本。

使用 GitHub 操作编排

GitHub 操作可以编排整个金丝雀发布流程。它不会直接管理流量（这是您的基础设施负责的工作），但会触发以下步骤：

构建并测试您的应用程序。
将新版本部署到金丝雀环境。
通过调用 API，启动负载均衡器或服务网格的流量切换。
等待监控结果或手动批准。
提升金丝雀版本，或触发回滚。

金丝雀工作流概览

用于金丝雀发布的典型 GitHub 操作工作流可能如下所示：

name: Canary Deployment

on: push

jobs:
  build:
    # ... build and test steps ...

  deploy-canary:
    needs: build
    steps:
      - name: Deploy to Canary Group
        # ... call script/tool to deploy and shift 10% traffic ...

  monitor-canary:
    needs: deploy-canary
    # ... wait for monitoring/approval ...

  promote-or-rollback:
    needs: monitor-canary
    # ... conditionally promote to 100% or rollback ...

每个步骤都会与您的部署工具交互。

模拟金丝雀发布逻辑

GitHub 操作负责编排，而实际的决策和部署命令通常在脚本中执行。下面是一个模拟金丝雀发布< i>逻辑的 Python 示例。假设某个操作正在运行此脚本：

def deploy_version(version, traffic_percent):
    print(f"Deploying {version} to {traffic_percent}% traffic.")
    if traffic_percent == 100:
        print("Full rollout complete!")
    elif traffic_percent > 0:
        print("Canary deployed. Monitoring for stability...")
    else:
        print("Version removed (rollback).")

if __name__ == "__main__":
    print("--- Starting Canary Workflow ---")
    new_app_version = "v2.1-canary"
    stable_app_version = "v2.0"

    # Step 1: Deploy new version to 10% traffic
    deploy_version(new_app_version, 10)

    # Step 2: Simulate monitoring (e.g., waiting for metrics)
    print("Monitoring canary performance...")
    import random
    canary_successful = random.choice([True, True, True, False]) # 75% chance of success

    if canary_successful:
        print("Canary looks good! Proceeding to full rollout.")
        # Step 3a: Promote new version to 100%
        deploy_version(new_app_version, 100)
    else:
        print("Canary issues detected! Rolling back.")
        # Step 3b: Rollback to stable version
        deploy_version(stable_app_version, 100)
    print("--- Canary Workflow Finished ---")

监控您的金丝雀版本

有效的监控至关重要。您的 GitHub 操作工作流可以通过以下几种方式与监控系统集成：

API 调用：查询监控工具（例如 Datadog、Prometheus）以获取关键指标。
健康检查：轮询应用程序的健康检查端点。
手动闸门：暂停工作流，等待人工审查和批准。
基于时间的等待：等待设定的时间，让指标趋于稳定。

然后，工作流会使用这些信号来决定是提升版本还是回滚。

条件式提升或回滚

监控阶段结束后，GitHub 操作会使用条件逻辑来决定下一步。您可以在作业或步骤定义中使用 if 语句。

  promote-or-rollback:
    needs: monitor-canary
    if: success() && needs.monitor-canary.outputs.canary_ok == 'true'
    steps:
      - name: Promote Full Rollout
        # ... command to shift 100% traffic to new version ...

  rollback:
    needs: monitor-canary
    if: failure() || needs.monitor-canary.outputs.canary_ok == 'false'
    steps:
      - name: Rollback to Stable
        # ... command to shift 100% traffic to old version ...

这样可以根据金丝雀版本的性能自动做出响应。

金丝雀发布检查

您已经了解了金丝雀发布的优点和运行机制。现在来测试一下您的理解。

回顾：使用操作实现金丝雀发布

在本课中，您了解了金丝雀发布：这是一种强大的部署策略，可将新软件版本逐步发布给一部分用户。

金丝雀发布可以降低风险，并提供真实环境中的反馈。
GitHub 操作负责编排构建、部署到金丝雀环境、监控以及条件式提升或回滚等步骤。
有效的监控和条件逻辑是金丝雀流水线成功的关键。

通过使用金丝雀发布，您可以更有信心、更好地控制部署过程！

常见问题解答