istio · istio-testing · Sep 13, 2024 · Sep 12, 2024
@@ -15,12 +15,11 @@ weight: 10
 
     - 完整的配置和运行状态的验证。
     - 使用提供了扩展的配置、自定义选项的 `IstioOperator` API。
-    - 不需要在集群内运行特权 Pod，通过执行 `istioctl` 命令修改。
 
     缺点：
 
     - 需要维护多个 Istio 次要版本的二进制文件。
-    - `istioctl` 命令可能根据您的运行环境设置诸如 `JWT_POLICY` 之类的值，从而能够在不同的
+    - `istioctl` 命令可能根据您的运行环境自动设置相关值，从而能够在不同的
       Kubernetes 环境中进行不同的安装。
 
 1. [使用 istioctl 生成清单](/zh/docs/setup/install/istioctl/#generate-a-manifest-before-installation)
@@ -30,12 +29,12 @@ weight: 10
 
     优点：
 
-    - 资源是由与 `istioctl install` 和 Operator 里使用的相同的 `IstioOperator` API 生成的。
+    - 资源是由与 `istioctl install` 中使用相同的 `IstioOperator` API 生成的。
     - 使用提供了扩展的配置、自定义选项的 `IstioOperator` API。
 
     缺点：
 
-    - 一些在 `istioctl install` 和 Operator 中执行的未完成的检查将不会执行。
+    - 一些在 `istioctl install` 中执行的未完成的检查将不会执行。
     - 与 `istioctl install` 相比，UX 的精简程度较低。
     - 错误报告不如 `istioctl install` 的错误报告详细、全面。
 
@@ -50,26 +49,7 @@ weight: 10
 
     缺点：
 
-    - 相比于 `istioctl install` 和 Operator 相比，检查较少。
+    - 相比于 `istioctl install`，检查较少。
     - 一些高权限任务需要更多步骤，并且具有更高的复杂性。
 
-1. [Istio Operator](/zh/docs/setup/install/operator/)
-
-    {{< warning >}}
-    不建议在新安装时使用 Operator，虽然 Operator 将继续得到支持，但新特性请求将不会被优先化。
-    {{< /warning >}}
-
-    Istio Operator 提供了一个不需要 `istioctl` 二进制文件的安装方式。这可以用于简化升级工作流，
-    其中不需要考虑集群内特权控制器的运行，此方法适用于不需要严格审计或增加输出清单的情况。
-
-    优点：
-
-    - 与 `istioctl install` 使用相同的 API，但驱动是通过集群中的一个带有完全声明式操作的控制器。
-    - 使用提供了扩展的配置、自定义选项的 `IstioOperator` API。
-    - 不需要管理多个 `istioctl` 二进制文件。
-
-    缺点：
-
-    - 集群中运行的特权控制器存在安全风险。
-
 这些安装方式的安装向导在 [Istio 安装页面](/zh/docs/setup/install)中。
@@ -81,7 +81,7 @@ $ istioctl manifest apply --set telemetry.enabled=false
 
 Operator 实现使用 Kubernetes controller 来持续监控它们的自定义资源并应用相应的配置更改。Istio controller 监控一个 `IstioControlPlane` 资源，并通过更新相应集群中的 Istio 安装配置来响应更改。
 
-在 1.4 版中，Istio controller 处于开发的 alpha 阶段，没有完全集成到 `istioctl` 中。但是，可以使用 `kubectl` 命令来做[实验](/zh/docs/setup/install/standalone-operator/)。例如，要将 controller 和默认版本的 Istio 安装到集群中，请运行以下命令:
+在 1.4 版中，Istio controller 处于开发的 alpha 阶段，没有完全集成到 `istioctl` 中。但是，可以使用 `kubectl` 命令来做[实验](https://archive.istio.io/v1.23/docs/setup/install/operator/)。例如，要将 controller 和默认版本的 Istio 安装到集群中，请运行以下命令:
 
 {{< text bash >}}
 $ kubectl apply -f https://<repo URL>/operator.yaml

@@ -12,7 +12,7 @@ Istio 1.24 或更高版本。请继续阅读以了解我们进行此更改的原
 
 ## 这对您有影响吗？ {#does-this-affect-you}
 
-此弃用仅影响 [In-Cluster Operator](/zh/docs/setup/install/operator/) 的用户。
+此弃用仅影响 [In-Cluster Operator](https://archive.istio.io/v1.23/zh/docs/setup/install/operator/) 的用户。
 **使用 <code>istioctl install</code> 命令和 `IstioOperator` YAML 文件安装 Istio 的用户不受影响**。
 
 要确定您是否受到影响，请运行 `kubectl get deployment -n istio-system istio-operator`

@@ -1,8 +1,6 @@
 ---
 ---
-本指南中使用的 `base` 和 `istiod` Helm Chart 与通过
-[Istioctl](/zh/docs/setup/install/istioctl/) 或
-[Operator](/zh/docs/setup/install/operator/) 安装 Istio 时使用的 Chart 相同。
-但是，通过 Istioctl 和 Operator 进行安装时使用了与本指南所述
-[Chart]({{< github_tree >}}/manifests/charts/gateway)
-不同的[网关 Chart]({{< github_tree >}}/manifests/charts/gateways/istio-ingress)。
+本指南中使用的 `base` 和 `istiod` 的 Helm Chart 与通过
+[Istioctl](/zh/docs/setup/install/istioctl/) 安装 Istio 时使用的相同。
+但是，通过 Istioctl 安装使用的[网关 Chart]({{< github_tree >}}/manifests/charts/gateways/istio-ingress)
+与本指南中描述的 [Chart]({{< github_tree >}}/manifests/charts/gateway) 不同
@@ -62,6 +62,7 @@ default           Active   24h   ambient
 
 {{< text syntax=bash snip_id=gen_waypoint_resource >}}
 $ istioctl waypoint generate --for service -n default
+apiVersion: gateway.networking.k8s.io/v1
 kind: Gateway
 metadata:
   labels:
@@ -91,6 +92,7 @@ waypoint default/waypoint applied
 
 {{< text syntax=bash >}}
 $ kubectl apply -f - <<EOF
+apiVersion: gateway.networking.k8s.io/v1
 kind: Gateway
 metadata:
   labels:

@@ -186,7 +186,6 @@ EOF
       meshConfig:
         trustDomain: example.org
       values:
-        global:
         # 这用于自定义 Sidecar 模板。
         # 它添加了标签以指示 SPIRE 应该管理此 Pod 的身份，
         # 以及 CSI 驱动程序挂载。

@@ -9,6 +9,8 @@ aliases:
     - /zh/docs/setup/kubernetes/quick-start.html
     - /zh/docs/setup/kubernetes/download-release/
     - /zh/docs/setup/kubernetes/download/
+    - /zh/docs/setup/install/operator/
+    - /zh/latest/docs/setup/install/operator/
 keywords: [kubernetes,install,quick-start,setup,installation]
 test: table-of-contents
 ---
@@ -217,15 +217,16 @@ Webhook、ConfigMap 和 Secret，以便使用外部控制平面。
 
     {{< text bash >}}
     $ kubectl create namespace external-istiod --context="${CTX_REMOTE_CLUSTER}"
-    $ istioctl manifest generate -f remote-config-cluster.yaml --set values.defaultRevision=default | kubectl apply --context="${CTX_REMOTE_CLUSTER}" -f -
+    $ istioctl install -f remote-config-cluster.yaml --set values.defaultRevision=default --context="${CTX_REMOTE_CLUSTER}"
     {{< /text >}}
 
 1. 确认从集群的注入 Webhook 配置已经安装：
 
     {{< text bash >}}
     $ kubectl get mutatingwebhookconfiguration --context="${CTX_REMOTE_CLUSTER}"
-    NAME                                     WEBHOOKS   AGE
-    istio-sidecar-injector-external-istiod   4          6m24s
+    NAME                                         WEBHOOKS   AGE
+    istio-revision-tag-default-external-istiod   4          2m2s
+    istio-sidecar-injector-external-istiod       4          2m5s
     {{< /text >}}
 
 1. 确认已安装从集群的验证 Webhook 配置：
@@ -754,7 +755,7 @@ $ export SECOND_CLUSTER_NAME=<您的第二个从集群名称>
 1. 在从集群上安装配置：
 
     {{< text bash >}}
-    $ istioctl manifest generate -f second-remote-cluster.yaml | kubectl apply --context="${CTX_SECOND_CLUSTER}" -f -
+    $ istioctl install -f second-remote-cluster.yaml --context="${CTX_SECOND_CLUSTER}"
     {{< /text >}}
 
 1. 确认从集群的注入 Webhook 配置已经安装：
@@ -872,7 +873,7 @@ $ export SECOND_CLUSTER_NAME=<您的第二个从集群名称>
 
 {{< text bash >}}
 $ kubectl delete -f external-istiod-gw.yaml --context="${CTX_EXTERNAL_CLUSTER}"
-$ istioctl uninstall -y --purge --context="${CTX_EXTERNAL_CLUSTER}"
+$ istioctl uninstall -y --purge -f external-istiod.yaml --context="${CTX_EXTERNAL_CLUSTER}"
 $ kubectl delete ns istio-system external-istiod --context="${CTX_EXTERNAL_CLUSTER}"
 $ rm controlplane-gateway.yaml external-istiod.yaml external-istiod-gw.yaml
 {{< /text >}}
@@ -881,7 +882,7 @@ $ rm controlplane-gateway.yaml external-istiod.yaml external-istiod-gw.yaml
 
 {{< text bash >}}
 $ kubectl delete ns sample --context="${CTX_REMOTE_CLUSTER}"
-$ istioctl manifest generate -f remote-config-cluster.yaml --set values.defaultRevision=default | kubectl delete --context="${CTX_REMOTE_CLUSTER}" -f -
+$ istioctl uninstall -y --purge -f remote-config-cluster.yaml --set values.defaultRevision=default --context="${CTX_REMOTE_CLUSTER}"
 $ kubectl delete ns external-istiod --context="${CTX_REMOTE_CLUSTER}"
 $ rm remote-config-cluster.yaml istio-ingressgateway.yaml
 $ rm istio-egressgateway.yaml eastwest-gateway-1.yaml || true
@@ -891,7 +892,7 @@ $ rm istio-egressgateway.yaml eastwest-gateway-1.yaml || true
 
 {{< text bash >}}
 $ kubectl delete ns sample --context="${CTX_SECOND_CLUSTER}"
-$ istioctl manifest generate -f second-remote-cluster.yaml | kubectl delete --context="${CTX_SECOND_CLUSTER}" -f -
+$ istioctl uninstall -y --purge -f second-remote-cluster.yaml --context="${CTX_SECOND_CLUSTER}"
 $ kubectl delete ns external-istiod --context="${CTX_SECOND_CLUSTER}"
 $ rm second-remote-cluster.yaml eastwest-gateway-2.yaml
 {{< /text >}}
@@ -157,17 +157,15 @@ $ helm install <release> <chart> --namespace <namespace> --create-namespace [--s
 
 ### 从非 Helm 安装迁移 {#migrating-from-non-helm-installations}
 
-如果您需要将使用 `istioctl` 或 Operator 安装的 Istio 迁移到 Helm，
-那要删除当前 Istio 控制平面资源，并根据上面的说明，使用 Helm 重新安装 Istio。
+如果你要从使用 `istioctl` 安装的 Istio 版本迁移到 Helm（Istio 1.5 或更早版本），
+则需要删除当前的 Istio 控制平面资源，并根据上面的说明，使用 Helm 重新安装 Istio。
 在删除当前 Istio 时，千万不能删掉 Istio 的自定义资源定义（CRD），以免丢掉您的自定义 Istio 资源。
 
 {{< warning >}}
 建议：从集群中删除 Istio 前，使用上面的说明备份您的 Istio 资源。
 {{< /warning >}}
 
-依据您的安装方式，选择
-[Istioctl 卸载指南](/zh/docs/setup/install/istioctl#uninstall-istio)或
-[Operator 卸载指南](/zh/docs/setup/install/operator/#uninstall)。
+您可以按照 [Istioctl 卸载指南](/zh/docs/setup/install/istioctl#uninstall-istio)中提到的步骤进行操作。
 
 ## 卸载 {#uninstall}
 

@@ -268,14 +268,14 @@ sleep-78ff5975c6-nxtth.app-ns-3      Kubernetes     SYNCED     SYNCED     SYNCED
 1. 清理第一个用户组：
 
     {{< text bash >}}
-    $ istioctl uninstall --revision usergroup-1
+    $ istioctl uninstall --revision usergroup-1 --set values.global.istioNamespace=usergroup-1
     $ kubectl delete ns app-ns-1 usergroup-1
     {{< /text >}}
 
 1. 清理第二个用户组：
 
     {{< text bash >}}
-    $ istioctl uninstall --revision usergroup-2
+    $ istioctl uninstall --revision usergroup-2 --set values.global.istioNamespace=usergroup-2
     $ kubectl delete ns app-ns-2 app-ns-3 usergroup-2
     {{< /text >}}