金丝雀发布

什么是金丝雀发布

金丝雀发布是已经将新版本应用部署到生产环境了，然后根据一定的特征，一般是用户ID、用户地域、用户类型等不同维度，允许部分用户使用部署到生产环境上的新版本应用。这个过程中，通过观察新版本的表现（比如成功率、时延、负载等），以判断新版本是否符合预期。

金丝雀发布需要依赖几个关键的技术点：

北极星提供以下功能，支持金丝雀发布：

北极星支持Spring Cloud Tencent以及服务网格（Envoy）的方式接入使用金丝雀发布的能力。

如果已经部署好了polaris，可忽略这一步。

polaris支持在kubernetes环境中进行部署，注意必须保证暴露HTTP端口为8090，gRPC端口为8091。具体部署方案请参考：

Spring Cloud Tencent支持通过以下2种方式进行实例的版本号打标：

在服务实例的配置文件中添加配置，如在 bootstrap.yml 添加如下所示即可：

spring:
  cloud:
    tencent:
      metadata:
        content:
          version: 2.0.0

在服务实例所在的操作系统中添加环境变量也可进行打标，例如：SCT_METADATA_CONTENT_version=2.0.0 。

由于Spring Cloud默认不会对所有的请求标签进行透传，因此需要增加Spring Cloud透传标识，可以通过添加环境变量SCT_PROTOCOL_CONTENT_TRANSITIVE_HEADER=gray的方式，进行灰度标识gray:true的透传。

应用需要基于K8S进行部署，才可以使用Envoy Proxy的接入模式。

实例的版本标签需要通过POD标签的方式打入，然后在部署过程中，北极星的controller会自动把POD标签同步到北极星。

可以在K8S的部署配置中，在template配置中，添加labels的方式完成版本打标。可参考这里的部署配置：微服务部署配置

spec:
  template:
    metadata:
      labels:
        app: user
        version: 2.0.0

支持虚拟机、Docker Composer、K8S等多种部署模式，注意需要保证业务进程与北极星服务的网络连通性。

只支持K8S的部署模式，同时，为了实现POD标签的自动同步，以及Envoy Proxy的自动注入，需要预先部署北极星的Controller组件（polaris-controller）。具体部署方案请参考：

通过配置微服务路由，目标是使得对于灰度流量的调用，都只在新版本的服务分组中进行。

打开北极星控制台，通过点击侧边栏：动态路由->自定义规则页面，配置自定义路由规则，规则只对credit服务生效。

通过北极星的可观测性能力，可以准确看到不同分组的流量切换的过程，以及服务调用成功率，等到灰度分组相关指标没有问题，代表灰度验证完成。

灰度验证完成后，需要做以下事情：

北极星提供了一键部署demo，可以通过一键部署demo快速体验蓝绿发布。详细请参考：