From 7da22a09fc3c1b943f58087516ec6c910aa953ac Mon Sep 17 00:00:00 2001 From: MXuDong <34544445+MXuDong@users.noreply.github.com> Date: Sun, 14 Mar 2021 12:26:47 +0800 Subject: [PATCH] trans it (#9207) --- .../zh/docs/setup/upgrade/in-place/index.md | 82 +++++++++++++++++++ 1 file changed, 82 insertions(+) create mode 100644 content/zh/docs/setup/upgrade/in-place/index.md diff --git a/content/zh/docs/setup/upgrade/in-place/index.md b/content/zh/docs/setup/upgrade/in-place/index.md new file mode 100644 index 0000000000..d7dcf766d9 --- /dev/null +++ b/content/zh/docs/setup/upgrade/in-place/index.md @@ -0,0 +1,82 @@ +--- +title: 热升级 +description: 热升级和回退。 +weight: 20 +keywords: [kubernetes,upgrading,in-place] +owner: istio/wg-environments-maintainers +test: no +--- + +通过 `istioctl upgrade` 命令对 Istio 进行升级。在开始升级之前，该命令会自动检查 Istio 的安装是否满足升级需求。同时，如果该命令检测到 Istio 与当前版本的配置文件默认值存在变动时，会警告用户。 + +Istio 的升级指令同样可以执行将回退操作。 + +阅读 [`istioctl` 升级参考](/zh/docs/reference/commands/istioctl/#istioctl-upgrade)来了解 `istoictl upgrade` 指令提供的全部参数。 + +{{< warning >}} +`istioctl upgrade` 用于热升级，并且与使用 `--revision` 参数进行的安装不兼容。此类安装的升级将失败，并显示错误。 +{{< /warning >}} + +## 升级的前置条件{#upgrade-prerequisites} + +在您执行升级之前，请检查以下条件： + +* 安装的 Istio 版本与升级的目标版本之间至最多差一个 minor 版本。例如，如果要升级到1.7.x版本，需要至少1.6.0或更高版本。 + +* 您是[使用 {{< istioctl >}} 安装](/zh/docs/setup/install/istioctl/)的 Istio. + +## 升级步骤{#upgrade-steps} + +{{< warning >}} +在升级过程中，服务可能会发生流量中断。为了最大程度的减少中断，请确保每个组件（Citadel 除外）至少有两个副本正在运行。另外，请确保 [`PodDisruptionBudgets`](https://kubernetes.io/docs/tasks/run-application/configure-pdb/) 配置的最低可用行为1。 +{{< /warning >}} + +本节所使用的所有命令应该使用新版本的 `istioctl` 运行，可执行文件可以在下载包的 `bin/` 目录下找到。 + +1. [下载新版 Istio](/zh/docs/setup/getting-started/#download)，并且切换到该目录。 + +1. 确保您的 Kubernetes 配置指向的是要升级的集群： + + {{< text bash >}} + $ kubectl config view + {{< /text >}} + +1. 通过该执行进行升级： + + {{< text bash >}} + $ istioctl upgrade + {{< /text >}} + + {{< warning >}} + 如果您使用 `-f` 参数安装 Istio，那么您必须提供同样的 `-f` 参数值来执行 `istioctl upgrade` 指令。例如：`istioctl install -f `。 + {{< /warning >}} + + 如果您使用了 `--set` 参数安装 Istio，请确保使用同样的 `--set` 参数值来升级，否则升级过程将会还原 `--set` 的参数。如果在生产环境，建议您使用配置文件而不是 `--set` 参数进行安装。 + + 如果您没有设置 `-f` 参数，Istio 将会使用默认 profile 升级。 + + 执行几次检查后，`istioctl` 将会询问您是否需要继续升级。 + +1. `istioctl` 会将 Istio 的控制平面和网关升级到新版本，并显示完成状态。 + +1. 在 `istioctl` 完成升级后，您必须通过重启 Pod 的 Sidecar 来手动更新 Istio 的数据平面。 + + {{< text bash >}} + $ kubectl rollout restart deployment + {{< /text >}} + +## 版本回退的前置条件{#downgrade-prerequisites} + +在您开始进行版本回退的时候，请检查以下前置条件： + +* 您是[使用 {{< istioctl >}} 安装](/zh/docs/setup/install/istioctl/)的 Istio. + +* 安装的 Istio 版本与回退的目标版本之间至最多差一个 minor 版本。例如，您可以从 1.7.x 版本降级到最小 1.6.0 版本。 + +* 回退需要使用回退目标版本的二进制 `istioctl` 指令完成。例如，如果您要从Istio 1.7 降级到 1.6.5，请使用 1.6.5 的 `istioctl`。 + +## 回退版本操作步骤{#steps-to-downgrade-to-a-lower-Istio-version} + +您可以使用 `istioctl upgrade` 来回退 Istio 到低版本。回退步骤与上一步中所述的升级过程相同，不过需要使用较低版本（例如 1.6.5) 的 `istioctl` 二进制文件。完成后，Istio 将会更新到低版本。 + +另外，`istioctl install` 可用于安装旧版 `istio` 的控制平面，但是不建议将使用，因为这个过程不会执行任何检查。例如，用于配置集群的配置文件的某些默认值可能会发生变动，但是不会发出任何警告。