Alauda Service Mesh v2 Docs
  • 简体中文

    • 使用 InPlace 策略进行更新

    InPlace 更新策略一次仅运行控制平面的一个版本。在更新过程中，所有工作负载会立即连接到新的控制平面版本。为了保持 sidecar 与控制平面之间的兼容性，一次只能升级一个 minor 版本。

    InPlace 策略会就地更新并重启现有的 Istio 控制平面。在此过程中，只存在一个控制平面的实例，因此无需将工作负载迁移到新的控制平面实例。要完成更新，请重启应用工作负载和网关，以刷新 Envoy 代理。

    虽然 InPlace 策略具有简单和高效的优点，但如果在控制平面重启期间某个工作负载 Pod 发生更新、重启或扩缩容，应用流量仍有轻微中断的可能。你可以通过运行多个 Istio 控制平面（istiod）副本来降低这一风险。

    目录

    选择 InPlace 策略使用 InPlace 更新策略进行安装操作步骤使用 InPlace 策略更新 Istio 控制平面前提条件操作步骤验证从开发环境中移除 InPlace 更新资源

    选择 InPlace 策略

    要选择 InPlace 策略，请将 Istio 资源中的 spec.updateStrategy.type 值设置为 InPlace。

    选择 InPlace 更新策略的示例配置

    kind: Istio
spec:
  updateStrategy:
    type: InPlace

    你可以在创建资源时设置此值，也可以稍后再编辑。如果是在创建后编辑资源，请在更新 Istio 控制平面之前完成修改。

    为了在更新过程中尽量减少流量中断，你可以将 Istio 控制平面运行在高可用性（HA）模式下，但这需要在 Istio 资源中进行一些额外配置。更多信息，请参见 Istio 高可用性。

    使用 InPlace 更新策略进行安装

    你可以使用 InPlace 更新策略安装 Istio 控制平面、Istio CNI 和 Bookinfo 演示应用。

    NOTE

    你可以使用以下部分来了解更新过程。如果集群中已经包含 Istio 部署，则可以跳过此安装。

    使用 InPlace 策略时，Alauda Service Mesh v2 Operator 创建的 IstioRevision 资源始终与其父级 Istio 资源同名。

    操作步骤

    1. 运行以下命令创建 istio-cni 和 istio-system 命名空间：

      kubectl create ns istio-cni
kubectl create ns istio-system

    2. 将工作负载附加到使用 InPlace 策略部署的控制平面：

      • 通过输入以下命令为命名空间添加标签，以自动包含所有工作负载：

        kubectl label namespace <namespace_name> istio.io/rev=<revision_name>

      • 通过修改 Deployment 资源中的 Pod 模板，为单个工作负载应用 revision 标签。例如：

        apiVersion: apps/v1
kind: Deployment
spec:
  template:
    metadata:
      labels:
        istio.io/rev: <revision_name>

    3. 如果 revision 名称为 default，请运行以下命令将工作负载附加到该 revision。以下示例为命名空间添加 istio-injection: enabled 标签。

      kubectl label namespace <namespace_name> istio-injection=enabled

    4. 使用所需版本安装 Istio CNI 插件。以下示例配置会在 istio-cni 命名空间中创建一个名为 default 的 IstioCNI 资源：

      cat <<EOF | kubectl apply -f -
apiVersion: sailoperator.io/v1
kind: IstioCNI
metadata:
  name: default
spec:
  version: v1.26.3
  namespace: istio-cni
  values:
    cni:
      cniConfDir: /etc/cni/multus/net.d
      excludeNamespaces:
        - istio-cni
        - kube-system
EOF

    5. 使用 InPlace 更新策略部署 Istio 控制平面。以下示例配置会在 istio-system 命名空间中创建一个名为 default 的 Istio 资源：

      示例配置

      cat <<EOF | kubectl apply -f -
apiVersion: sailoperator.io/v1
kind: Istio
metadata:
  name: default
spec:
  version: v1.26.3
  namespace: istio-system
  updateStrategy:
    type: InPlace
EOF

    6. 运行以下命令，等待 Istio 控制平面就绪：

      kubectl wait --for condition=Ready istio/default --timeout=3m

    7. 配置应用工作负载在集群中运行。例如，你可以将 bookinfo 示例应用部署到 bookinfo 命名空间。

      a. 使用以下命令创建 bookinfo 命名空间：

      kubectl create ns bookinfo

      b. 为 bookinfo 命名空间添加标签，以启用自动 sidecar 注入。使用以下命令：

      kubectl label namespace bookinfo istio-injection=enabled

      c. 通过执行此命令将 bookinfo 应用 Pod 部署到 bookinfo 命名空间：

      kubectl -n bookinfo apply -f https://raw.githubusercontent.com/alauda-mesh/istio/refs/heads/istio-1.28/samples/bookinfo/platform/kube/bookinfo.yaml

    8. 使用以下命令查看 Istio 资源：

      kubectl get istio -n istio-system

      示例输出

      NAME      NAMESPACE      PROFILE   REVISIONS   READY   IN USE   ACTIVE REVISION   STATUS    VERSION   AGE
default   istio-system             1           1       1        default           Healthy   v1.26.3   6m3s

      IN USE 列中的值为 1 表示 IstioRevision 资源同时被命名空间上的标签和注入的 sidecar 代理引用。

    使用 InPlace 策略更新 Istio 控制平面

    使用 InPlace 策略更新 Istio 时，你一次只能将版本增加一个 minor 版本。如果要跨越多个 minor 版本进行更新，则必须在每次更新后递增版本并重启工作负载。重启工作负载可确保 sidecar 版本与控制平面版本兼容。所有工作负载都重启后，更新过程即完成。

    前提条件

    • 你已使用 cluster-admin 身份登录 Alauda Container Platform Web 控制台。
    • 你已安装 Alauda Container Platform Networking for Multus 插件，并且 kube-ovn 必须为 v4.1.5 或更高版本。
    • 你已部署 Istio，并将 Alauda Service Mesh v2 Operator 升级到提供新的目标 Istio 版本的版本。更多信息，请参见 了解 Operator 更新和通道。
    • 你已在本地机器上安装 istioctl。
    • 你已将 Istio 控制平面配置为使用 InPlace 更新策略。在本示例中，名为 default 的 Istio 资源部署在 istio-system 命名空间中。
    • 你已安装所需版本的 Istio CNI 插件。在本示例中，名为 default 的 IstioCNI 资源部署在 istio-cni 命名空间中。
    • 你已为 bookinfo 命名空间添加标签，以启用 sidecar 注入。
    • 你的集群中正在运行应用工作负载。在本示例中，bookinfo 应用部署在 bookinfo 命名空间中。

    操作步骤

    1. 修改 Istio 资源中的版本。例如，要更新到 Istio 1.28.6，请通过运行以下命令将 spec.version 字段设置为 v1.28.6：

      kubectl patch istio default --type='merge' -p '{"spec":{"version":"v1.28.6"}}'

      Istio CR 中的版本更新

      kind: Istio
spec:
  version: v1.28.6
  updateStrategy:
    type: InPlace

      Service Mesh v2 Operator 会部署新版本的控制平面，以替换旧版本的控制平面。sidecar 会自动重新连接到新的控制平面。

    2. 运行以下命令，等待 Istio 控制平面就绪：

      kubectl wait --for condition=Ready istio/default --timeout=3m

    3. 通过运行以下命令，确认新版本的控制平面已就绪：

      kubectl get istio

      示例输出

      NAME      NAMESPACE      PROFILE   REVISIONS   READY   IN USE   ACTIVE REVISION   STATUS    VERSION   AGE
default   istio-system             1           1       1        default           Healthy   v1.28.6   18m5s

    4. 将 Istio CNI 插件更新到与控制平面相同的版本。IstioCNI 资源是独立于 Istio 资源更新的，因此更改控制平面版本不会自动更新 CNI 插件。详细步骤请参见 Istio CNI 更新过程。

    5. 重启应用工作负载，以便注入新的 sidecar 版本，运行以下命令：

      kubectl rollout restart deployment -n bookinfo

    验证

    通过输入以下命令，验证新的 sidecar 版本是否正在运行：

    istioctl proxy-status

    示例输出

    NAME                                        CLUSTER        CDS              LDS              EDS              RDS              ECDS        ISTIOD                      VERSION
details-v1-5c89dbb599-4t927.bookinfo        Kubernetes     SYNCED (92s)     SYNCED (92s)     SYNCED (85s)     SYNCED (92s)     IGNORED     istiod-57559f96c4-v2h9g     1.28.6-asm-r0
productpage-v1-f8fdd5649-xmxkt.bookinfo     Kubernetes     SYNCED (92s)     SYNCED (92s)     SYNCED (85s)     SYNCED (92s)     IGNORED     istiod-57559f96c4-v2h9g     1.28.6-asm-r0
ratings-v1-ccf8bc48c-766tl.bookinfo         Kubernetes     SYNCED (93s)     SYNCED (93s)     SYNCED (85s)     SYNCED (93s)     IGNORED     istiod-57559f96c4-v2h9g     1.28.6-asm-r0
reviews-v1-85dc746bfc-gsf6l.bookinfo        Kubernetes     SYNCED (92s)     SYNCED (92s)     SYNCED (85s)     SYNCED (92s)     IGNORED     istiod-57559f96c4-v2h9g     1.28.6-asm-r0
reviews-v2-5bd759b4c5-nkb62.bookinfo        Kubernetes     SYNCED (93s)     SYNCED (93s)     SYNCED (85s)     SYNCED (93s)     IGNORED     istiod-57559f96c4-v2h9g     1.28.6-asm-r0
reviews-v3-55d5b84fb9-wq9ds.bookinfo        Kubernetes     SYNCED (94s)     SYNCED (94s)     SYNCED (85s)     SYNCED (94s)     IGNORED     istiod-57559f96c4-v2h9g     1.28.6-asm-r0

    VERSION 列应与新的控制平面版本一致。

    从开发环境中移除 InPlace 更新资源

    在完成验证和实验后，你应移除 InPlace 更新配置，以清理开发环境并释放资源。

    操作步骤

    执行以下命令，移除所有 Istio 组件和示例应用：

    kubectl delete istio/default istiocni/default
kubectl delete ns/bookinfo
kubectl delete ns/istio-system ns/istio-cni