使用 Helm 升级

请参阅本指南,以升级使用 Helm 安装的 Istio 控制平面和 sidecar 代理。升级过程可能会安装新的二级制文件,并可能修改配置和 API schema。升级过程可能导致服务停机。为了减少停机时间,请确保 Istio 控制平面组件和应用程序是多副本高可用的。

在将 Istio 版本升级到 1.12 之前,请务必查看[升级说明]。

Istio 不支持 跨版本升级。仅支持从 1.11 版本升级到 1.12 版本。如果您使用的是旧版本,请先升级到 1.11 版本。

升级步骤

下载新版本 Istio,并切换目录到新版本的目录下。

Istio CNI 升级

如果您已经安装或计划安装 Istio CNI,请选择以下 互斥 选项之一,检查 Istio CNI 是否已经安装并进行升级:

您可以使用 Kubernetes 的滚动更新机制来升级 Istio CNI 组件。这适用于使用 kubectl apply 部署 Istio CNI 的情况。

  1. 检查是否已安装 istio-cni。找到 istio-cni-node pod 以及它们运行的命名空间(通常是 kube-systemistio-system):

    1. $ kubectl get pods -l k8s-app=istio-cni-node --all-namespaces
    2. $ NAMESPACE=$(kubectl get pods -l k8s-app=istio-cni-node --all-namespaces --output='jsonpath={.items[0].metadata.namespace}')
  2. 如果 istio-cni 安装在 kube-system 以外的命名空间(例如:istio-system),请删除 istio-cni

    1. $ helm template install/kubernetes/helm/istio-cni --name=istio-cni --namespace=$NAMESPACE | kubectl delete -f -
  3. kube-system 命名空间中安装或升级 istio-cni

    1. $ helm template install/kubernetes/helm/istio-cni --name=istio-cni --namespace=kube-system | kubectl apply -f -

如果您已使用 Helm and Tiller 安装 Istio CNI,请优先使用 Helm 升级 Istio CNI。

  1. 检查 istio-cni 是否已安装,并检查安装在哪个命名空间:

    1. $ helm status istio-cni
  2. 根据下面几种情况来安装或升级 istio-cni

    • 如您尚未安装 istio-cni,并决定安装它,则运行以下命令:

      1. $ helm install install/kubernetes/helm/istio-cni --name istio-cni --namespace kube-system
    • 如果 istio-cni 已被安装到 kube-system 以外的命名空间(例如:istio-system)中,请先运行以下命令删除:

      1. $ helm delete --purge istio-cni

      然后,将其安装到 kube-system 命名空间中:

      1. $ helm install install/kubernetes/helm/istio-cni --name istio-cni --namespace kube-system
    • 如果 istio-cni 已被安装到命名空间 kube-system 中,则运行以下命令升级:

      1. $ helm upgrade istio-cni install/kubernetes/helm/istio-cni --namespace kube-system

控制平面升级

Pilot, Galley, 策略, 遥测和 Sidecar 注入器。 选择下列 互斥 选项中的一种升级控制平面:

您可以使用 Kubernetes 的滚动升级机制来升级控制平面组件。这适用于使用 kubectl apply 部署 Istio 组件的情况,包括使用 Helm template 生成的配置。

  1. 使用 kubectl apply 命令升级所有 Istio 的 CRD。等待 Kubernetes API 服务器提交升级的 CRD:

    1. $ kubectl apply -f install/kubernetes/helm/istio-init/files/
  2. 等待所有的 Istio CRD 创建完成:

  1. $ kubectl -n istio-system wait --for=condition=complete job --all
  1. 应用更新模板:

    1. $ helm template install/kubernetes/helm/istio --name istio \
    2. --namespace istio-system | kubectl apply -f -

    您必须使用与首次安装 Istio 相同的配置。

滚动更新进程会将所有的部署组件和 configmap 升级到新版本。当此进程执行完毕后,您的 Istio 控制平面将会升级到新版本。

您现有的应用程序无需任何更改,可以继续运行。如果新的控制平面有任何严重的问题,您可以通过应用旧版本的 yaml 文件来回滚此次变更。

如果您使用 Helm and Tiller 安装 Istio,推荐的方式是使用 Helm 来进行升级。

  1. 升级 istio-init chart 来更新所有 Istio 用户资源定义(CRD)。

    1. $ helm upgrade --install istio-init install/kubernetes/helm/istio-init --namespace istio-system
  2. 等待所有的 Istio CRD 创建完成:

  1. $ kubectl -n istio-system wait --for=condition=complete job --all
  1. 升级 istio chart:

    1. $ helm upgrade istio install/kubernetes/helm/istio --namespace istio-system

    如果安装了 Istio CNI,则通过添加 --set istio_cni.enabled=true 配置项来启用它。

Sidecar 升级

在升级控制平面后,已运行 Istio 的应用仍将使用旧的 sidecar。要升级 sidecar,您需要重新注入它。

如果您使用自动的 sidecar 注入方式,可以滚动更新所有 pod 来升级 sidecar。这样,新版本的 sidecar 将被自动重新注入。

要运行以下命令,kubectl 的版本需要 >= 1.15,必要时请进行升级。

  1. $ kubectl rollout restart deployment --namespace default

如果使用手动注入,可以通过以下命令升级 sidecar:

  1. $ kubectl apply -f <(istioctl kube-inject -f $ORIGINAL_DEPLOYMENT_YAML)

如果 sidecar 之前使用了一些定制的配置文件注入,则需要将配置文件中的版本更改为新版本,并通过以下命令重新注入:

  1. $ kubectl apply -f <(istioctl kube-inject \
  2. --injectConfigFile inject-config.yaml \
  3. --filename $ORIGINAL_DEPLOYMENT_YAML)