-
Notifications
You must be signed in to change notification settings - Fork 14.5k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Add Chinese translation for Endpoints Slices #16929
Merged
Merged
Changes from all commits
Commits
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
132 changes: 132 additions & 0 deletions
132
content/zh/docs/concepts/services-networking/endpoint-slices.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,132 @@ | ||
--- | ||
reviewers: | ||
- freehan | ||
title: Endpoint Slices | ||
feature: | ||
title: Endpoint Slices | ||
description: > | ||
Kubernetes 集群中网络端点的可扩展跟踪。 | ||
|
||
content_template: templates/concept | ||
weight: 10 | ||
--- | ||
|
||
<!-- | ||
--- | ||
reviewers: | ||
- freehan | ||
title: Endpoint Slices | ||
feature: | ||
title: Endpoint Slices | ||
description: > | ||
Scalable tracking of network endpoints in a Kubernetes cluster. | ||
|
||
content_template: templates/concept | ||
weight: 10 | ||
--- | ||
--> | ||
|
||
{{% capture overview %}} | ||
|
||
{{< feature-state for_k8s_version="v1.16" state="alpha" >}} | ||
|
||
<!-- | ||
_Endpoint Slices_ provide a simple way to track network endpoints within a | ||
Kubernetes cluster. They offer a more scalable and extensible alternative to | ||
Endpoints. | ||
--> | ||
_Endpoint Slices_ 提供了一种简单的方法来跟踪 Kubernetes 集群中的网络端点(network endpoints)。它们为 Endpoints 提供了一种可伸缩和可拓展的替代方案。 | ||
|
||
{{% /capture %}} | ||
|
||
{{% capture body %}} | ||
|
||
<!-- | ||
## Endpoint Slice resources {#endpointslice-resource} | ||
|
||
In Kubernetes, an Endpoint Slice contains references to a set of network | ||
endpoints. The EndpointSlice controller automatically creates Endpoint Slices | ||
for a Kubernetes Service when a selector is specified. These Endpoint Slices | ||
will include references to any Pods that match the Service selector. Endpoint | ||
Slices group network endpoints together by unique Service and Port combinations. | ||
|
||
As an example, here's a sample EndpointSlice resource for the `example` | ||
Kubernetes Service. | ||
--> | ||
## Endpoint Slice 资源 {#endpointslice-resource} | ||
|
||
在 Kubernetes 中,`Endpoint Slice`包含对一组网络端点的引用。指定选择器后,EndpointSlice 控制器会自动为 Kubernetes 服务创建 Endpoint Slices。这些 Endpoint Slices 将包含对与服务选择器匹配的所有 Pod 的引用。Endpoint Slices 通过唯一的服务和端口组合将网络端点组织在一起。 | ||
|
||
例如,这里是 Kubernetes服务 `example` 的示例 EndpointSlice 资源。 | ||
|
||
```yaml | ||
apiVersion: discovery.k8s.io/v1alpha1 | ||
kind: EndpointSlice | ||
metadata: | ||
name: example-abc | ||
labels: | ||
kubernetes.io/service-name: example | ||
addressType: IP | ||
ports: | ||
- name: http | ||
protocol: TCP | ||
port: 80 | ||
endpoints: | ||
- addresses: | ||
- "10.1.2.3" | ||
- "2001:db8::1234:5678" | ||
conditions: | ||
ready: true | ||
hostname: pod-1 | ||
topology: | ||
kubernetes.io/hostname: node-1 | ||
topology.kubernetes.io/zone: us-west2-a | ||
``` | ||
|
||
<!-- | ||
By default, Endpoint Slices managed by the EndpointSlice controller will have no | ||
more than 100 endpoints each. Below this scale, Endpoint Slices should map 1:1 | ||
with Endpoints and Services and have similar performance. | ||
|
||
Endpoint Slices can act as the source of truth for kube-proxy when it comes to | ||
how to route internal traffic. When enabled, they should provide a performance | ||
improvement for services with large numbers of endpoints. | ||
|
||
## Motivation | ||
|
||
The Endpoints API has provided a simple and straightforward way of | ||
tracking network endpoints in Kubernetes. Unfortunately as Kubernetes clusters | ||
and Services have gotten larger, limitations of that API became more visible. | ||
Most notably, those included challenges with scaling to larger numbers of | ||
network endpoints. | ||
|
||
Since all network endpoints for a Service were stored in a single Endpoints | ||
resource, those resources could get quite large. That affected the performance | ||
of Kubernetes components (notably the master control plane) and resulted in | ||
significant amounts of network traffic and processing when Endpoints changed. | ||
Endpoint Slices help you mitigate those issues as well as provide an extensible | ||
platform for additional features such as topological routing. | ||
--> | ||
|
||
默认情况下,由 EndpointSlice 控制器管理的 Endpoint Slice 将有不超过 100 个 endpoints。低于此比例时,Endpoint Slices 应与 Endpoints 和服务进行 1:1 映射,并具有相似的性能。 | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. 下次请注意,一段英文,然后一段中文,有点过长,不方便review。谢谢理解。 There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. 好的,多谢建议。 |
||
|
||
当涉及如何路由内部流量时,Endpoint Slices 可以充当 kube-proxy 的真实来源。启用该功能后,在服务的 endpoints 规模庞大时会有可观的性能提升。 | ||
|
||
## 动机 | ||
|
||
Endpoints API 提供了一种简单明了的方法在 Kubernetes 中跟踪网络端点。不幸的是,随着 Kubernetes 集群与服务的增长,该 API 的局限性变得更加明显。最值得注意的是,这包含了扩展到更多网络端点的挑战。 | ||
|
||
由于服务的所有网络端点都存储在单个 Endpoints 资源中,因此这些资源可能会变得很大。这影响了 Kubernetes 组件(尤其是主控制平面)的性能,并在 Endpoints 发生更改时导致大量网络流量和处理。Endpoint Slices 可帮助您缓解这些问题并提供可扩展的 | ||
附加特性(例如拓扑路由)平台。 | ||
|
||
{{% /capture %}} | ||
|
||
{{% capture whatsnext %}} | ||
|
||
<!-- | ||
* [Enabling Endpoint Slices](/docs/tasks/administer-cluster/enabling-endpoint-slices) | ||
* Read [Connecting Applications with Services](/docs/concepts/services-networking/connect-applications-service/) | ||
--> | ||
* [启用 Endpoint Slices](/docs/tasks/administer-cluster/enabling-endpoint-slices) | ||
* 阅读 [Connecting Applications with Services](/docs/concepts/services-networking/connect-applications-service/) | ||
{{% /capture %}} |
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
建议保留英文原文,方便review
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
已改回英文原文
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
我的意思是保留英文原文注释
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
参考这个 https://github.com/kubernetes/website/pull/16925/files
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
刚刚理解错了,已修改