---
title: 兼容版本
description: 配置“兼容版本”将行为变更与版本发布解耦。
weight: 36
keywords: [profiles,install,helm]
owner: istio/wg-environments-maintainers
test: n/a
---

Istio 的每个新版本都可能会出现一些有意而为的行为变更。
这些变更可能是为了提高安全性、修复不正确的行为或以其他方式改进 Istio 用户的体验。
一般来说，这些类型的变更仅影响少量场景。

虽然从长远来看是有益的，但每次行为变更都会在升级过程中带来风险。
从以往经验上看，升级时用户应该通过阅读发布说明来了解所有的行为变更并确定自己是否会受到影响；
这可能很乏味并且容易出错。

兼容版本为用户提供了额外的选项，允许发布版本与行为变更解耦。
例如，您可以安装 Istio {{< istio_version >}}，
但将其行为配置为类似于 {{< istio_previous_version >}}。

## 使用兼容版本 {#using-compatibility-versions}

要使用兼容版本，只需设置 `compatibilityVersion` 字段即可。

{{< tabset category-name="安装" >}}
{{< tab name="IstioOperator" category-value="iop" >}}

{{< text shell >}}
$ istioctl install --set values.compatibilityVersion={{< istio_previous_version >}}
{{< /text >}}

{{< /tab >}}
{{< tab name="Helm" category-value="helm" >}}

{{< text shell >}}
$ helm install ... --set compatibilityVersion={{< istio_previous_version >}}
{{< /text >}}

{{< /tab >}}
{{< /tabset >}}

## 什么时候应该使用兼容版本？ {#when-should-i-use-compatibility-versions}

仅当版本之间存在不兼容时，才应使用兼容版本作为临时措施。您应尽快计划迁移到新行为。

当兼容版本所指的版本达到使用寿命时，该兼容版本将被移除，并且将不再受支持。
请参阅[当前 Istio 版本支持状态图表](/zh/docs/releases/supported-releases/#support-status-of-istio-releases)了解特定版本的状态。

为了帮助检测是否应使用兼容版本，可以将
`istioctl x precheck` 与 `--from-version` 标志一同使用。
例如，如果您要从版本 {{< istio_previous_version >}} 升级：

{{< text shell >}}
$ istioctl x precheck --from-version {{< istio_previous_version >}}
Warning [IST0168] (DestinationRule default/tls) The configuration "ENABLE_AUTO_SNI" changed in release 1.20: previously, no SNI would be set; now it will be automatically set. Or, install with `--set compatibilityVersion=1.20` to retain the old default.
Error: Issues found when checking the cluster. Istio may not be safe to install or upgrade.
See https://istio.io/v1.21/docs/reference/config/analysis for more information about causes and resolutions.
{{< /text >}}