备案控制台
文档
产品文档
输入文档关键字查找
首页 容器服务 Kubernetes 版 ACK 分布式云容器平台 ACK One 实践教程 多集群舰队最佳实践 ACK One GitOps最佳实践 基于ACK One Gitops使用Kruise Rollout实现金丝雀发布

基于ACK One Gitops使用Kruise Rollout实现金丝雀发布

更新时间：
一键部署
产品详情
相关技术圈
我的收藏

ACK One整合了ArgoCD GitOps的能力，同时结合渐进式发布组件Kruise Rollout，通过Git Commit实现全自动的金丝雀发布。本文介绍如何通过ACK One GitOps结合Kruise Rollout组件快速构建应用的金丝雀发布能力。

前提条件

  • 已开启舰队管理功能。具体操作，请参见开启舰队管理功能。

  • 已创建ACK集群，并将其关联至ACK One Fleet实例。具体操作，请参见创建Kubernetes托管版集群和添加关联集群。

    • 如需使用A/B Testing或金丝雀发布的能力，集群版本需为1.19及以上版本。

    • 如需使用分批发布能力，则集群版本需为1.16及以上版本。

  • 已从ACK One控制台获取Fleet实例的KubeConfig，并通过kubectl连接至Fleet实例。

  • 已安装kubectl-kruise。关于kubectl-kruise安装路径，请参见kubectl-kruise。

Kruise Rollout介绍

Kruise Rollout是OpenKruise社区开源的渐进式交付框架。Kruise Rollout支持配合流量和实例灰度的灰度发布、蓝绿发布、A/B Testing发布。基于Prometheus Metrics指标，Kruise Rollout还可以实现发布过程的自动化分批与暂停，并提供旁路的无感对接、兼容已有的多种工作负载（Deployment、CloneSet、StatefulSet）。更多信息，请参见Kruise Rollout。

Kruise Rollout是一种旁路式的工作机制。您只需配置一份Rollout资源并将其下发到K8s集群中，后续的业务发布、升级均无需额外操作，并且可以与Helm、PaaS平台低成本地无缝对接。使用Kruise Rollout实现灰度发布架构如下图所示。gray

注意事项

  • 如果您选择GitHub仓库，则不推荐使用中国内地地域。如需在中国内地地域运行，您可以选择适合的Git服务提供商。

  • 本文舰队管理的Fleet实例和关联的ACK集群的地域均以中国香港地域为例。

步骤一：在ACK集群中部署Kruise Rollout组件

安装Kruise Rollout组件。

  1. 登录容器服务管理控制台，在左侧导航栏选择集群。

  2. 在集群列表页面，单击目标集群名称，然后在左侧导航栏，选择运维管理 > 组件管理。

  3. 在组件管理页面，单击应用管理页签，然后在ack-kruise卡片右下方，单击安装。

  4. 在弹出的对话框确认信息后，单击确定。

步骤二：使用ACK One GitOps发布应用

通过GitOps发布应用支持以下两种方式。

  • 通过ArgoCD CLI的方式发布应用。下文以此方式为例，介绍如何使用GitOps发布应用。

  • 通过GitOps控制台发布应用。具体操作，请参见GitOps使用快速入门。

  1. 执行以下命令，添加Git Repo。

    argocd repo add https://github.com/openkruise/samples.git --name gitops-demo

    预期输出：

    Repository 'https://github.com/openkruise/samples.git' added

    执行以下命令，查看已添加的Git Repo列表。

    argocd repo list

    预期输出：

    TYPE NAME REPO INSECURE OCI LFS CREDS STATUS MESSAGE PROJECT
git gitops-demo https://github.com/openkruise/samples.git false false false false Successful

  1. 执行以下命令，查看Cluster列表。

    argocd cluster list

    预期输出：

    SERVER NAME VERSION STATUS MESSAGE PROJECT
https://192.168.XX.XX:6443 c76073b011afb4de2a8****-ack-gitops-demo-192-10-110-0-0-16 1.26+ Successful
https://kubernetes.default.svc in-cluster Unknown Cluster has no applications and is not being monitored.

  1. 执行以下命令，通过Application方式创建应用，其中revision为稳定版本的Tag。

    argocd app create rollouts-demo --repo https://github.com/openkruise/samples.git --project default --sync-policy none --revision gitops-demo-version-stable --path gitops-demo --dest-namespace default --dest-server https://192.168.XX.XX:6443

  1. 执行以下命令，查看应用列表。

    argocd app list

    预期输出：

    NAME CLUSTER NAMESPACE PROJECT STATUS HEALTH SYNCPOLICY CONDITIONS REPO PATH TARGET

rollouts-demo https://192.168.XX.XX:6443 default default OutOfSync Healthy <none> <none> https://github.com/openkruise/samples.git gitops-demo 616b4b6

  1. 执行以下命令，同步应用。

    argocd app sync rollouts-demo

    预期输出：

    Name: argocd/rollouts-demo
Project: default
Server: https://192.168.XX.XX:6443
Namespace: default
URL: https://127.0.0.1:61231/applications/rollouts-demo
Repo: https://github.com/openkruise/samples.git
Target: 616b4b6
Path: gitops-demo
SyncWindow: Sync Allowed
Sync Policy: <none>
Sync Status: Synced to 616b4b6
Health Status: Progressing

Operation: Sync
Sync Revision: 616b4b6e010ba4d71a92c0e7d050162956b169b7
Phase: Succeeded
Start: 2023-08-07 16:02:12 +0800 CST
Finished: 2023-08-07 16:02:13 +0800 CST
Duration: 1s
Message: successfully synced (all tasks run)

GROUP KIND NAMESPACE NAME STATUS HEALTH HOOK MESSAGE
 Service default echo-server Synced Healthy service/echo-server created
apps Deployment default echo-server Synced Progressing deployment.apps/echo-server created
networking.k8s.io Ingress default ingress-demo Synced Progressing ingress.networking.k8s.io/ingress-demo created
rollouts.kruise.io Rollout default rollouts-demo Synced rollout.rollouts.kruise.io/rollouts-demo created

  1. 在ArgoCD UI中Applications中单击rollouts-demo应用，应用详情如下图所示。

    image.png

  1. 执行以下命令，查看Rollouts运行状态。

    kubectl get rollout --kubeconfig <子集群KubeConfig文件路径>
    重要

    • 查看Rollouts运行状态需要在子集群查看，通过kubectl get rollout查看时需要指定子集群的KubeConfig文件路径。

    • 您也可以通过设置KUBECONFIG环境变量或其他方式来切换到子集群的KubeConfig。

    预期输出：

    NAME STATUS CANARY_STEP CANARY_STATE MESSAGE AGE
rollouts-demo Healthy 4 Completed workload deployment is completed 3m22s

步骤三：开始金丝雀发布

Git仓库中的rollout.yaml文件为Rollouts配置文件。rollout配置如下所示，发布过程分为四步：

  • 将旧版本应用的20%更新为新版本应用，并将20%的流量转发至新版本应用中，需要手动确认继续发布

  • 将旧版本应用的40%更新为新版本应用，并将40%的流量转发至新版本应用中，暂停60秒后自动继续发布

  • 将旧版本应用的60%更新为新版本应用，并将60%的流量转发至新版本应用中，暂停60秒后自动继续发布

  • 将旧版本应用的80%更新为新版本应用，并将80%的流量转发至新版本应用中，暂停60秒后自动继续发布

apiVersion: rollouts.kruise.io/v1alpha1
kind: Rollout
metadata:
  name: rollouts-demo
  annotations:
    rollouts.kruise.io/rolling-style: partition
spec:
  objectRef:
    workloadRef:
      apiVersion: apps/v1
      kind: Deployment
      name: echo-server
  strategy:
    canary:
      steps:
      - replicas: 20%
        weight: 20 # 该发布步骤不设置暂停时间，需要手动确认继续发布
      - replicas: 40%
        weight: 40
        pause:
          duration: 60
      - replicas: 60%
        weight: 60
        pause:
          duration: 60
      - replicas: 80%
        weight: 80
        pause:
          duration: 60
      trafficRoutings:
      - service: echo-server
        ingress:
          classType: nginx
          name: ingress-demo

  1. 执行以下命令，同步应用至新版本，其中revision为新版本的Tag。

    argocd app sync rollouts-demo --revision gitops-demo-version-canary

    预期输出：

    Name: argocd/rollouts-demo
Project: default
Server: https://192.168.XX.XX:6443
Namespace: default
URL: https://127.0.0.1:62461/applications/rollouts-demo
Repo: https://github.com/openkruise/samples.git
Target: 616b4b6
Path: gitops-demo
SyncWindow: Sync Allowed
Sync Policy: <none>
Sync Status: OutOfSync from 616b4b6
Health Status: Progressing

Operation: Sync
Sync Revision: 3d14cc011bb090dd2243f70a3741e9b8f5332cb9
Phase: Succeeded
Start: 2023-08-07 16:20:07 +0800 CST
Finished: 2023-08-07 16:20:07 +0800 CST
Duration: 0s
Message: successfully synced (all tasks run)

GROUP KIND NAMESPACE NAME STATUS HEALTH HOOK MESSAGE
 Service default echo-server Synced Healthy service/echo-server unchanged
apps Deployment default echo-server OutOfSync Suspended deployment.apps/echo-server configured
networking.k8s.io Ingress default ingress-demo Synced Progressing ingress.networking.k8s.io/ingress-demo unchanged
rollouts.kruise.io Rollout default rollouts-demo Synced rollout.rollouts.kruise.io/rollouts-demo configured

  1. 等待本步完成，在执行以下命令，查看Rollouts运行状态。

    kubectl get rollout --kubeconfig <子集群KubeConfig文件路径>
    重要

    • 查看Rollouts运行状态需要在子集群查看，通过kubectl get rollout查看时需要指定子集群的KubeConfig文件路径。

    • 您也可以通过设置KUBECONFIG环境变量或其他方式来切换到子集群的KubeConfig。

    预期输出如下，提示需要手动继续下一步发布：

    NAME STATUS CANARY_STEP CANARY_STATE MESSAGE AGE
rollouts-demo Progressing 1 StepPaused Rollout is in step(1/4), and you need manually confirm to enter the next step 7m57s

  1. 执行以下命令，恢复金丝雀发布。

    kubectl-kruise rollout approve rollout/rollouts-demo  --kubeconfig <子集群KubeConfig文件路径>
    重要

    • 需要在子集群执行kubectl-kruise命令来恢复发布，命令中需要指定子集群的KubeConfig文件路径。

    • 您也可以通过设置KUBECONFIG环境变量或其他方式来切换到子集群的KubeConfig。

    预期输出：

    rollout.rollouts.kruise.io/rollouts-demo approved

  1. 等待本步完成，执行以下命令，查看Rollouts运行状态。

    kubectl get rollout --kubeconfig <子集群KubeConfig文件路径>
    重要

    • 查看Rollouts运行状态需要在子集群查看，通过kubectl get rollout查看时需要指定子集群的KubeConfig文件路径。

    • 您也可以通过设置KUBECONFIG环境变量或其他方式来切换到子集群的KubeConfig。

    预期输出如下，提示60秒后将进入下一步发布。

    NAME STATUS CANARY_STEP CANARY_STATE MESSAGE AGE
rollouts-demo Progressing 2 StepPaused Rollout is in step(2/4), and wait duration(60 seconds) to enter the next step 9m56s

  1. 之后Kruise Rollout将每隔60秒开始下一次发布，直至发布完成。

  2. 等待发布完成，执行以下命令，查看Rollouts运行状态。

    kubectl get rollout --kubeconfig <子集群KubeConfig文件路径>
    重要

    • 查看Rollouts运行状态需要在子集群查看，通过kubectl get rollout查看时需要指定子集群的KubeConfig文件路径。

    • 您也可以通过设置KUBECONFIG环境变量或其他方式来切换到子集群的KubeConfig。

    预期输出如下，提示发布完成。

    NAME            STATUS    CANARY_STEP   CANARY_STATE   MESSAGE                                  AGE
rollouts-demo   Healthy   4             Completed      Rollout progressing has been completed   15m

（可选）步骤四：金丝雀发布回滚

在金丝雀发布过程中，如果您发现应用异常，可以将应用的revison同步至旧版本commit进行回滚。

执行以下命令，同步应用至旧版本，其中revision为旧版本的Tag。

argocd app sync rollouts-demo --revision gitops-demo-version-stable

预期输出：

Project: default
Server: https://192.168.XX.XX:6443
Namespace: default
URL: https://127.0.0.1:49922/applications/rollouts-demo
Repo: https://github.com/Kuromesi/samples.git
Target: 616b4b6
Path: gitops-demo
SyncWindow: Sync Allowed
Sync Policy: <none>
Sync Status: Synced to 616b4b6
Health Status: Progressing

Operation: Sync
Sync Revision: 616b4b6e010ba4d71a92c0e7d050162956b169b7
Phase: Succeeded
Start: 2023-08-07 16:52:53 +0800 CST
Finished: 2023-08-07 16:52:54 +0800 CST
Duration: 1s
Message: successfully synced (all tasks run)

GROUP KIND NAMESPACE NAME STATUS HEALTH HOOK MESSAGE
 Service default echo-server Synced Healthy service/echo-server unchanged
apps Deployment default echo-server Synced Suspended deployment.apps/echo-server configured
networking.k8s.io Ingress default ingress-demo Synced Progressing ingress.networking.k8s.io/ingress-demo unchanged
rollouts.kruise.io Rollout default rollouts-demo Synced rollout.rollouts.kruise.io/rollouts-demo unchanged

相关文档

文档推荐
  • 本页导读 （1）
文档反馈