# 创建金丝雀发布任务 应用工作台基于开源项目 [Argo Rollout](https://argoproj.github.io/argo-rollouts/) 提供强大的灰度发布能力。灰度发布可以在不影响老版本的前提下,发布新的应用版本。按照预先定义的规则,渐进式地将流量切换到新版本,当新版本运行无问题后,最终自动将全部流量从老版本迁移至新版本。 ## 前提条件 1. 创建一个[工作空间](../../../ghippo/user-guide/workspace/workspace.md)和一个[用户](../../../ghippo/user-guide/access-control/user.md),该用户需加入该工作空间并具备 `Workspace Editor` 角色。 - 创建一个应用并开启`灰度发布`,可参考[基于 Git 仓构建微服务应用](../wizard/create-app-git.md)、[基于 Jar 包部署 Java 应用](../wizard/jar-java-app.md)。 - 发布对象所在的集群已经安装了 Istiod 和 Argo Rollout 两个组件。有关具体的安装方式,可参考[管理 Helm 应用](../../../kpanda/user-guide/helm/helm-app.md)。 ## 操作步骤 1. 进入`应用工作台`模块,在左侧导航栏点击 `灰度发布`,然后在页面右上角点击`创建发布任务`->`金丝雀发布`。 ![进入创建页面](https://docs.daocloud.io/daocloud-docs-images/docs/amamba/images/canary01.png) 2. 参考下列要求填写基本信息,然后点击`下一步`。 - 名称:填写发布任务的名称。最长 63 个字符,只能包含小写字母、数字及分隔符("-"),且必须以小写字母或数字开头及结尾 - 集群:选择发布对象所在的集群。需要确保该集群已经部署了 Istio 和 Argo Rollout。 - 命名空间:选择发布对象所在的命名空间,且该命名空间中已经部署了开启了`灰度发布`的应用。 - 无状态负载:选择具体的发布对象。 ![基本信息](https://docs.daocloud.io/daocloud-docs-images/docs/amamba/images/canary02.png) 3. 参考下列说明配置发布规则。 - 实例数量:进行灰度发布任务时应用的副本数量。 - 流量调度策略: - 当前阶段发布流量比例:每个流量周期内,为灰度版本增加的流量比例。 - 到达流量比例后等待时间:为灰度版本增加流量周期,即等待多久后自动进入下一个灰度流量比例。 > 如果设置为 0 或不填写,发布任务执行到此步骤时会永久暂停。 - 监控分析:开启后即可利用 Prometheus 的能力进行监控。根据预先定义的监控指标以及采集间隔,在整个发布过程中自动执行监控分析。如果不满足定义的规则,则自动回滚至旧版本,灰度发布失败。 ![设置发布规则](https://docs.daocloud.io/daocloud-docs-images/docs/amamba/images/canary03.png) 4. 在页面底部点击`创建并更新应用`,然后在弹框中设置灰度版本的镜像地址并点击`确定`。 此时原工作负载的副本数会被设置为 0。 ![填写镜像地址](https://docs.daocloud.io/daocloud-docs-images/docs/amamba/images/canary04.png) 5. 系统自动跳转至灰度发布的任务列表页面,提示`更新版本成功`。 ![返回列表](https://docs.daocloud.io/daocloud-docs-images/docs/amamba/images/canary05.png)