实施步骤

准备CCE工作负载信息

1. 创建集群。
   1. 登录云容器引擎控制台，在“集群管理”页面购买CCE Standard集群或CCE Turbo集群。此处选择CCE Standard集群，容器网络模型为“VPC网络”，具体操作步骤请参见购买CCE集群。
   2. 集群创建完成后，记录容器网段。
   3. 在APIG专享版实例的“路由”中添加容器网段。
      1. 登录API网关控制台，在左侧导航栏中“实例管理”。
      2. 单击对应实例名称，进入实例信息页面。
      3. 在“路由”区域添加容器网段。

2. 创建工作负载。
   1. 在云容器引擎控制台的“集群管理”页面，单击已创建的集群名称，进入集群详情。
   2. 在左侧导航栏中选择“工作负载”。
   3. 单击“创建负载”。此处选择“无状态负载 Deployment”负载类型，具体操作步骤请参见《云容器引擎用户指南》。

      您可以在“高级配置 > 标签与注释”中设置“Pod标签”，便于之后根据标签切换工作负载与服务版本。此处为“app=deployment-demo”，“version=v1”。如果您是通过导入YAML创建工作负载，也可以在yaml中添加“Pod标签”。Pod标签的具体使用请参见设置标签与注解。

      在yaml中添加“Pod标签”：

      spec:
        replicas: 2
        selector:
          matchLabels:
            app: deployment-demo
            version: v1
        template:
          metadata:
            creationTimestamp: null
            labels:
              app: deployment-demo
              version: v1

方式一：通过创建负载通道开放CCE工作负载

1. 创建负载通道。
   1. 进入API网关控制台，在左侧导航栏上方选择实例。
   2. 在左侧导航栏中选择“API管理 > API策略”。
   3. 在“负载通道”页签中单击“创建负载通道”。
      1. 基本信息配置。

         表1 基本信息配置

         参数	配置说明
         通道名称	填写负载通道名称，根据规划自定义。建议您按照一定的命名规则填写负载通道名称，方便您快速识别和查找。此处填写“VPC_demo”。
         端口	填写已创建工作负载的容器端口，指工作负载中pod里业务直接对外开放的接口。此处填写“80”，80端口默认为http协议端口。
         分发算法	此处选择“加权轮询”。通过分发算法确定请求被发送到哪台主机。结合弹性服务器权重值，将请求轮流转发到每一台服务器。
         通道类型	此处选择“微服务”。

      2. 微服务配置。

         表2 微服务配置

         参数	配置说明
         微服务类型	默认选择“云容器引擎CCE”。
         集群	选择已创建的集群。
         命名空间	选择已创建集群中的命名空间，此处选择“default”。
         工作负载类型	此处选择“无状态负载 Deployment”，与已创建的工作负载类型一致。
         服务标识名	此处选择已创建的工作负载中的Pod标签“app”和“deployment-demo”，指定工作负载。
         服务标识值

      3. 服务器分组配置。

         表3 服务器分组配置

         参数	配置说明
         服务器分组名称	此处填写“server_group_v1”。
         权重分配	此处填写“1”。
         后端服务端口	此处填写“80”，与已创建工作负载中的容器端口一致。
         描述	此处填写“Pod标签version值为v1的服务器分组”。
         标签	此处选择已创建的工作负载中的Pod标签“version=v1”。

      4. 健康检查配置。

         表4 健康检查配置

         参数	配置说明
         协议	默认为“TCP协议”。
         检查端口	填写为通道中后端服务器端口。
         正常阈值	默认为“2”。判定VPC通道中主机正常的依据：连续检查x成功，x为您设置的正常阈值。
         异常阈值	默认为“5”。判定VPC通道中主机异常的依据为：连续检查x失败，x为您设置的异常阈值。
         超时时间	默认为“5”。检查期间，无响应的时间。
         间隔时间	默认为“10”。连续两次检查的间隔时间。

      5. 单击“完成”。

         在负载通道列表中，单击负载通道名称可查看创建的负载通道详情。

2. 开放API。
   1. 创建API分组。
      1. 在左侧导航栏中选择“API管理 > API分组”。
      2. 单击“创建API分组 > 直接创建”。
      3. 填写API分组信息后，单击“确定”。
   2. 创建API并绑定已创建的负载通道。
      1. 单击已创建的API分组名称，进入分组详情页面，在“API运行”页签中单击“创建API > 创建API”。
      2. 配置前端信息后，单击“下一步”。

         表5 前端配置

         参数	配置说明
         API名称	填写API名称，建议您按照一定的命名规则填写，方便您快速识别和查找。
         所属分组	此处选择已创建的API分组。
         URL	请求方法：接口调用方式，此处选择“ANY”。 请求协议：选择API请求协议，此处选择“HTTPS”。 子域名：API分组创建后，系统为分组自动分配一个内部测试用的调试域名，此调试域名每天最多可以访问1000次。 路径：接口请求路径。
         网关响应	API网关未能成功处理API请求，从而产生的错误响应。默认网关响应为“default”。
         匹配模式	此处选择“前缀匹配”。
         安全认证	选择API认证方式，此处选择“无认证”。（无认证模式，安全级别低，所有用户均可访问，不推荐在实际业务中使用）

      3. 配置后端信息后，单击“下一步”。

         表6 HTTP/HTTPS类型定义后端服务

         参数	配置说明
         负载通道	选择“使用”负载通道访问后端服务。
         URL	请求方法：接口调用方式，此处选择“ANY”。 请求协议：选择协议类型，此处选择“HTTP”。 负载通道：填写已创建的负载通道。 路径：后端服务的路径。

      4. 定义返回结果后，单击“完成”。
   3. 调试API。

      在“API运行”页签中，单击“调试”，进入调试页面。再次单击“调试”，响应结果中返回状态码“200”，表示调试成功，执行下一步。否则，请参考错误码章节处理。

   4. 发布API。

      在“API运行”页签中，单击“发布最新版本”，默认选择“RELEASE”环境，单击“确定”。发布按钮左上角的感叹号消失，表示发布成功，执行下一步。否则，根据错误信息提示修改。

3. 调用API。
   1. 绑定独立域名。

      在API分组详情页面单击“分组信息”页签。调试域名仅供开发测试使用，且每天最多访问1000次，因此用户需要绑定独立域名来访问分组内的API。

      单击“绑定独立域名”，绑定已注册好的公网域名。绑定域名具体操作请参见绑定域名章节。

   2. 复制API的URL到浏览器进行调用。

      在“API运行”页面，复制API的URL。打开浏览器，在地址栏输入API的URL进行访问。显示创建API时填写的成功响应示例，表示调用成功。

      图1 复制URL示例
      

      至此，实现了通过创建负载通道的方式开放CCE工作负载。

方式二：通过导入云容器引擎CCE工作负载开放CCE工作负载

1. 导入CCE工作负载。
   1. 进入API网关控制台，在左侧导航栏上方选择实例。
   2. 在左侧导航栏中选择“API管理 > API分组”。
   3. 单击“创建API分组 > 导入CCE工作负载”。
      1. 填写导入CCE工作负载的信息。

         表7 工作负载信息配置

         参数	配置说明
         所属分组	默认为“生成新的分组”。
         集群	选择已创建的集群。
         命名空间	选择已创建集群中的命名空间，此处选择“default”。
         工作负载类型	此处选择“无状态负载 Deployment”，与已创建的工作负载类型保持一致。
         服务标识名	此处选择已创建的工作负载中的Pod标签“app”和“deployment-demo”，指定工作负载。
         服务标识值
         标签	自动选择工作负载的另外一个Pod标签“version=v1”。

      2. 配置生成的API信息。

         表8 配置生成的API信息

         参数	配置说明
         请求协议	API请求协议，默认选择“HTTPS”协议。
         请求路径前缀	API的请求路径的前缀匹配字符串，可按需手动填写，默认为“/”。此处填写为“/”。
         端口	此处填写“80”，与已创建工作负载中的容器端口一致。
         安全认证	默认为“无认证”。（无认证模式，安全级别低，所有用户均可访问，不推荐在实际业务中使用）
         支持跨域CORS	默认不开启。
         后端超时（ms）	填写后端超时时间默认为“5000”。

   4. 单击“完成”。CCE工作负载导入成功，并生成API分组、API和负载通道。

2. 查看生成的API及相应负载通道。
   1. 查看生成的API。
      1. 单击已创建的API分组名称，进入“API运行”页签，可查看API的名称、请求方法、发布状态等。
      2. 单击“后端配置”页签，查看API绑定的负载通道。
   2. 查看生成的负载通道。
      1. 在左侧导航栏中“API管理 > API策略”。
      2. 在“负载通道”页签中，查看负载通道。
   3. 确认生成的负载通道与API所绑定的负载通道一致后，执行下一步。否则，重复1。

3. 开放API。
   通过“导入CCE工作负载”开放CCE工作负载时，已经自动创建API分组与API。因此，只需要将API发布到对应的环境中即可。

   1. 调试API。

      在“API运行”页签中，单击“调试”，进入调试页面。再次单击“调试”，响应结果中返回状态码“200”，表示调试成功，执行下一步。否则，请参考错误码章节处理。

   2. 发布API。

      在“API运行”页签中，单击“发布最新版本”，默认选择“RELEASE”环境，单击“确定”。发布按钮左上角的感叹号消失表示发布成功，执行下一步。

4. 调用API。
   1. 绑定独立域名。

      在API分组详情页面单击“分组信息”页签。调试域名仅供开发测试时使用，且每天最多访问1000次，因此用户需要绑定独立域名来访问分组内的API。

      单击“绑定独立域名”，绑定已注册好的公网域名。绑定域名具体操作请参见绑定域名章节。

   2. 复制API的URL到浏览器进行调用。

      在“API运行”页面，复制API的URL。打开浏览器，在地址栏输入API的URL进行访问。显示创建API时填写的成功响应示例，表示调用成功。

      图2 复制URL示例
      

      至此，实现了通过一键式“导入CCE工作负载”的方式来开放CCE工作负载服务的能力。

（可选）配置工作负载标签实现灰度发布

灰度发布是服务发布策略之一，旨在通过调整流量分配权重，逐步将流量从旧版本引导到新版本实例上。服务发布升级过程中可以逐步验证版本是否符合预期，如果版本符合预期，则可以逐渐加大新版本实例流量占比，减小旧版本实例流量占比，直至将新版本服务权重增加到100，旧版本服务权重减少至0，完成从旧版本到新版本服务的引流。

图3 灰度发布示意图

云容器引擎CCE工作负载根据Pod标签的标签选择器配置实现灰度发布，实现原理请参见使用Service实现简单的灰度发布和蓝绿发布，帮助用户实现新功能的快速上线与验证，进而完成流量引导与服务器切换。

下文完成特性从V1版本到V2版本的切换，保证服务升级的过程中流量平稳切换，通过灰度发布逐步将流量从V1版本迁移到V2版本。

1. 新建工作负载并设置“Pod标签”，且app值与已创建工作负载的app值一致。具体步骤请参考已创建的工作负载。

   您可以在“高级配置 > 标签与注释”中设置“Pod标签”，此处为“app=deployment-demo”，“version=v2”。如果您是通过导入YAML创建工作负载，也可以在yaml中添加“Pod标签”。

2. 调整Pod标签为“version= v1”的服务器分组的权重。
   1. 在API网关控制台的左侧导航栏上方选择实例。
   2. 在左侧导航栏中选择“API管理 > API策略”。
   3. 在“负载通道”页签中，单击已创建的负载通道名称。
   4. 在“后端服务器地址”区域，单击“编辑”。
   5. 将“权重分配”改为“100”，并单击“确定”。

      权重分配即为流量转发的权重。此时，全部流量都将转发到服务器分组“server_group_v1”中的实例ip上。

3. 创建Pod标签为“version= v2”的服务器分组并设置权重分配。
   1. 在“后端服务器地址”区域，单击“创建服务器分组”。

      表9 服务器分组配置

      参数	配置说明
      服务器分组名称	此处填写为“server_group_v2”。
      权重分配	此处填写为“1”。
      后端服务端口	此处填写为“80”。
      标签	此处选择Pod标签“version=v2”

   2. 单击“确定”。

4. 刷新后端服务器地址。

   通过刷新页面来刷新后端服务器的地址，负载通道将自动监测工作负载下的实例IP地址并动态添加到后端服务地址中。如下图所示，根据标签“app=deployment-demo”，“version=v2”能够自动匹配到已创建工作负载的实例ip，即后端服务器地址。

   图4 自动匹配工作负载的实例ip
   

   此时流量权重分配到“server_group_v1”分组的比例为100/101（服务器分组权重/服务器分组权重之和），分配到“server_group_v2”分组的比例为1/101（服务器分组权重/服务器分组权重之和），将有小部分请求被引流到“server_group_v2”分组的新版本上。

   图5 单击页面右上角编辑查看
   

5. 验证新特性通过灰度发布到V2版本是否运行稳定。

   您可以自行验证新版本功能是否符合预期，如果符合预期请执行6。否则，新特性发布失败。

6. 逐步调整不同版本服务器分组的权重配置。

   逐步减小“server_group_v1”分组的权重，增大“server_group_v2”分组的权重。重复5~6，直到“server_group_v1”分组的权重为“0”，“server_group_v2”分组的权重为“100”。

   

   如图，表示请求转发时，分配到服务器分组“server_group_v1”的比例为0，服务器分组“server_group_v2”的比例为100%，即请求将全部转发到服务器分组“server_group_v2”上，完成从“version=v1”的工作负载“deployment-demo”到“version=v2”的工作负载“deployment-demo2”之间的切换，进而实现了新特性从V1版本到V2版本的灰度发布。（注意：请求转发的流量权重分配比例可自行设置与调整）

7. 删除Pod标签为“version= v1”的服务器后端分组server_group_v1。

   现已将全部流量引导到“version= v2”的服务器后端分组的后端服务地址上，因此，可将V1版本所在服务器后端分组删除。

   1. 进入API网关控制台的负载通道详情页面，在“后端服务器地址”区域逐个将V1版本后端服务器地址列表中的IP地址移除。
   2. 然后单击“后端服务器地址”区域右侧的“移除”，删除“version= v1”的服务器后端分组。

      保留Pod标签为“version= v2”的服务器后端分组“server_group_v2”分组。