@@ -10,13 +10,69 @@ test: n/a
10
10
---
11
11
12
12
本页面描述了在[ 安装 Istio] ( /zh/docs/setup/install/istioctl/ ) 时所能够使用的内置配置文件。
13
- 这些配置文件提供了对 Istio 控制平面和 Istio 数据平面 Sidecar 的定制内容。
14
13
15
- 您可以从其中一个 [ Istio 的内置配置文件] ({{< github_tree >}}/manifests/profiles)之一开始入手,
16
- 然后根据您的特定需求来进一步[ 自定义配置文件] ( /zh/docs/setup/additional-setup/customize-installation/ ) 。
17
- 当前提供以下几种内置配置文件:
14
+ 这些配置文件是内置于 Helm Chart 中的一组带有名称的覆盖集合,在通过
15
+ ` helm ` 或 ` istioctl ` 安装 Istio 时可以使用这些配置文件。
18
16
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
+ 的默认设置来启用组件。
20
76
建议用于生产部署和[ 多集群网格] ( /zh/docs/ops/deployment/deployment-models/#multiple-clusters )
21
77
中的{{< gloss "primary cluster" >}}主集群{{< /gloss >}}。
22
78
@@ -37,28 +93,50 @@ test: n/a
37
93
或者由[ 多集群网格] ( /zh/docs/ops/deployment/deployment-models/#multiple-clusters ) 的
38
94
{{< gloss "primary cluster" >}}主集群{{< /gloss >}}中的控制平面管理。
39
95
96
+ 1 . ** ambient** :Ambient 配置文件旨在帮助您开始使用 [ Ambient 模式] ( /zh/docs/ambient ) 。
97
+
40
98
1 . ** empty** :不部署任何内容。可以作为自定义配置的基本配置文件。
41
99
42
100
1 . ** preview** :预览文件包含的功能都属于实验性阶段。该配置文件是为了探索 Istio 的新功能。
43
101
确保稳定性、安全性和性能(使用风险需自负)。
44
102
45
- 1 . ** ambient** :Ambient 配置文件旨在帮助您开始使用 [ Ambient 模式] ( /zh/docs/ambient ) 。
103
+ Istio 的[ 部署配置文件值集合在此定义] ({{< github_tree >}}/manifests/helm-profiles),适用于 ` istioctl ` 和 ` helm ` 。
104
+
105
+ 仅在使用 ` istioctl ` 时,指定配置文件还会** 自动选择** 某些 Istio 组件进行安装,这些组件在下表中以 ✔ ; 标记:
106
+
107
+ | | default | demo | minimal | remote | empty | preview | ambient |
108
+ | -- | ---- | ---- | ------- | ------ | ----- | ------- | ------- |
109
+ | 核心组件(Core components) | | | | | | | |
110
+ |   ;  ;  ;  ;  ;  ; ` istio-egressgateway ` | | ✔ ; | | | | | |
111
+ |   ;  ;  ;  ;  ;  ; ` istio-ingressgateway ` | ✔ ; | ✔ ; | | | | ✔ ; | |
112
+ |   ;  ;  ;  ;  ;  ; ` istiod ` | ✔ ; | ✔ ; | ✔ ; | | | ✔ ; | ✔ ; |
113
+ |   ;  ;  ;  ;  ;  ; ` CNI ` | | | | | | | ✔ ; |
114
+ |   ;  ;  ;  ;  ;  ; ` Ztunnel ` | | | | | | | ✔ ; |
46
115
47
116
{{< tip >}}
48
- 此外,还提供了一些其他特定的配置文件。更多相关信息,
49
- 请参阅 [ 平台安装 ] ( /zh/docs/setup/platform-setup ) 。
117
+ 如需进一步自定义 Istio,还可以安装多个附加组件。
118
+ 详情请参阅 [ 集成文档 ] ( /zh/docs/ops/integrations ) 。
50
119
{{< /tip >}}
51
120
52
- 标注 ✔ ; 的组件安装在每个配置文件中:
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 设置了必要或推荐的图表选项。
53
138
54
- | | default | demo | minimal | remote | empty | preview | ambient | | |
55
- | ------------------------------------------------------------| ----------| ----------| ----------| --------| -------| ----------| ----------| --| --|
56
- | 核心组件 | | | | | | | | | |
57
- |   ;  ;  ;  ;  ;  ; ` istio-egressgateway ` | | ✔ ; | | | | | | | |
58
- |   ;  ;  ;  ;  ;  ; ` istio-ingressgateway ` | ✔ ; | ✔ ; | | | | ✔ ; | | | |
59
- |   ;  ;  ;  ;  ;  ; ` istiod ` | ✔ ; | ✔ ; | ✔ ; | | | ✔ ; | ✔ ; | | |
60
- |   ;  ;  ;  ;  ;  ; ` CNI ` | | | | | | | ✔ ; | | |
61
- |   ;  ;  ;  ;  ;  ; ` Ztunnel ` | | | | | | | ✔ ; | | |
139
+ 1 . ** minikube** :为在 [ minikube] ( https://kubernetes.io/zh-cn/docs/tasks/tools/install-minikube/ )
140
+ 环境中安装 Istio 设置了必要或推荐的图表选项。
62
141
63
- 为了进一步自定义 Istio,还可以安装一些附加组件。
64
- 详情请参阅[ 集成] ( /zh/docs/ops/integrations ) 。
142
+ Istio 的[ 平台配置文件在此定义] ({{< github_tree >}}/manifests/helm-profiles),适用于 ` istioctl ` 和 ` helm ` 。
0 commit comments