[zh] make zh expressions consistent in changelog (#13240)

This commit is contained in:
Michael 2023-05-25 17:04:41 +08:00 committed by GitHub
parent d897781e03
commit 6ded1701d2
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
6 changed files with 70 additions and 57 deletions

View File

@ -11,19 +11,25 @@ test: no
## 概述{#overview}
本教程的目的是为如何配置两个或者多个 Kubernetes 集群组成的 Istio 网格提供操作引导。这不是唯一的操作方式,而是演示一个使用 Prometheus 遥测多集群的可行方案。
本教程的目的是为如何配置两个或者多个 Kubernetes 集群组成的 Istio 网格提供操作引导。
这不是唯一的操作方式,而是演示一个使用 Prometheus 遥测多集群的可行方案。
我们推荐 Istio 多集群监控使用 Prometheus其主要原因是基于 Prometheus 的[分层联邦](https://prometheus.io/docs/prometheus/latest/federation/#hierarchical-federation)Hierarchical Federation
我们推荐 Istio 多集群监控使用 Prometheus其主要原因是基于 Prometheus
的[分层联邦](https://prometheus.io/docs/prometheus/latest/federation/#hierarchical-federation)Hierarchical Federation
通过 Istio 部署到每个集群中的 Prometheus 实例作为初始收集器,然后将数据聚合到网格层次的 Prometheus 实例上。网格层次的 Prometheus 既可以部署在网格之外(外部),也可以部署在网格内的集群中。
通过 Istio 部署到每个集群中的 Prometheus 实例作为初始收集器,然后将数据聚合到网格层次的 Prometheus 实例上。
网格层次的 Prometheus 既可以部署在网格之外(外部),也可以部署在网格内的集群中。
## 安装 Istio 多集群{#multicluster-Istio-setup}
按照[多集群安装](/zh/docs/setup/install/multicluster/)部分,在[多集群部署模型](/zh/docs/ops/deployment/deployment-models/#multiple-clusters)中选择可行的模型配置 Istio 多集群。为了能够实现本教程的目的,让示例都能够运行,并提出以下警告:
按照[多集群安装](/zh/docs/setup/install/multicluster/)部分,
在[多集群部署模型](/zh/docs/ops/deployment/deployment-models/#multiple-clusters)中选择可行的模型配置 Istio 多集群。
为了能够实现本教程的目的,让示例都能够运行,并提出以下警告:
**确保在多集群中安装了一个 Istio Prometheus 集群实例!**
在每个集群中使用 Istio 独立部署的 Prometheus 是跨集群监控的基础通过联邦Federation的方式将 Prometheus 的生产就绪实例运行在网格外部或其中任意一个集群中。
在每个集群中使用 Istio 独立部署的 Prometheus 是跨集群监控的基础,
通过联邦Federation的方式将 Prometheus 的生产就绪实例运行在网格外部或其中任意一个集群中。
验证在多集群中运行的 Prometheus 实例:
@ -50,7 +56,8 @@ prometheus ClusterIP 10.8.4.109 <none> 9090/TCP 20h
{{< warning >}}
本教程演示了连接主集群的 Prometheus 实例,但不涉及安全考虑因素。
对于生产用途,请使用 HTTPS 确保对每个 Prometheus 端点的访问安全。此外,请采取预防措施,例如使用内部负载均衡而不是公共端点,并且配置适当的防火墙规则。
对于生产用途,请使用 HTTPS 确保对每个 Prometheus 端点的访问安全。
此外,请采取预防措施,例如使用内部负载均衡而不是公共端点,并且配置适当的防火墙规则。
{{< /warning >}}
Istio 提供了一种通过 [Gateway](/zh/docs/reference/config/networking/gateway/) 向外部暴露集群服务的方式。
@ -100,7 +107,7 @@ scrape_configs:
caption="监控 Istio 多集群的内部 Prometheus"
>}}
配置您的 Prometheus 使得可以同时访问 *主**从* Prometheus 实例:
配置您的 Prometheus 使得可以同时访问 **主****从** Prometheus 实例:
首先执行下面的命令:
@ -108,7 +115,7 @@ scrape_configs:
$ kubectl -n istio-system edit cm prometheus -o yaml
{{< /text >}}
然后给 *从* 集群添加配置(替换每个群集的 Ingress 域名和集群名称),并且给 *主* 集群添加一个配置:
然后给 **从** 集群添加配置(替换每个集群的 Ingress 域名和集群名称),并且给 **主** 集群添加一个配置:
{{< text yaml >}}
scrape_configs:
@ -120,7 +127,7 @@ scrape_configs:
params:
'match[]':
- '{job="kubernetes-pods}'
- '{job="kubernetes-pods"}'
static_configs:
- targets:

View File

@ -8,7 +8,7 @@ test: yes
---
`istioctl analyze` 是一个诊断工具,可以检测 Istio 配置的潜在问题。
它可以针对运行的集或一组本地配置文件运行。它还可以将两者结合起来使用,
它可以针对运行的集或一组本地配置文件运行。它还可以将两者结合起来使用,
从而允许您在将更改应用于集群之前发现问题。
## 一分钟入门 {#getting-started-in-under-a-minute}
@ -19,7 +19,7 @@ test: yes
$ istioctl analyze --all-namespaces
{{< /text >}}
就是这样!它会给任何合适的建议。
就是这样!它会给任何合适的建议。
例如,如果您忘记启用 Istio 注入(一个非常常见的问题),则会收到以下警告:
@ -40,16 +40,16 @@ $ istioctl analyze --namespace default
✔ No validation issues found when analyzing namespace: default.
{{< /text >}}
## 分析活动群集,本地文件或同时分析两者 {#analyzing-live-clusters-local-files-or-both}
## 分析活动集群、本地文件或同时分析两者 {#analyzing-live-clusters-local-files-or-both}
分析当前的活动集群,模拟在 `samples/bookinfo/networking` 目录下应用诸如
`bookinfo-gateway.yaml``destination-rule-all.yaml` 等额外 yaml
`bookinfo-gateway.yaml``destination-rule-all.yaml` 等额外 yaml
文件的效果:
{{< text syntax=bash snip_id=analyze_sample_destrule >}}
$ istioctl analyze @samples/bookinfo/networking/bookinfo-gateway.yaml@ @samples/bookinfo/networking/destination-rule-all.yaml@
Error [IST0101] (Gateway default/bookinfo-gateway samples/bookinfo/networking/bookinfo-gateway.yaml:7) Referenced selector not found: "istio=ingressgateway"
Error [IST0101] (VirtualService default/bookinfo samples/bookinfo/networking/bookinfo-gateway.yaml:39) Referenced host not found: "productpage"
Error [IST0101] (Gateway default/bookinfo-gateway samples/bookinfo/networking/bookinfo-gateway.yaml:9) Referenced selector not found: "istio=ingressgateway"
Error [IST0101] (VirtualService default/bookinfo samples/bookinfo/networking/bookinfo-gateway.yaml:41) Referenced host not found: "productpage"
Error: Analyzers found issues when analyzing namespace: default.
See https://istio.io/v{{< istio_version >}}/docs/reference/config/analysis for more information about causes and resolutions.
{{< /text >}}
@ -87,12 +87,11 @@ $ istioctl analyze --use-kube=false samples/bookinfo/networking/*.yaml
从 Istio 1.5 开始,可以通过 `istiod.enableAnalysis` 标志将 Galley
设置为与其主要负责的配置分发一起执行配置分析。
此分析使用与 `istioctl analysis` 相同的逻辑和错误消息。
来自分析的验证消息被写入受影响的 Istio 资源的状态子资源。
例如:如果您的 "ratings" VirtualService 上网关配置错误,运行
`kubectl get virtualservice ratings` 会给类似这样的结果:
`kubectl get virtualservice ratings` 会给类似这样的结果:
{{< text syntax=yaml snip_id=vs_yaml_with_status >}}
apiVersion: networking.istio.io/v1beta1
@ -122,7 +121,7 @@ status:
可用于旧版本。
- 虽然可以轻松查看特定资源的问题,但很难全面了解网格中的验证状态。
您可以通过以下方式命令此功能:
您可以通过以下命令启动此功能:
{{< text syntax=bash snip_id=install_with_custom_config_analysis >}}
$ istioctl install --set values.global.istiod.enableAnalysis=true
@ -138,7 +137,7 @@ $ istioctl analyze -k --namespace frod
Info [IST0102] (Namespace frod) The namespace is not enabled for Istio injection. Run 'kubectl label namespace frod istio-injection=enabled' to enable it, or 'kubectl label namespace frod istio-injection=disabled' to explicitly mark it as not needing injection.
{{< /text >}}
由于您无权更新命名空间,因此无法通过注命名空间来解析消息。相反,
由于您无权更新命名空间,因此无法通过注命名空间来解析消息。相反,
您可以使用 `istioctl analysis` 来抑制资源上的上述消息:
{{< text syntax=bash snip_id=analyze_suppress0102 >}}
@ -148,23 +147,23 @@ $ istioctl analyze -k --namespace frod --suppress "IST0102=Namespace frod"
当引用:`<kind> <name>.<namespace>` 资源时,用于抑制的语法与整个
`istioctl` 中使用的语法相同,或者仅使用 `<kind> <name>` 对于 `Namespace`
集群范围的资源。如果你想抑制多个对象,你可以重复 `--suppress` 参数或使用通配符:
集群范围的资源。如果您想抑制多个对象,您可以重复 `--suppress` 参数或使用通配符:
{{< text syntax=bash snip_id=analyze_suppress_frod_0107_baz >}}
$ # Suppress code IST0102 on namespace frod and IST0107 on all pods in namespace baz
$ istioctl analyze -k --all-namespaces --suppress "IST0102=Namespace frod" --suppress "IST0107=Pod *.baz"
{{< /text >}}
### 通过注忽略特定的分析器消息 {#ignoring-specific-analyzer-messages-via-annotations}
### 通过注忽略特定的分析器消息 {#ignoring-specific-analyzer-messages-via-annotations}
您也可以使用资源上的注忽略特定的分析器消息。例如,要忽略资源
您也可以使用资源上的注忽略特定的分析器消息。例如,要忽略资源
`deployment/my deployment` 上的代码IST0107`MisplacedAnnotation`
{{< text syntax=bash snip_id=annotate_for_deployment_suppression >}}
$ kubectl annotate deployment my-deployment galley.istio.io/analyze-suppress=IST0107
{{< /text >}}
要忽略资源的多个代码,请用逗号分隔每个代码:
要忽略资源的多个代码,请用英文逗号分隔每个代码:
{{< text syntax=bash snip_id=annotate_for_deployment_suppression_107 >}}
$ kubectl annotate deployment my-deployment galley.istio.io/analyze-suppress=IST0107,IST0002
@ -185,16 +184,16 @@ $ kubectl annotate deployment my-deployment galley.istio.io/analyze-suppress=IST
我们已经有针对这种特定情况的分析器,因此这仅是一个示例,用于说明您应提供的信息类型。
## Q&A{#q-a}
## Q&A
- **此工具针对的是哪个 Istio 版本?**
和其它 `istioctl` 工具一样,我们通常建议下载一个和您集群中部署版本相匹配的版本来使用。
就目前而言analysis 是向后兼容的,所以可以在运行 Istio 1.1 的集群上使用 1.4 版本的
就目前而言analysis 是向后兼容的,所以可以在运行 Istio 1.1 的集群上使用 1.4 版本的
`istioctl analyze`,并且会得到有用的反馈。对老版本 Istio 没有意义的分析规则将被跳过。
如果决定使用最新的 `istioctl` 来对一个运行老版本 Istio 的集群进行分析,
如果决定使用最新的 `istioctl` 来对一个运行老版本 Istio 的集群进行分析,
我们建议您将其保存在一个独立的目录中,和用于部署 Istio 的二进制文件分开。
- **现在支持哪些分析器?**
@ -202,11 +201,11 @@ $ kubectl annotate deployment my-deployment galley.istio.io/analyze-suppress=IST
我们仍在努力编写分析器文档。目前,您可以在
[Istio 源代码]({{< github_tree >}}/pkg/config/analysis/analyzers)中看到所有分析器。
还可以了解一下目前支持哪些[配置分析消息](/zh/docs/reference/config/analysis/)。
还可以了解一下目前支持哪些[配置分析消息](/zh/docs/reference/config/analysis/)。
- **analysis 分析对我的集群有影响吗?**
分析永远不会更改配置状态。这是一个完全只读的操作,因此永远不会更改集的状态。
分析永远不会更改配置状态。这是一个完全只读的操作,因此永远不会更改集的状态。
- **超出配置范围的又如何分析呢?**

View File

@ -28,6 +28,7 @@ release: 1.16.1
- **修复** 修复了 ServiceEntries 使用 `DNS_ROUND_ROBIN` 能够指定 0 个端点的问题。
([Issue #42184](https://github.com/istio/istio/issues/42184))
- **修复** 修复了当 `automountServiceAccountToken` 被设置为 false 且 `PILOT_CERT_PROVIDER` 环境变量被设置为 `kubernetes` 时阻止 `istio-proxy` 访问根 CA 的问题。
- **修复** 修复了当 `automountServiceAccountToken` 被设置为 false 且
`PILOT_CERT_PROVIDER` 环境变量被设置为 `kubernetes` 时阻止 `istio-proxy` 访问根 CA 的问题。
- **修复** 修复了网关 Pod 不遵守 Helm 值中所指定 `global.imagePullPolicy` 的问题。

View File

@ -73,7 +73,7 @@ weight: 10
如果自定义使用带有 Wasm 属性的 CEL 表达式,则很可能会受到影响。
通过将控制平面特性标志 `TELEMETRY_USE_NATIVE_STATS` 设置为 `true` 来启用此项变更。
- **新增** 新增支持将 OpenTelemetry 跟踪提供程序与 Telemetry API 结合使用。
- **新增** 新增支持将 OpenTelemetry 跟踪提供程序与 Telemetry API 结合使用。
([Issue #40027](https://github.com/istio/istio/issues/40027))
- **修复** 修复了允许多个正则表达式具有相同标记名称的问题。
@ -94,10 +94,12 @@ weight: 10
## 安装{#installation}
- **新增** 新增了 `seccompProfile` 字段以便按照 [https://kubernetes.io/zh-cn/docs/tutorials/security/seccomp/](https://kubernetes.io/docs/tutorials/security/seccomp/) 在容器 `securityContext` 中设置 `seccompProfile` 字段。
- **新增** 新增了 `seccompProfile` 字段以便按照
[https://kubernetes.io/zh-cn/docs/tutorials/security/seccomp/](https://kubernetes.io/docs/tutorials/security/seccomp/)
在容器 `securityContext` 中设置 `seccompProfile` 字段。
([Issue #39791](https://github.com/istio/istio/issues/39791))
- **新增** 新增全新的 Istio Operator `remote` 配置文件并废弃了等效的 `external` 配置文件。
- **新增** 新增全新的 Istio Operator `remote` 配置文件并废弃了等效的 `external` 配置文件。
([Issue #39797](https://github.com/istio/istio/issues/39797))
- **新增** 新增了 `--cluster-specific` 标志到 `istioctl manifest generate`
@ -122,16 +124,16 @@ weight: 10
## istioctl
- **新增**`istioctl operator remove` 新增 `--skip-confirmation` 标志,为 operator 移除添加了确认机制。
- **新增**`istioctl operator remove` 新增 `--skip-confirmation` 标志,为 operator 移除添加了确认机制。
([Issue #41244](https://github.com/istio/istio/issues/41244))
- **新增** 新增运行 `istioctl uninstall` 时预先检查修订版本。
- **新增** 新增运行 `istioctl uninstall` 时预先检查修订版本。
([Issue #40598](https://github.com/istio/istio/issues/40598))
- **新增**`istioctl bug-report` 新增 `--rps-limit` 标志,允许提高到 Kubernetes API 服务器的每秒请求限制,
- **新增**`istioctl bug-report` 新增 `--rps-limit` 标志,允许提高到 Kubernetes API 服务器的每秒请求限制,
这可以大大减少收集错误报告的时间。
- **新增** 新增 `istioctl experimental check-inject` 特性以描述为什么基于当前运行的 Webhook 会/不会或曾经/从未进行注入。
- **新增** 新增 `istioctl experimental check-inject` 特性以描述为什么基于当前运行的 Webhook 会/不会或曾经/从未进行注入。
([Issue #38299](https://github.com/istio/istio/issues/38299))
- **修复** 修复了设置 `exportTo` 字段和 `networking.istio.io/exportTo` 注释会导致不正确 IST0101 消息的问题。
@ -144,5 +146,6 @@ weight: 10
## 文档变更{#documentation-changes}
- **新增** `build_push_update_images.sh` 现在支持 `--multiarch-images` 参数以便在 bookinfo 应用程序中构建多架构容器镜像。
- **新增** `build_push_update_images.sh` 现在新增了对 `--multiarch-images` 参数的支持,
以便在 bookinfo 应用程序中构建多架构容器镜像。
([Issue #40405](https://github.com/istio/istio/issues/40405))

View File

@ -10,26 +10,26 @@ release: 1.17.1
此版本包含了一些改进稳健性的漏洞修复。
此发布说明描述了 Istio 1.17.0 和 Istio 1.17.1 之间的不同之处。
此版本包括2023-02-14 发布的Go 1.20.1 中对 `crypto/tls``mime/multipart``net/http` 和 `path/filepath` 包的安全修复。
此版本包括2023-02-14 发布的Go 1.20.1 中对 `crypto/tls`、`mime/multipart`、`net/http` 和 `path/filepath` 包的安全修复。
{{< relnote >}}
## 变更{#changes}
- **新增** 支持修改 gRPC keepalive 环境变量的值。
- **新增** 新增了支持修改 gRPC keepalive 环境变量的值。
([Issue #42398](https://github.com/istio/istio/pull/42398))
- **修复** `ALL_METRICS` 不能预期禁用 Metrics 的问题。
- **修复** 修复了 `ALL_METRICS` 不能按预期禁用 Metrics 的问题。
([Issue #43178](https://github.com/istio/istio/issues/43178))
- **修复**`PeerCertificateVerifier` 被创建时忽略默认 CA 证书。
- **修复** 修复了`PeerCertificateVerifier` 被创建时忽略默认 CA 证书的问题
([PR #43337](https://github.com/istio/istio/pull/43337))
- **修复** istiod 不会在 Kubernetes Gateway 的 Deployment 和 Service 发生更改时对其进行调协
- **修复** 修复了 istiod 不会在 Kubernetes Gateway 的 Deployment 和 Service 发生变化时对其进行调协的问题
([Issue #43332](https://github.com/istio/istio/issues/43332))
- **修复** 上报 Gateway API 中 Gateway 资源的 `Programmed` 条件。
- **修复** 修复了上报 Gateway API 中 Gateway 资源的 `Programmed` 条件的问题
([Issue #43498](https://github.com/istio/istio/issues/43498))
- **修复** 更新服务的 `ExternalName` 不生效的问题。
- **修复** 修复了更新服务的 `ExternalName` 不生效的问题。
([Issue #43440](https://github.com/istio/istio/issues/43440))

View File

@ -35,42 +35,45 @@ release: 1.17.2
## 变更{#changes}
- **新增** 支持将额外的信任域联邦从 `caCertificates` 推送到对等 SAN 验证器。
- **新增** 新增了将额外的信任域联邦从 `caCertificates` 推送到对等 SAN 验证器的支持
([Issue #41666](https://github.com/istio/istio/issues/41666))
- **修复** 当标签为 `istio.io/rev=<tag>`在注入的网关中覆盖 `istio.io/rev` 标签。
- **修复** 修复了当标签为 `istio.io/rev=<tag>` 时在注入的网关中覆盖 `istio.io/rev` 标签的问题
([Issue #33237](https://github.com/istio/istio/issues/33237))
- **修复** 无法在 `ProxyConfig` 中禁用链路的问题。
- **修复** 修复了无法在 `ProxyConfig` 中禁用链路的问题。
([Issue #31809](https://github.com/istio/istio/issues/31809))
- **修复** 当头信息值使用自定义格式时 Admission Webhook 失败。
- **修复** 修复了当头信息值使用自定义格式时 Admission Webhook 失败的问题
([Issue #42749](https://github.com/istio/istio/issues/42749))
- **修复** 基于流量流向应用访问日志配置时导致异常行为的问题。
- **修复** 修复了基于流量流向应用访问日志配置时导致异常行为的问题。
通过此修复,`CLIENT` 或 `SERVER` 的访问日志配置将不会相互影响。
([Issue # 43371](https://github.com/istio/istio/issues/43371))
- **修复** `Cluster.ConnectTimeout` 类型的 `EnvoyFilter` 影响不相关 `Clusters` 的问题。
- **修复** 修复了 `Cluster.ConnectTimeout` 类型的 `EnvoyFilter` 影响不相关 `Clusters` 的问题。
([Issue #43435](https://github.com/istio/istio/issues/43435))
- **修复**`istioctl analyze` 中的一个错误,当分析的命名空间中存在没有选择器的服务时,会丢失一些消息。
- **修复** 修复了 `istioctl analyze` 中的一个错误,
即当分析的命名空间中存在没有选择器的服务时,会丢失一些消息。
([PR #43678](https://github.com/istio/istio/pull/43678))
- **修复** `istioctl` 命令针对资源的命名空间解析。
- **修复** 修复了 `istioctl` 命令针对资源的命名空间解析的问题
([Issue #43691](https://github.com/istio/istio/issues/43691))
- **修复** 自动分配的服务条目 IP 在主机重用时发生变化的问题。
- **修复** 修复了自动分配的服务条目 IP 在主机重用时发生变化的问题。
([Issue #43858](https://github.com/istio/istio/issues/43858))
- **修复** 当 istiod 升级到 1.17 后,RBAC 更新未发送到旧代理的问题。
- **修复** 修复了当 istiod 升级到 1.17 后 RBAC 更新未发送到旧代理的问题。
([Issue #43785](https://github.com/istio/istio/issues/43785))
- **修复** 在验证 webhook 控制器中达到限流的循环重试中的调谐逻辑。当配置错误的情况下,该操作会大大减少抖动(以及生成的日志)。
- **修复** 修复了在验证 Webhook 控制器中达到限流的循环重试中的调谐逻辑。
本次修复可以在配置错误时大大减少抖动(以及生成的日志)。
([Issue #32210](https://github.com/istio/istio/issues/32210))
- **修复** 导致当 VM 使用自动注册时忽略掉在 `WorkloadGroup` 中定义的标签的问题。
- **修复** 修复了当 VM 使用自动注册时忽略掉在 `WorkloadGroup` 中定义的标签的问题。
([PR #44021](https://github.com/istio/istio/pull/44021))
- **修复** 当未启用 `PILOT_ENABLE_CONFIG_DISTRIBUTION_TRACKING``istioctl experimental wait` 中存在无法辨认的消息。
- **修复** 修复了 `PILOT_ENABLE_CONFIG_DISTRIBUTION_TRACKING` 未被启用时
`istioctl experimental wait` 中存在无法辨认消息的问题。
([Issue #42967](https://github.com/istio/istio/issues/42967))