mirror of https://github.com/istio/istio.io.git
* Sync #15483 add istioctl install page for ambient and improve install docs experience into Chinese * translate * translate * fix lint * fix lint
This commit is contained in:
Wilson Wu
GitHub
parent
e917209929
commit
c78bf1dc30
|
|
@ -1,10 +1,18 @@
|
|||
---
|
||||
title: 安装指南
|
||||
description: Istio Ambient 模式安装指南。
|
||||
description: Ambient 模式下的 Istio 安装指南。
|
||||
weight: 5
|
||||
aliases:
|
||||
- /zh/docs/ops/ambient/install
|
||||
- /zh/latest/docs/ops/ambient/install
|
||||
owner: istio/wg-environment-maintainers
|
||||
test: n/a
|
||||
list_below: yes
|
||||
---
|
||||
|
||||
{{< tip >}}
|
||||
想要在 Ambient 模式下快速试用 Istio？[阅读我们的入门指南](/zh/docs/ambient/getting-started/)！
|
||||
{{< /tip >}}
|
||||
|
||||
安装 Istio 有两种不同的方法。您应该选择哪种方法取决于您的生产要求以及您如何安装其他软件。
|
||||
如果您需要帮助选择，请参阅我们的[我应该使用哪种 Istio 安装方法？](/zh/about/faq/#install-method-selection)的常见问题解答页面。
|
||||
|
|
|
|||
|
|
@ -1,18 +1,25 @@
|
|||
---
|
||||
title: 通过 Helm 安装
|
||||
description: 使用 Helm 在 Ambient 模式下安装 Istio。
|
||||
description: 使用 Helm 安装支持 Ambient 模式的 Istio。
|
||||
weight: 4
|
||||
owner: istio/wg-environments-maintainers
|
||||
aliases:
|
||||
- /zh/docs/ops/ambient/install/helm-installation
|
||||
- /zh/latest/docs/ops/ambient/install/helm-installation
|
||||
- /zh/docs/ambient/install/helm-installation
|
||||
- /zh/latest/docs/ambient/install/helm-installation
|
||||
test: yes
|
||||
---
|
||||
|
||||
本指南向您展示如何使用 Helm 在环境模式下安装 Istio。
|
||||
除了遵循[Ambient 模式入门](/zh/docs/ambient/getting-started/)中的演示之外，
|
||||
我们鼓励使用 Helm 安装 Istio 使其在 Ambient 模式下运行。
|
||||
Helm 帮助您单独管理组件，您可以轻松地将组件升级到最新版本。
|
||||
{{< tip >}}
|
||||
按照本指南安装和配置支持 Ambient 模式的 Istio 网格。
|
||||
如果您是 Istio 新手，只想尝试一下，请按照[快速入门说明](/zh/docs/ambient/getting-started)进行操作。
|
||||
{{< /tip >}}
|
||||
|
||||
我们鼓励使用 Helm 在 Ambient 模式下安装 Istio 以供生产使用。
|
||||
为了允许受控升级，控制平面和数据平面组件是分开打包和安装的。
|
||||
（由于 Ambient 数据平面分为 ztunnel 和 waypoint [两个组件](/zh/docs/ambient/architecture/data-plane)，
|
||||
因此升级涉及这些组件的单独步骤。）
|
||||
|
||||
## 前提条件 {#prerequisites}
|
||||
|
||||
|
|
@ -27,11 +34,27 @@ Helm 帮助您单独管理组件，您可以轻松地将组件升级到最新版
|
|||
$ helm repo update
|
||||
{{< /text >}}
|
||||
|
||||
有关 Helm 命令文档，请参阅 [Helm 仓库](https://helm.sh/docs/helm/helm_repo/)。
|
||||
## 安装控制平面 {#install-the-control-plane}
|
||||
|
||||
## 安装组件 {#installing-the-components}
|
||||
可以使用一个或多个 `--set <parameter>=<value>` 参数更改默认配置值。
|
||||
或者，您可以使用 `--values <file>` 参数在自定义值文件中指定多个参数。
|
||||
|
||||
### 安装 base 组件 {#installing-the-base-component}
|
||||
{{< tip >}}
|
||||
您可以使用 `helm show values <chart>` 命令显示配置参数的默认值，
|
||||
或者参阅 Artifact Hub Chart 文档中的 [base](https://artifacthub.io/packages/helm/istio-official/base?modal=values)、
|
||||
[istiod](https://artifacthub.io/packages/helm/istio-official/istiod?modal=values)、
|
||||
[CNI](https://artifacthub.io/packages/helm/istio-official/cni?modal=values)、
|
||||
[ztunnel](https://artifacthub.io/packages/helm/istio-official/ztunnel?modal=values)
|
||||
和 [Gateway](https://artifacthub.io/packages/helm/istio-official/gateway?modal=values) Chart 配置参数。
|
||||
{{< /tip >}}
|
||||
|
||||
有关如何使用和自定义 Helm 安装的完整详细信息，
|
||||
请参阅 [Sidecar 安装文档](/zh/docs/setup/install/helm/)。
|
||||
|
||||
与 [istioctl](/zh/docs/ambient/install/istioctl/) 配置文件不同，
|
||||
后者将要安装或删除的组件分组在一起，而 Helm 配置文件只是设置了配置值组。
|
||||
|
||||
### 基本组件 {#base-components}
|
||||
|
||||
`base` Chart 包含设置 Istio 所需的基本 CRD 和集群角色。
|
||||
需要先安装此 Chart，才能安装任何其他 Istio 组件。
|
||||
|
|
@ -40,24 +63,26 @@ Helm 帮助您单独管理组件，您可以轻松地将组件升级到最新版
|
|||
$ helm install istio-base istio/base -n istio-system --create-namespace --wait
|
||||
{{< /text >}}
|
||||
|
||||
### 安装 CNI 组件 {#installing-the-cni-component}
|
||||
### istiod 控制平面 {#istiod-control-plane}
|
||||
|
||||
`cni` Chart 将安装 Istio CNI 插件。它负责检测属于 Ambient 网格的 Pod，
|
||||
并配置 Pod 和 ztunnel 节点代理（稍后将安装）之间的流量重定向。
|
||||
`istiod` Chart 安装了 Istiod 的修订版。Istiod 是管理和配置代理以在网格内路由流量的控制平面组件。
|
||||
|
||||
{{< text syntax=bash snip_id=install_istiod >}}
|
||||
$ helm install istiod istio/istiod --namespace istio-system --set profile=ambient --wait
|
||||
{{< /text >}}
|
||||
|
||||
### CNI 节点代理 {#cni-node-agent}
|
||||
|
||||
`cni` Chart 安装 Istio CNI 节点代理。它负责检测属于 Ambient 网格的 Pod，
|
||||
并配置 Pod 和 ztunnel 节点代理（稍后安装）之间的流量重定向。
|
||||
|
||||
{{< text syntax=bash snip_id=install_cni >}}
|
||||
$ helm install istio-cni istio/cni -n istio-system --set profile=ambient --wait
|
||||
{{< /text >}}
|
||||
|
||||
### 安装 Istiod 组件 {#installing-the-discovery-component}
|
||||
## 安装数据平面 {#install-the-data-plane}
|
||||
|
||||
`istiod` Chart 会安装 Istiod 的修订版。Istiod 是控制平面组件，用于管理和配置代理，以在网格内进行流量路由。
|
||||
|
||||
{{< text syntax=bash snip_id=install_discovery >}}
|
||||
$ helm install istiod istio/istiod --namespace istio-system --set profile=ambient --wait
|
||||
{{< /text >}}
|
||||
|
||||
### 安装 ztunnel 组件 {#installing-the-ztunnel-component}
|
||||
### ztunnel DaemonSet {#ztunnel-daemonset}
|
||||
|
||||
`ztunnel` Chart 会安装 ztunnel DaemonSet，它是 Istio Ambient 模式的节点代理组件。
|
||||
|
||||
|
|
@ -65,7 +90,7 @@ $ helm install istiod istio/istiod --namespace istio-system --set profile=ambien
|
|||
$ helm install ztunnel istio/ztunnel -n istio-system --wait
|
||||
{{< /text >}}
|
||||
|
||||
### 安装入口网关（可选） {#install-an-ingress-gateway-optional}
|
||||
### 入口网关（可选） {#ingress-gateway-optional}
|
||||
|
||||
要安装入口网关，请运行以下命令：
|
||||
|
||||
|
|
@ -140,21 +165,21 @@ ztunnel-c2z4s 1/1 Running 0 10m
|
|||
$ kubectl delete namespace istio-ingress
|
||||
{{< /text >}}
|
||||
|
||||
1. 删除 ztunnel Chart：
|
||||
|
||||
{{< text syntax=bash snip_id=delete_ztunnel >}}
|
||||
$ helm delete ztunnel -n istio-system
|
||||
{{< /text >}}
|
||||
|
||||
1. 删除 Istio CNI Chart：
|
||||
|
||||
{{< text syntax=bash snip_id=delete_cni >}}
|
||||
$ helm delete istio-cni -n istio-system
|
||||
{{< /text >}}
|
||||
|
||||
1. 删除 Istio ztunnel Chart：
|
||||
1. 删除 istiod 控制平面 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 >}}
|
||||
{{< text syntax=bash snip_id=delete_istiod >}}
|
||||
$ helm delete istiod -n istio-system
|
||||
{{< /text >}}
|
||||
|
||||
|
|
@ -0,0 +1,86 @@
|
|||
---
|
||||
title: 使用 istioctl 进行安装
|
||||
description: 使用 istioctl 命令行工具安装支持 Ambient 模式的 Istio。
|
||||
weight: 10
|
||||
keywords: [istioctl,ambient]
|
||||
owner: istio/wg-environments-maintainers
|
||||
test: yes
|
||||
---
|
||||
|
||||
{{< tip >}}
|
||||
按照本指南安装和配置支持 Ambient 模式的 Istio 网格。
|
||||
如果您是 Istio 新手，只想尝试一下，
|
||||
请按照[快速入门说明](/zh/docs/ambient/getting-started)进行操作。
|
||||
{{< /tip >}}
|
||||
|
||||
本安装指南使用 [istioctl](/zh/docs/reference/commands/istioctl/)
|
||||
命令行工具。与其他安装方法一样，`istioctl`
|
||||
也提供许多自定义选项。此外，它还提供用户输入验证以帮助防止安装错误，
|
||||
并包含许多安装后分析和配置工具。
|
||||
|
||||
使用这些说明，您可以选择 Istio
|
||||
的内置[配置文件](/zh/docs/setup/additional-setup/config-profiles/)中的任意一个，
|
||||
然后根据您的特定需求进一步自定义配置。
|
||||
|
||||
`istioctl` 命令通过命令行选项进行单独设置，
|
||||
或传递包含 `IstioOperator` {{<gloss CRD>}}自定义资源{{</gloss>}} 的 YAML 文件，
|
||||
支持完整的 [`IstioOperator` API](/zh/docs/reference/config/istio.operator.v1alpha1/)。
|
||||
|
||||
## 先决条件 {#prerequisites}
|
||||
|
||||
开始之前，请检查以下先决条件：
|
||||
|
||||
1. [下载 Istio 发行版](/zh/docs/setup/additional-setup/download-istio-release/)。
|
||||
1. 执行任何必要的[平台特定设置](/zh/docs/ambient/install/platform-prerequisites/)。
|
||||
|
||||
## 安装或升级 Kubernetes Gateway API CRD {#install-or-upgrade-the-kubernetes-gateway-api-crds}
|
||||
|
||||
{{< boilerplate gateway-api-install-crds >}}
|
||||
|
||||
## 使用 Ambient 配置文件安装 Istio {#install-istio-using-the-ambient-profile}
|
||||
|
||||
`istioctl` 支持多种[配置文件](/zh/docs/setup/additional-setup/config-profiles/)，
|
||||
其中包含不同的默认选项，并可根据您的生产需求进行自定义。
|
||||
`ambient` 配置文件中包含对 Ambient 模式的支持。使用以下命令安装 Istio：
|
||||
|
||||
{{< text syntax=bash snip_id=install_ambient >}}
|
||||
$ istioctl install --set profile=ambient --skip-confirmation
|
||||
{{< /text >}}
|
||||
|
||||
此命令在 Kubernetes 配置定义的集群上安装 `ambient` 配置文件。
|
||||
|
||||
## 配置和修改配置文件 {#configure-and-modify-profiles}
|
||||
|
||||
Istio 的安装 API 记录在
|
||||
[`IstioOperator` API 参考](/zh/docs/reference/config/istio.operator.v1alpha1/)中。
|
||||
您可以使用 `istioctl install` 的 `--set`
|
||||
选项来修改各个安装参数，或者使用 `-f` 指定您自己的配置文件。
|
||||
|
||||
有关如何使用和自定义 `istioctl` 安装的完整详细信息，
|
||||
请参阅 [Sidecar 安装文档](/zh/docs/setup/install/istioctl/)。
|
||||
|
||||
## 卸载 Istio {#uninstall-istio}
|
||||
|
||||
要从集群中完全卸载 Istio，请运行以下命令：
|
||||
|
||||
{{< text syntax=bash snip_id=uninstall >}}
|
||||
$ istioctl uninstall --purge -y
|
||||
{{< /text >}}
|
||||
|
||||
{{< warning >}}
|
||||
可选的 `--purge` 标志将删除所有 Istio 资源，
|
||||
包括可能与其他 Istio 控制平面共享的集群范围资源。
|
||||
{{< /warning >}}
|
||||
|
||||
或者，要仅删除特定的 Istio 控制平面，请运行以下命令：
|
||||
|
||||
{{< text syntax=bash snip_id=none >}}
|
||||
$ istioctl uninstall <your original installation options>
|
||||
{{< /text >}}
|
||||
|
||||
控制平面命名空间（例如 `istio-system`）默认不会被删除。
|
||||
如果不再需要，请使用以下命令将其删除：
|
||||
|
||||
{{< text syntax=bash snip_id=remove_namespace >}}
|
||||
$ kubectl delete namespace istio-system
|
||||
{{< /text >}}
|
||||
Loading…
Reference in New Issue