diff --git a/content/zh/docs/setup/additional-setup/customize-installation/index.md b/content/zh/docs/setup/additional-setup/customize-installation/index.md index d3dd2478fe..b6c273f754 100644 --- a/content/zh/docs/setup/additional-setup/customize-installation/index.md +++ b/content/zh/docs/setup/additional-setup/customize-installation/index.md @@ -42,14 +42,14 @@ $ istioctl install -f samples/operator/pilot-k8s.yaml $ istioctl install --set values.pilot.traceSampling=0.1 {{< /text >}} -Helm 值也可以在 `IstioOperator` CR(YAML 文件)中设置,就像[使用 Helm API 定制 Istio 设置](#customize-settings-using-the-helm) +Helm 值也可以在 `IstioOperator` CR(YAML 文件)中设置,就像[使用 Helm API 定制 Istio 设置](#customize-istio-settings-using-the-helm-api) 中描述的那样。 -如果您需要配置 Kubernetes 资源方面的设置,请用[定制 Kubernetes 设置](#customize-k-settings)中介绍的 +如果您需要配置 Kubernetes 资源方面的设置,请用[定制 Kubernetes 设置](#customize-kubernetes-settings)中介绍的 `IstioOperator` API。 {{< /tip >}} -### 识别 Istio 组件 {#identify-an-component} +### 识别 Istio 组件 {#identify-an-istio-component} `IstioOperator` API 定义的组件如下面表格所示: @@ -79,30 +79,30 @@ spec: 所有的组件共享一个通用 API,用来修改 Kubernetes 特定的设置,它在 `components..k8s` 路径下, 后续章节将会进一步描述它。 -### 定制 Kubernetes 设置 {#customize-k-settings} +### 定制 Kubernetes 设置 {#customize-kubernetes-settings} `IstioOperator` API 支持以一致性的方式定制每一个组件的 Kubernetes 设置。 每个组件都有一个 [`KubernetesResourceSpec`](/zh/docs/reference/config/istio.operator.v1alpha1/#KubernetesResourcesSpec), 它允许修改如下设置。使用此列表标识要定制的设置: -1. [Resources](https://kubernetes.io/zh-cn/docs/concepts/configuration/manage-compute-resources-container/#resource-requests-and-limits-of-pod-and-container) -1. [Readiness probes](https://kubernetes.io/zh-cn/docs/tasks/configure-pod-container/configure-liveness-readiness-probes/) -1. [Replica count](https://kubernetes.io/zh-cn/docs/concepts/workloads/controllers/deployment/) +1. [资源](https://kubernetes.io/zh-cn/docs/concepts/configuration/manage-resources-containers/#resource-requests-and-limits-of-pod-and-container) +1. [就绪探测](https://kubernetes.io/zh-cn/docs/tasks/configure-pod-container/configure-liveness-readiness-startup-probes/) +1. [副本数](https://kubernetes.io/zh-cn/docs/concepts/workloads/controllers/deployment/) 1. [`HorizontalPodAutoscaler`](https://kubernetes.io/zh-cn/docs/tasks/run-application/horizontal-pod-autoscale/) 1. [`PodDisruptionBudget`](https://kubernetes.io/zh-cn/docs/concepts/workloads/pods/disruptions/#how-disruption-budgets-work) -1. [Pod annotations](https://kubernetes.io/zh-cn/docs/concepts/overview/working-with-objects/annotations/) -1. [Service annotations](https://kubernetes.io/zh-cn/docs/concepts/overview/working-with-objects/annotations/) +1. [Pod 注解](https://kubernetes.io/zh-cn/docs/concepts/overview/working-with-objects/annotations/) +1. [服务(Service)注解](https://kubernetes.io/zh-cn/docs/concepts/overview/working-with-objects/annotations/) 1. [`ImagePullPolicy`](https://kubernetes.io/zh-cn/docs/concepts/containers/images/) -1. [Priority class name](https://kubernetes.io/zh-cn/docs/concepts/configuration/pod-priority-preemption/#priorityclass) -1. [Node selector](https://kubernetes.io/zh-cn/docs/concepts/configuration/assign-pod-node/#nodeselector) -1. [Affinity and anti-affinity](https://kubernetes.io/zh-cn/docs/concepts/configuration/assign-pod-node/#affinity-and-anti-affinity) -1. [Service](https://kubernetes.io/zh-cn/docs/concepts/services-networking/service/) -1. [Toleration](https://kubernetes.io/zh-cn/docs/concepts/configuration/taint-and-toleration/) -1. [Strategy](https://kubernetes.io/zh-cn/docs/concepts/workloads/controllers/deployment/) -1. [Env](https://kubernetes.io/zh-cn/docs/tasks/inject-data-application/define-environment-variable-container/) -1. [Pod security context](https://kubernetes.io/zh-cn/docs/tasks/configure-pod-container/security-context/#set-the-security-context-for-a-pod) -1. [Volumes and volume mounts](https://kubernetes.io/zh-cn/docs/concepts/storage/volumes/) +1. [优先级类名称](https://kubernetes.io/zh-cn/docs/concepts/scheduling-eviction/pod-priority-preemption/#priorityclass) +1. [节点选择器](https://kubernetes.io/zh-cn/docs/concepts/scheduling-eviction/assign-pod-node/#nodeselector) +1. [亲和性与反亲和性](https://kubernetes.io/zh-cn/docs/concepts/scheduling-eviction/assign-pod-node/#affinity-and-anti-affinity) +1. [服务(Service)](https://kubernetes.io/zh-cn/docs/concepts/services-networking/service/) +1. [容忍度](https://kubernetes.io/zh/docs/concepts/scheduling-eviction/taint-and-toleration) +1. [策略](https://kubernetes.io/zh-cn/docs/concepts/workloads/controllers/deployment/) +1. [环境变量](https://kubernetes.io/zh-cn/docs/tasks/inject-data-application/define-environment-variable-container/) +1. [Pod 安全性上下文](https://kubernetes.io/zh-cn/docs/tasks/configure-pod-container/security-context/#set-the-security-context-for-a-pod) +1. [卷及其挂载](https://kubernetes.io/zh-cn/docs/concepts/storage/volumes/) 所有这些 Kubernetes 设置均使用 Kubernetes API 定义,因此可以参考 [Kubernetes 文档](https://kubernetes.io/zh-cn/docs/concepts/) @@ -131,7 +131,7 @@ spec: $ istioctl install -f samples/operator/pilot-k8s.yaml {{< /text >}} -### 使用 Helm API 定制 Istio 设置 {#customize-settings-using-the-helm} +### 使用 Helm API 定制 Istio 设置 {#customize-istio-settings-using-the-helm-api} `IstioOperator` API 使用 `values` 字段为 [Helm API](https://archive.istio.io/v1.4/docs/reference/config/installation-options/) @@ -154,7 +154,7 @@ spec: Istio 社区推荐使用 `IstioOperator` API,因为它更一致、更有效、 且遵循[社区毕业流程](https://github.com/istio/community/blob/master/FEATURE-LIFECYCLE-CHECKLIST.md#feature-lifecycle-checklist)。 -### 配置网关 {#configure-gateways} +### 配置网关 {#configure-gateways} 网关因为支持定义多个入站、出站网关,所以它是一种特殊类型的组件。 在 [`IstioOperator` API](/zh/docs/reference/config/istio.operator.v1alpha1/) 中, @@ -224,15 +224,15 @@ spec: ## 高级安装定制 {#advanced-install-customization} -### 定制外部 chart 和配置项 {#customizing-external-charts-and-profiles} +### 定制外部 Chart 和配置项 {#customizing-external-charts-and-profiles} -`istioctl` 的 `install`、 `manifest generate` 和 `profile` 命令可以使用以下任意源来生成 chart 和 配置档: +`istioctl` 的 `install`、 `manifest generate` 和 `profile` 命令可以使用以下任意源来生成 Chart 和配置项: -- 内置的 chart。如果没有设置 `--manifests`,则用 default。 - 内置的 chart 和 Istio `.tgz` 发行包内 `manifests/` 目录下的内容相同。 -- 本地文件系统中的 chart,例如 `istioctl install --manifests istio-{{< istio_full_version >}}/manifests`。 +- 内置的 Chart。如果没有设置 `--manifests`,则用 default。 + 内置的 Chart 和 Istio `.tgz` 发行包内 `manifests/` 目录下的内容相同。 +- 本地文件系统中的 Chart,例如 `istioctl install --manifests istio-{{< istio_full_version >}}/manifests`。 -本地文件系统的 chart 和配置档可以通过编辑 `manifests/` 目录下的文件定制。 +本地文件系统的 Chart 和配置档可以通过编辑 `manifests/` 目录下的文件定制。 要进行广泛的更改,建议拷贝 `manifests` 目录,然后修改副本。 但请注意,`manifests` 目录中的内容结构必须要保留。 @@ -256,7 +256,7 @@ $ istioctl manifest generate --manifests mycharts/ -f manifests/profiles/custom1 只有需要在 `IstioOperatorSpec` 中指向一个配置档名称时,才需要创建定制配置档。 -### 为输出清单打补丁 {#patching-the-output-manifest} +### 为输出清单打补丁 {#patching-the-output-manifest} 传递给 `istioctl` 的 `IstioOperator` CR,用于生成输出清单,该清单包含将应用到集群的 Kubernetes 资源。 在输出的清单已经生成但没有应用之时,此清单可以通过 `IstioOperator`