操作步骤

1. 创建灰度发布任务
   在ZStack Zaku主菜单，点击容器编排 > 微服务治理 > 微服务应用。在微服务应用界面，选择要进行灰度发布的微服务应用，点击灰度发布，弹出灰度发布界面。

   创建灰度发布任务分为以下两步：

   1. 新版工作负载

      创建新版本的工作负载，支持快速创建、标准创建、选择已有三种方式：

      1. 快速创建

         仅设置工作负载的名称、副本数、镜像配置，其余配置保持跟旧版工作负载一致。

         可参考以下示例输入相应内容：

         • 工作负载名称：指定新版本工作负载的名称。名称规则：长度限制2-50字符，且只能包含小写字母、数字和分隔符 “-”，必须以小写字母开头，以小写字母或数字结尾
         • 工作负载版本：指定新版本工作负载的版本。版本规则：长度限制1-50字符 ，只能包含小写字母、数字和分隔符 “-”，“-” 不能用于开头或结尾
         • 副本数：设置工作负载包含的容器组个数，最多支持100副本。DeamonSet类型的工作负载不需要设置副本数
         • 镜像配置：配置容器的镜像，默认设置与旧版工作负载一致
           • 容器：容器名称，与旧版工作负载保持一致，不可修改
           • 镜像来源：选择容器镜像来源 ，支持本地仓库和外部仓库两种镜像来源
             如选择本地仓库，将使用已上传到ZStack Zaku本地仓库的镜像创建容器 ，请设置以下参数：

             • 镜像：选择容器镜像
             • 镜像标签：选择镜像标签
             如选择外部仓库，将从ZStack Zaku外的仓库拉取镜像创建容器，请设置以下参数：

             • 镜像：输入详细的镜像地址，例如：docker.io/library/nginx:latest
             • 镜像拉取保密字典：可选项，如镜像所属的外部仓库是私有仓库，需选择保密字典用于镜像仓库认证
         Note: 快速创建方式除工作负载的名称、副本数、镜像配置外，其余配置保持跟旧版工作负载一致，如旧版工作负载挂载的数据卷不支持多节点读或写，请使用标准创建以选择新的数据卷
         如图 1所示：

         
         
         

      2. 标准创建

         可参考以下示例输入相应内容：

         • 新建工作负载：创建一个新的工作负载，参考创建工作负载
         • 工作负载版本：指定新版本工作负载的版本，版本规则：长度限制1-50字符 ，只能包含小写字母、数字和分隔符 “-”，“-” 不能用于开头或结尾
           Note: 如工作负载已有 zsedge.io/version 标签，默认使用该标签的值作为工作负载版本，支持手动修改，修改后的值将覆盖到工作负载 zsedge.io/version。
         如图 2所示：

         
         
         

      3. 选择已有

         可参考以下示例输入相应内容：

         • 选择工作负载：如新版本工作负载已经通过其他方式创建，则可直接选择该工作负载
           Note: 需确保所选工作负载能被应用下的服务关联。
         • 工作负载版本：指定新版本工作负载的版本，版本规则：长度限制1-50字符 ，只能包含小写字母、数字和分隔符 “-”，“-” 不能用于开头或结尾
           Note: 如工作负载已有 zsedge.io/version 标签，默认使用该标签的值作为工作负载版本，支持手动修改，修改后的值将覆盖到工作负载 zsedge.io/version。
         如图 3所示：

         
         
         

   2. 灰度策略

      可参考以下示例输入相应内容：

      • 策略类型：选择流量策略的类型，支持按流量比例和按请求内容两种方式将流量分配到新旧两个版本
        如选择按流量比例，访问流量将按照配置的比例发送到新版工作负载，剩余比例的流量将发送到旧版工作负载，请设置以下参数：

        • 新版本流量比例：设置要发送到新版本的流量的比例，默认为50%，最大为100%
        如选择按请求内容，则符合以下请求内容配置的流量将发送到新版工作负载，其他流量将被发送到旧版工作负载，请设置以下参数：

        • 请求内容：设置发送到新版工作负载的请求内容要求，只有符合该要求的请求才会被发送到新版工作负载，其他请求将被发送到旧版工作负载。用户可同时填写 URI、Cookie、Header 和操作系统要求，也可只填写其中的一个或几个
          • URI：设置URI的匹配方式及要匹配的内容，即请求流量访问的URI需能按选择的匹配方式匹配到填写的内容
          • Cookie：设置Cookie的匹配方式及要匹配的内容，即需能按选择的匹配方式在请求流量的Cookie中匹配到填写的内容
          • Header：设置Header的匹配方式及要匹配的内容，即需能按选择的匹配方式在请求流量的Header中匹配到填写的内容
          • 操作系统：指定来自哪些操作系统的请求流量能发送到新版本，默认为所有操作系统，可指定Windows、Linux、Mac OS、Android、iOS
            Note: 支持以下三种匹配方式：

            • 完全匹配：请求 URI/Cookie/Header 需与规定内容完全匹配，才能被发送到新版本。
            • 前缀匹配：请求 URI/Cookie/Header 需符合指定的前缀要求，才能被发送到新版本。
            • 正则匹配：请求 URI/Cookie/Header 需符合指定的正则表达式，才能被发送到新版本。
2. 监控灰度发布
   创建灰度发布任务后，在ZStack Zaku主菜单，点击容器编排 > 微服务治理 > 微服务应用。在微服务应用界面，点击已进行灰度发布的微服务应用，进入微服务应用详情页灰度发布页面，可以查看灰度发布任务的详情及新旧版本间的流量监控。

   如图 4所示：

   
   
   
   
   

3. 调整流量策略
   在ZStack Zaku主菜单，点击容器编排 > 微服务治理 > 微服务应用。在微服务应用界面，点击已进行灰度发布的微服务应用，进入微服务应用详情页灰度发布页面，点击修改策略，弹出修改策略界面。可根据灰度发布的实际情况参考创建灰度发布任务步骤调整流量策略。
4. 接管所有流量并版本下线
   当确定新版本功能稳定后，可让新版本接管所有流量，或在新版本出现问题时由旧版本接管回所有流量。在ZStack Zaku主菜单，点击容器编排 > 微服务治理 > 微服务应用。在微服务应用界面，点击已进行灰度发布的微服务应用，进入微服务应用详情页灰度发布页面，选择需要接管所有流量的版本，点击接管所有流量，则请求流量将全部发送到接管流量的版本。此时，可点击版本下线，将没有流量访问的版本下线，并删除版本对应的工作负载。