金丝雀发布

KubeSphere 基于 Istio 向用户提供部署金丝雀服务所需的控制功能。在金丝雀发布中，您可以引入服务的新版本，并向其发送一小部分流量来进行测试。同时，旧版本负责处理其余的流量。如果一切顺利，您就可以逐渐增加向新版本发送的流量，同时逐步停用旧版本。如果出现任何问题，您可以用 KubeSphere 更改流量比例来回滚至先前版本。

该方法能够高效地测试服务性能和可靠性，有助于在实际环境中发现潜在问题，同时不影响系统整体稳定性。

canary-release-0

视频演示

准备工作

您需要启用 KubeSphere 服务网格。
您需要启用 KubeSphere 日志系统以使用 Tracing 功能。
您需要创建一个企业空间、一个项目和一个帐户 (project-regular)。请务必邀请该帐户至项目中并赋予 operator 角色。有关更多信息，请参见创建企业空间、项目、帐户和角色。
您需要开启应用治理并有一个可用应用，以便实现该应用的金丝雀发布。本教程中使用的示例应用是 Bookinfo。有关更多信息，请参见部署 Bookinfo 和管理流量。

步骤 1：创建金丝雀发布任务

以 project-regular 身份登录 KubeSphere 控制台，转到灰度发布页面，在灰度策略选项卡下，点击金丝雀发布右侧的发布任务。
设置任务名称，点击下一步。
在灰度组件选项卡，从下拉列表中选择您的应用和要实现金丝雀发布的服务。如果您同样使用示例应用 Bookinfo，请选择 reviews 并点击下一步。
在灰度版本选项卡，添加另一个版本（例如 kubesphere/examples-bookinfo-reviews-v2:1.13.0；将 v1 改为 v2）并点击下一步，如下图所示：

备注

请注意截图中的镜像版本是 v2。
您可以使用具体比例或者使用请求内容（例如 Http Header、Cookie 和 URI）分别向这两个版本（v1 和 v2）发送流量。选择按流量比例下发，并拖动中间的滑块来更改向这两个版本分别发送的流量比例（例如设置为各 50%）。操作完成后，点击创建。

步骤 2：验证金丝雀发布

现在您有两个可用的应用版本，请访问该应用以验证金丝雀发布。

访问 Bookinfo 网站，重复刷新浏览器。您会看到 Book Reviews 板块以 50% 的比例在 v1 版本和 v2 版本之间切换。
金丝雀发布任务创建后会显示在任务状态选项卡下。点击该任务查看详情。
您可以看到每个版本分别收到一半流量：
新的部署也已创建。
您可以执行以下命令直接获取虚拟服务来识别权重：
```
kubectl -n demo-project get virtualservice -o yaml
```
备注
- 当您执行上述命令时，请将 demo-project 替换为您自己项目（即命名空间）的名称。
- 如果您想在 KubeSphere 控制台使用 Web kubectl 执行命令，则需要使用 admin 帐户登录。

预期输出：

...
spec:
  hosts:
  - reviews
  http:
  - route:
    - destination:
        host: reviews
        port:
          number: 9080
        subset: v1
      weight: 50
    - destination:
        host: reviews
        port:
          number: 9080
        subset: v2
      weight: 50
      ...

步骤 3：查看网络拓扑

在运行 KubeSphere 的机器上执行以下命令引入真实流量，每 0.5 秒模拟访问一次 Bookinfo。
```
watch -n 0.5 "curl http://productpage.demo-project.192.168.0.2.nip.io:32277/productpage?u=normal"
```
备注

请确保将以上命令中的主机名和端口号替换成您自己环境的。
在流量治理中，您可以看到不同服务之间的通信、依赖关系、运行状态及性能。
点击组件（例如 reviews），在右侧可以看到流量监控信息，显示 Traffic、Success rate 和 Duration 的实时数据。

步骤 4：查看 Tracing 详情

KubeSphere 提供基于 Jaeger 的分布式追踪功能，用来对基于微服务的分布式应用程序进行监控及故障排查。

在 Tracing 选项卡中，可以清楚地看到请求的所有阶段及内部调用，以及每个阶段的调用耗时。
点击任意条目，可以深入查看请求的详细信息及该请求被处理的位置（在哪个机器或者容器）。

步骤 5：接管所有流量

如果一切运行顺利，则可以将所有流量引入新版本。

在灰度发布中，点击金丝雀发布任务。
在弹出的对话框中，点击 reviews v2 右侧的，选择接管所有流量。这代表 100% 的流量将会被发送到新版本 (v2)。

备注

如果新版本出现任何问题，可以随时回滚到之前的 v1 版本。
再次访问 Bookinfo，多刷新几次浏览器，您会发现页面只会显示 reviews v2 的结果（即带有黑色星标的评级）。

反馈

这篇文章对您有帮助吗？

感谢您的反馈。如果您有关于如何使用 KubeSphere 的具体问题，请在 Slack 上提问。如果您想报告问题或提出改进建议，请在 GitHub 存储库中打开问题。

页面内容