mirror of https://github.com/istio/istio.io.git
[zh] Sync additional-setup/config-profiles/ (#16624)
Signed-off-by: windsonsea <haifeng.yao@daocloud.io>
This commit is contained in:
Michael Yao
GitHub
parent
87448ff27d
commit
e40efd25cb
|
|
@ -10,13 +10,69 @@ test: n/a
|
|||
---
|
||||
|
||||
本页面描述了在[安装 Istio](/zh/docs/setup/install/istioctl/) 时所能够使用的内置配置文件。
|
||||
这些配置文件提供了对 Istio 控制平面和 Istio 数据平面 Sidecar 的定制内容。
|
||||
|
||||
您可以从其中一个 [Istio 的内置配置文件]({{< github_tree >}}/manifests/profiles)之一开始入手，
|
||||
然后根据您的特定需求来进一步[自定义配置文件](/zh/docs/setup/additional-setup/customize-installation/)。
|
||||
当前提供以下几种内置配置文件：
|
||||
这些配置文件是内置于 Helm Chart 中的一组带有名称的覆盖集合，在通过
|
||||
`helm` 或 `istioctl` 安装 Istio 时可以使用这些配置文件。
|
||||
|
||||
1. **default**：根据 [`IstioOperator` API](/zh/docs/reference/config/istio.operator.v1alpha1/) 的默认设置来启用组件。
|
||||
这些配置文件为常见的部署拓扑结构和目标平台提供了对 Istio 控制面和数据面的高级定制能力。
|
||||
|
||||
{{< tip >}}
|
||||
配置文件可以与其他值覆盖或参数组合使用，
|
||||
因此配置文件中设置的任何单独值都可以通过在命令中添加 `--set` 参数手动覆盖。
|
||||
{{< /tip >}}
|
||||
|
||||
配置文件分为两类：**部署**配置文件和**平台**配置文件，建议同时使用这两类配置文件。
|
||||
|
||||
- **部署**配置文件用于为特定部署拓扑（如 `default`、`remote`、`ambient` 等）提供合理的默认设置。
|
||||
- **平台**配置文件用于为特定目标平台（如 `eks`、`gke`、`openshift` 等）提供必要的平台特定默认设置。
|
||||
|
||||
例如，如果您希望在 GKE 上安装 `default` Sidecar 数据面，建议使用如下部署和平台配置文件作为起点：
|
||||
|
||||
{{< tabset category-name="install-method" >}}
|
||||
|
||||
{{< tab name="Helm" category-value="helm" >}}
|
||||
|
||||
对于 Helm，请为您安装的每个 Chart 指定相同的 `profile` 和 `platform`，例如安装 `istiod`：
|
||||
|
||||
{{< text syntax=bash snip_id=install_istiod_helm_platform >}}
|
||||
$ helm install istiod istio/istiod -n istio-system --set profile=default --set global.platform=gke --wait
|
||||
{{< /text >}}
|
||||
|
||||
{{< /tab >}}
|
||||
|
||||
{{< tab name="istioctl" category-value="istioctl" >}}
|
||||
|
||||
对于 `istioctl`，以参数形式传入相同的 `profile` 和 `platform`：
|
||||
|
||||
{{< text syntax=bash snip_id=install_istiod_istioctl_platform >}}
|
||||
$ istioctl install --set profile=default --set values.global.platform=gke
|
||||
{{< /text >}}
|
||||
|
||||
{{< /tab >}}
|
||||
|
||||
{{< /tabset >}}
|
||||
|
||||
{{< warning >}}
|
||||
请注意，`helm` 和 `istioctl` 安装方式之间的一个关键区别是：
|
||||
`istioctl` 的配置文件中还包含了将由 `istioctl` 自动安装的 Istio 组件列表。
|
||||
|
||||
而 `helm` 并不会这样做，用户需要单独使用 `helm install` 安装每一个所需的
|
||||
Istio 组件，并为每个组件单独提供所需的配置文件参数。
|
||||
|
||||
您可以将 `istioctl` 和 `helm` 理解为共享相同名称、相同内容的配置文件，但
|
||||
`istioctl` 会基于所选配置文件自动决定安装哪些组件，因此只需一条命令就能实现完整的安装效果。
|
||||
{{< /warning >}}
|
||||
|
||||
## 部署配置文件 {#deployment-profiles}
|
||||
|
||||
以下是当前可用于 `istioctl` 和 `helm` 安装方式的内置于部署配置文件。
|
||||
请注意，这些配置文件本质上只是 Helm 值的预设集合，并不是安装 Istio 的强制要求，
|
||||
但它们为新用户提供了便捷的基础配置，推荐使用。此外，
|
||||
您还可以[根据具体需求自定义配置](/zh/docs/setup/additional-setup/customize-installation/)，
|
||||
超出配置文件所提供的范围。当前提供以下几种内置配置文件：
|
||||
|
||||
1. **default**：根据 [`IstioOperator` API](/zh/docs/reference/config/istio.operator.v1alpha1/)
|
||||
的默认设置来启用组件。
|
||||
建议用于生产部署和[多集群网格](/zh/docs/ops/deployment/deployment-models/#multiple-clusters)
|
||||
中的{{< gloss "primary cluster" >}}主集群{{< /gloss >}}。
|
||||
|
||||
|
|
@ -37,28 +93,50 @@ test: n/a
|
|||
或者由[多集群网格](/zh/docs/ops/deployment/deployment-models/#multiple-clusters)的
|
||||
{{< gloss "primary cluster" >}}主集群{{< /gloss >}}中的控制平面管理。
|
||||
|
||||
1. **ambient**：Ambient 配置文件旨在帮助您开始使用 [Ambient 模式](/zh/docs/ambient)。
|
||||
|
||||
1. **empty**：不部署任何内容。可以作为自定义配置的基本配置文件。
|
||||
|
||||
1. **preview**：预览文件包含的功能都属于实验性阶段。该配置文件是为了探索 Istio 的新功能。
|
||||
确保稳定性、安全性和性能（使用风险需自负）。
|
||||
|
||||
1. **ambient**：Ambient 配置文件旨在帮助您开始使用 [Ambient 模式](/zh/docs/ambient)。
|
||||
Istio 的[部署配置文件值集合在此定义]({{< github_tree >}}/manifests/helm-profiles)，适用于 `istioctl` 和 `helm`。
|
||||
|
||||
仅在使用 `istioctl` 时，指定配置文件还会**自动选择**某些 Istio 组件进行安装，这些组件在下表中以 ✔ 标记：
|
||||
|
||||
| | default | demo | minimal | remote | empty | preview | ambient |
|
||||
| -- | ---- | ---- | ------- | ------ | ----- | ------- | ------- |
|
||||
| 核心组件（Core components） | | | | | | | |
|
||||
| `istio-egressgateway` | | ✔ | | | | | |
|
||||
| `istio-ingressgateway` | ✔ | ✔ | | | | ✔ | |
|
||||
| `istiod` | ✔ | ✔ | ✔ | | | ✔ | ✔ |
|
||||
| `CNI` | | | | | | | ✔ |
|
||||
| `Ztunnel` | | | | | | | ✔ |
|
||||
|
||||
{{< tip >}}
|
||||
此外，还提供了一些其他特定的配置文件。更多相关信息，
|
||||
请参阅[平台安装](/zh/docs/setup/platform-setup)。
|
||||
如需进一步自定义 Istio，还可以安装多个附加组件。
|
||||
详情请参阅[集成文档](/zh/docs/ops/integrations)。
|
||||
{{< /tip >}}
|
||||
|
||||
标注 ✔ 的组件安装在每个配置文件中：
|
||||
## 平台配置文件 {#platform-profiles}
|
||||
|
||||
| | default | demo | minimal | remote | empty | preview | ambient | | |
|
||||
|------------------------------------------------------------|----------|----------|----------|--------|-------|----------|----------|--|--|
|
||||
| 核心组件 | | | | | | | | | |
|
||||
| `istio-egressgateway` | | ✔ | | | | | | | |
|
||||
| `istio-ingressgateway` | ✔ | ✔ | | | | ✔ | | | |
|
||||
| `istiod` | ✔ | ✔ | ✔ | | | ✔ | ✔ | | |
|
||||
| `CNI` | | | | | | | ✔ | | |
|
||||
| `Ztunnel` | | | | | | | ✔ | | |
|
||||
以下是目前可用于 `istioctl` 和 `helm` 安装方式的内置于平台配置文件。请注意，
|
||||
这些配置文件本质上只是 Helm 值的预设集合，虽然在这些环境中安装 Istio
|
||||
并不强制使用它们，但它们提供了方便的基础设置，推荐新用户使用：
|
||||
|
||||
为了进一步自定义 Istio，还可以安装一些附加组件。
|
||||
详情请参阅[集成](/zh/docs/ops/integrations)。
|
||||
1. **gke**：为在 Google Kubernetes Engine（GKE）环境中安装 Istio 设置了必要或推荐的图表选项。
|
||||
|
||||
1. **eks**：为在 Amazon Elastic Kubernetes Service（EKS）环境中安装 Istio 设置了必要或推荐的图表选项。
|
||||
|
||||
1. **openshift**：为在 OpenShift 环境中安装 Istio 设置了必要或推荐的图表选项。
|
||||
|
||||
1. **k3d**：为在 [k3d](https://k3d.io/) 环境中安装 Istio 设置了必要或推荐的图表选项。
|
||||
|
||||
1. **k3s**：为在 [K3s](https://k3s.io/) 环境中安装 Istio 设置了必要或推荐的图表选项。
|
||||
|
||||
1. **microk8s**：为在 [MicroK8s](https://microk8s.io/) 环境中安装 Istio 设置了必要或推荐的图表选项。
|
||||
|
||||
1. **minikube**：为在 [minikube](https://kubernetes.io/zh-cn/docs/tasks/tools/install-minikube/)
|
||||
环境中安装 Istio 设置了必要或推荐的图表选项。
|
||||
|
||||
Istio 的[平台配置文件在此定义]({{< github_tree >}}/manifests/helm-profiles)，适用于 `istioctl` 和 `helm`。
|
||||
|
|
|
|||
Loading…
Reference in New Issue