Skip to content

Commit e40efd2

Browse files
authored
[zh] Sync additional-setup/config-profiles/ (#16624)
Signed-off-by: windsonsea <[email protected]>
1 parent 87448ff commit e40efd2

File tree

1 file changed

+97
-19
lines changed
  • content/zh/docs/setup/additional-setup/config-profiles

1 file changed

+97
-19
lines changed

content/zh/docs/setup/additional-setup/config-profiles/index.md

Lines changed: 97 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -10,13 +10,69 @@ test: n/a
1010
---
1111

1212
本页面描述了在[安装 Istio](/zh/docs/setup/install/istioctl/) 时所能够使用的内置配置文件。
13-
这些配置文件提供了对 Istio 控制平面和 Istio 数据平面 Sidecar 的定制内容。
1413

15-
您可以从其中一个 [Istio 的内置配置文件]({{< github_tree >}}/manifests/profiles)之一开始入手,
16-
然后根据您的特定需求来进一步[自定义配置文件](/zh/docs/setup/additional-setup/customize-installation/)
17-
当前提供以下几种内置配置文件:
14+
这些配置文件是内置于 Helm Chart 中的一组带有名称的覆盖集合,在通过
15+
`helm``istioctl` 安装 Istio 时可以使用这些配置文件。
1816

19-
1. **default**:根据 [`IstioOperator` API](/zh/docs/reference/config/istio.operator.v1alpha1/) 的默认设置来启用组件。
17+
这些配置文件为常见的部署拓扑结构和目标平台提供了对 Istio 控制面和数据面的高级定制能力。
18+
19+
{{< tip >}}
20+
配置文件可以与其他值覆盖或参数组合使用,
21+
因此配置文件中设置的任何单独值都可以通过在命令中添加 `--set` 参数手动覆盖。
22+
{{< /tip >}}
23+
24+
配置文件分为两类:**部署**配置文件和**平台**配置文件,建议同时使用这两类配置文件。
25+
26+
- **部署**配置文件用于为特定部署拓扑(如 `default``remote``ambient` 等)提供合理的默认设置。
27+
- **平台**配置文件用于为特定目标平台(如 `eks``gke``openshift` 等)提供必要的平台特定默认设置。
28+
29+
例如,如果您希望在 GKE 上安装 `default` Sidecar 数据面,建议使用如下部署和平台配置文件作为起点:
30+
31+
{{< tabset category-name="install-method" >}}
32+
33+
{{< tab name="Helm" category-value="helm" >}}
34+
35+
对于 Helm,请为您安装的每个 Chart 指定相同的 `profile``platform`,例如安装 `istiod`
36+
37+
{{< text syntax=bash snip_id=install_istiod_helm_platform >}}
38+
$ helm install istiod istio/istiod -n istio-system --set profile=default --set global.platform=gke --wait
39+
{{< /text >}}
40+
41+
{{< /tab >}}
42+
43+
{{< tab name="istioctl" category-value="istioctl" >}}
44+
45+
对于 `istioctl`,以参数形式传入相同的 `profile``platform`
46+
47+
{{< text syntax=bash snip_id=install_istiod_istioctl_platform >}}
48+
$ istioctl install --set profile=default --set values.global.platform=gke
49+
{{< /text >}}
50+
51+
{{< /tab >}}
52+
53+
{{< /tabset >}}
54+
55+
{{< warning >}}
56+
请注意,`helm``istioctl` 安装方式之间的一个关键区别是:
57+
`istioctl` 的配置文件中还包含了将由 `istioctl` 自动安装的 Istio 组件列表。
58+
59+
`helm` 并不会这样做,用户需要单独使用 `helm install` 安装每一个所需的
60+
Istio 组件,并为每个组件单独提供所需的配置文件参数。
61+
62+
您可以将 `istioctl``helm` 理解为共享相同名称、相同内容的配置文件,但
63+
`istioctl` 会基于所选配置文件自动决定安装哪些组件,因此只需一条命令就能实现完整的安装效果。
64+
{{< /warning >}}
65+
66+
## 部署配置文件 {#deployment-profiles}
67+
68+
以下是当前可用于 `istioctl``helm` 安装方式的内置于部署配置文件。
69+
请注意,这些配置文件本质上只是 Helm 值的预设集合,并不是安装 Istio 的强制要求,
70+
但它们为新用户提供了便捷的基础配置,推荐使用。此外,
71+
您还可以[根据具体需求自定义配置](/zh/docs/setup/additional-setup/customize-installation/)
72+
超出配置文件所提供的范围。当前提供以下几种内置配置文件:
73+
74+
1. **default**:根据 [`IstioOperator` API](/zh/docs/reference/config/istio.operator.v1alpha1/)
75+
的默认设置来启用组件。
2076
建议用于生产部署和[多集群网格](/zh/docs/ops/deployment/deployment-models/#multiple-clusters)
2177
中的{{< gloss "primary cluster" >}}主集群{{< /gloss >}}。
2278

@@ -37,28 +93,50 @@ test: n/a
3793
或者由[多集群网格](/zh/docs/ops/deployment/deployment-models/#multiple-clusters)
3894
{{< gloss "primary cluster" >}}主集群{{< /gloss >}}中的控制平面管理。
3995

96+
1. **ambient**:Ambient 配置文件旨在帮助您开始使用 [Ambient 模式](/zh/docs/ambient)
97+
4098
1. **empty**:不部署任何内容。可以作为自定义配置的基本配置文件。
4199

42100
1. **preview**:预览文件包含的功能都属于实验性阶段。该配置文件是为了探索 Istio 的新功能。
43101
确保稳定性、安全性和性能(使用风险需自负)。
44102

45-
1. **ambient**:Ambient 配置文件旨在帮助您开始使用 [Ambient 模式](/zh/docs/ambient)
103+
Istio 的[部署配置文件值集合在此定义]({{< github_tree >}}/manifests/helm-profiles),适用于 `istioctl``helm`
104+
105+
仅在使用 `istioctl` 时,指定配置文件还会**自动选择**某些 Istio 组件进行安装,这些组件在下表中以 &#x2714; 标记:
106+
107+
| | default | demo | minimal | remote | empty | preview | ambient |
108+
| -- | ---- | ---- | ------- | ------ | ----- | ------- | ------- |
109+
| 核心组件(Core components) | | | | | | | |
110+
| &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`istio-egressgateway` | | &#x2714; | | | | | |
111+
| &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`istio-ingressgateway` | &#x2714; | &#x2714; | | | | &#x2714; | |
112+
| &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`istiod` | &#x2714; | &#x2714; | &#x2714; | | | &#x2714; | &#x2714; |
113+
| &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`CNI` | | | | | | | &#x2714; |
114+
| &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`Ztunnel` | | | | | | | &#x2714; |
46115

47116
{{< tip >}}
48-
此外,还提供了一些其他特定的配置文件。更多相关信息,
49-
请参阅[平台安装](/zh/docs/setup/platform-setup)
117+
如需进一步自定义 Istio,还可以安装多个附加组件。
118+
详情请参阅[集成文档](/zh/docs/ops/integrations)
50119
{{< /tip >}}
51120

52-
标注 &#x2714; 的组件安装在每个配置文件中:
121+
## 平台配置文件 {#platform-profiles}
122+
123+
以下是目前可用于 `istioctl``helm` 安装方式的内置于平台配置文件。请注意,
124+
这些配置文件本质上只是 Helm 值的预设集合,虽然在这些环境中安装 Istio
125+
并不强制使用它们,但它们提供了方便的基础设置,推荐新用户使用:
126+
127+
1. **gke**:为在 Google Kubernetes Engine(GKE)环境中安装 Istio 设置了必要或推荐的图表选项。
128+
129+
1. **eks**:为在 Amazon Elastic Kubernetes Service(EKS)环境中安装 Istio 设置了必要或推荐的图表选项。
130+
131+
1. **openshift**:为在 OpenShift 环境中安装 Istio 设置了必要或推荐的图表选项。
132+
133+
1. **k3d**:为在 [k3d](https://k3d.io/) 环境中安装 Istio 设置了必要或推荐的图表选项。
134+
135+
1. **k3s**:为在 [K3s](https://k3s.io/) 环境中安装 Istio 设置了必要或推荐的图表选项。
136+
137+
1. **microk8s**:为在 [MicroK8s](https://microk8s.io/) 环境中安装 Istio 设置了必要或推荐的图表选项。
53138

54-
| | default | demo | minimal | remote | empty | preview | ambient | | |
55-
|------------------------------------------------------------|----------|----------|----------|--------|-------|----------|----------|--|--|
56-
| 核心组件 | | | | | | | | | |
57-
| &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`istio-egressgateway` | | &#x2714; | | | | | | | |
58-
| &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`istio-ingressgateway` | &#x2714; | &#x2714; | | | | &#x2714; | | | |
59-
| &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`istiod` | &#x2714; | &#x2714; | &#x2714; | | | &#x2714; | &#x2714; | | |
60-
| &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`CNI` | | | | | | | &#x2714; | | |
61-
| &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;`Ztunnel` | | | | | | | &#x2714; | | |
139+
1. **minikube**:为在 [minikube](https://kubernetes.io/zh-cn/docs/tasks/tools/install-minikube/)
140+
环境中安装 Istio 设置了必要或推荐的图表选项。
62141

63-
为了进一步自定义 Istio,还可以安装一些附加组件。
64-
详情请参阅[集成](/zh/docs/ops/integrations)
142+
Istio 的[平台配置文件在此定义]({{< github_tree >}}/manifests/helm-profiles),适用于 `istioctl``helm`

0 commit comments

Comments
 (0)