mirror of https://github.com/istio/istio.io.git
[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:
parent
709618e99a
commit
5727476362
|
@ -0,0 +1,7 @@
|
|||
---
|
||||
title: 安装指南
|
||||
description: Istio Ambient Mesh 安装指南。
|
||||
weight: 2
|
||||
owner: istio/wg-environment-maintainers
|
||||
test: n/a
|
||||
---
|
|
@ -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 >}}
|
Loading…
Reference in New Issue