第29章 Flagger 升级指南:从 v1alpha3 到 v1beta1
第29章 升级指南
本文档介绍了如何升级 Flagger。
将 Canary 从 v1alpha3 升级到 v1beta1
canaries.flagger.app/v1beta1 中 CRD 的变更: * `spec.canaryAnalysis` 字段已弃用,替换为 `spec.analysis` * `spec.analysis.interval` 和 `spec.analysis.threshold` 字段现在是必需的 * `status.lastAppliedSpec` 和 `status.lastPromotedSpec` 的哈希算法更改为 `hash/fnv` * `spec.analysis.alerts` 数组现在可以引用 `alertproviders.flagger.app/v1beta1` 资源 * `spec.analysis.metrics[].templateRef` 现在可以引用 `metrictemplate.flagger.app/v1beta1` 资源 * `metric.threshold` 字段已弃用,替换为 `metric.thresholdRange` * `metric.query` 字段已弃用,替换为 `metric.templateRef` * `spec.ingressRef.apiVersion` 接受 `networking.k8s.io/v1beta1` * `spec.targetRef` 现在可以引用 DaemonSet 类型 * `spec.service.meshName` 字段已弃用,不再用于 `provider: appmesh:v1beta2`
升级步骤: 1. 安装 v1beta1 CRDs 2. 更新 Flagger deployment 3. 在所有 canary 清单中,将 `apiVersion: flagger.app/v1alpha3` 替换为 `apiVersion: flagger.app/v1beta1` 4. 在所有 canary 清单中,将 `spec.canaryAnalysis` 替换为 `spec.analysis` 5. 更新集群中的 canary 清单
注意: 升级 Flagger 后,由于用于跟踪变更的哈希值计算方式不同,所有 canary 都会触发。你可以在升级 Flagger 之前在所有 canary 清单中设置 `spec.skipAnalysis: true`,执行升级,等待 Flagger 完成无操作(no-op)晋升,最后将 `skipAnalysis` 设为 false。
更新内置指标: * 对于 request-success-rate,将 threshold 替换为 `thresholdRange.min` * 对于 request-duration,将 threshold 替换为 `thresholdRange.max`
Istio 遥测 v2
Istio 1.5 对 Flagger 的使用带来了破坏性变更。在 Istio 遥测 v2 中,指标 `istio_request_duration_seconds_bucket` 已被移除并替换为 `istio_request_duration_milliseconds_bucket`,这会导致 request-duration 指标检查失效。
如果你使用的是 Istio 1.4,可以创建一个使用旧 duration 指标的 metric 模板,如下所示:
[此处原代码/图片缺失,根据上下文推测应展示创建 template 的示例]
在 canary 清单中,将 request-duration 指标替换为 latency:
[此处原代码/图片缺失,根据上下文推测应展示替换后的示例]
## 上一个版本发布说明 最后更新于 5 年前