[zh] Sync install ambient with helm doc into Chinese (#14332)

* Sync install ambient with helm into Chinese

* Apply suggestions from code review

Co-authored-by: Michael <haifeng.yao@daocloud.io>

* Apply suggestions from code review

Co-authored-by: Xiaopeng Han <hanxiaop8@outlook.com>

* Fix lint

---------

Co-authored-by: Michael <haifeng.yao@daocloud.io>
Co-authored-by: Xiaopeng Han <hanxiaop8@outlook.com>
This commit is contained in:
Wilson Wu 2023-12-15 14:56:33 +08:00 committed by GitHub
parent 709618e99a
commit 5727476362
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 167 additions and 0 deletions

View File

@ -0,0 +1,7 @@
---
title: 安装指南
description: Istio Ambient Mesh 安装指南。
weight: 2
owner: istio/wg-environment-maintainers
test: n/a
---

View File

@ -0,0 +1,160 @@
---
title: 通过 Helm 安装
description: 如何使用 Helm 安装 Ambient Mesh。
weight: 4
owner: istio/wg-environments-maintainers
test: yes
---
本指南向您展示如何使用 Helm 安装 Ambient Mesh。
除了 [Ambient Mesh 入门](/zh/docs/ops/ambient/getting-started/)中的演示之外,
我们**鼓励**您依照本指南安装 Ambient Mesh。Helm 可以帮助您单独管理组件,您可以轻松地将组件升级到最新版本。
## 前提条件 {#prerequisites}
1. 执行任何必要的[平台特定设置](/zh/docs/setup/platform-setup/)。
1. 检查 [Pod 和 Service 的要求](/zh/docs/ops/deployment/requirements/)。
1. [安装 Helm 客户端](https://helm.sh/docs/intro/install/),版本要求 3.6 或更高。
1. 配置 Helm 仓库:
{{< text syntax=bash snip_id=configure_helm >}}
$ helm repo add istio https://istio-release.storage.googleapis.com/charts
$ helm repo update
{{< /text >}}
有关 Helm 命令文档,请参阅 [Helm 仓库](https://helm.sh/docs/helm/helm_repo/)。
## 安装组件 {#installing-the-components}
### 安装 base 组件 {#installing-the-base-component}
`base` Chart 包含设置 Istio 所需的基本 CRD 和集群角色。
需要先安装此 Chart才能安装任何其他 Istio 组件。
{{< text syntax=bash snip_id=install_base >}}
$ helm install istio-base istio/base -n istio-system --create-namespace
{{< /text >}}
### 安装 CNI 组件 {#installing-the-cni-component}
**CNI** Chart 会安装 Istio CNI 插件。它负责检测属于 Ambient Mesh 的 Pod
并对稍后将安装的 ztunnel DaemonSet 之间的流量重定向进行配置。
{{< text syntax=bash snip_id=install_cni >}}
$ helm install istio-cni istio/cni -n istio-system \
-f @manifests/charts/istio-cni/ambient-values.yaml@
{{< /text >}}
### 安装 discovery 组件 {#installing-the-discovery-component}
`istiod` Chart 会安装 Istiod 的修订版。Istiod 是控制平面组件,用于管理和配置代理,以在网格内进行流量路由。
{{< text syntax=bash snip_id=install_discovery >}}
$ helm install istiod istio/istiod --namespace istio-system \
-f @manifests/charts/istio-control/istio-discovery/ambient-values.yaml@
{{< /text >}}
### 安装 ztunnel 组件 {#installing-the-ztunnel-component}
`ztunnel` Chart 会安装 ztunnel DaemonSet它是 Ambient 的节点代理组件。
{{< text syntax=bash snip_id=install_ztunnel >}}
$ helm install ztunnel istio/ztunnel -n istio-system
{{< /text >}}
## 配置 {#configuration}
要查看支持的配置选项和文档,请运行:
{{< text syntax=bash >}}
$ helm show values istio/istiod
{{< /text >}}
## 验证安装 {#verifying-the-installation}
### 验证工作负载状态 {#verifying-the-workload-status}
安装所有组件后,您可以使用以下命令检查 Helm 部署状态:
{{< text syntax=bash snip_id=show_components >}}
$ helm list -n istio-system
{{< /text >}}
您可以使用以下命令检查已部署的 Pod 状态:
{{< text syntax=bash snip_id=check_pods >}}
$ kubectl get pods -n istio-system
{{< /text >}}
### 使用示例应用程序进行验证 {#verifying-with-the-sample-application}
使用 Helm 安装 Ambient 后,
您可以按照[部署示例应用程序](/zh/docs/ops/ambient/getting-started/#bookinfo)指南部署示例应用程序和入口网关,
然后您可以[将您的应用程序添加到 Ambient](/zh/docs/ops/ambient/getting-started/#addtoambient)。
## 卸载 {#uninstall}
您可以通过卸载上面安装的 Chart 来卸载 Istio 及其组件。
1. 列出安装在 `istio-system` 命名空间中的所有 Istio Chart
{{< text syntax=bash >}}
$ helm ls -n istio-system
NAME NAMESPACE REVISION UPDATED STATUS CHART APP VERSION
istio-base istio-system 1 ... ... ... ... deployed base-1.0.0 1.0.0
istiod istio-system 1 ... ... ... ... deployed istiod-1.0.0 1.0.0
{{< /text >}}
1.(可选)删除所有 Istio 网关 Chart 安装文件:
{{< text syntax=bash >}}
$ helm delete istio-ingress -n istio-ingress
$ kubectl delete namespace istio-ingress
{{< /text >}}
1. 删除 Istio CNI Chart
{{< text syntax=bash snip_id=delete_cni >}}
$ helm delete istio-cni -n istio-system
{{< /text >}}
1. 删除 Istio ztunnel Chart
{{< text syntax=bash snip_id=delete_ztunnel >}}
$ helm delete ztunnel -n istio-system
{{< /text >}}
1. 删除 Istio discovery Chart
{{< text syntax=bash snip_id=delete_discovery >}}
$ helm delete istiod -n istio-system
{{< /text >}}
1. 删除 Istio base Chart
{{< tip >}}
根据设计,通过 Helm 删除 Chart 不会删除通过 Chart 安装的自定义资源定义CRD
{{< /tip >}}
{{< text syntax=bash snip_id=delete_base >}}
$ helm delete istio-base -n istio-system
{{< /text >}}
1. 删除 Istio 安装的 CRD可选
{{< warning >}}
这将删除所有已创建的 Istio 资源。
{{< /warning >}}
{{< text syntax=bash >}}
$ kubectl get crd -oname | grep --color=never 'istio.io' | xargs kubectl delete
{{< /text >}}
1. 删除 `istio-system` 命名空间:
{{< text syntax=bash snip_id=delete_system_namespace >}}
$ kubectl delete namespace istio-system
{{< /text >}}