Skip to content

Commit 0182864

Browse files
authored
Merge pull request #37230 from liangyongzhenya/sync/apiserverzh
[zh] sync/docs/concepts/extend-kubernetes/api-extension/apiserver-agg…
2 parents c246251 + 83f1454 commit 0182864

File tree

1 file changed

+22
-7
lines changed

1 file changed

+22
-7
lines changed

content/zh-cn/docs/concepts/extend-kubernetes/api-extension/apiserver-aggregation.md

Lines changed: 22 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -17,8 +17,10 @@ weight: 20
1717
<!-- overview -->
1818

1919
<!--
20-
The aggregation layer allows Kubernetes to be extended with additional APIs, beyond what is offered by the core Kubernetes APIs.
21-
The additional APIs can either be ready-made solutions such as a [metrics server](https://github.com/kubernetes-sigs/metrics-server), or APIs that you develop yourself.
20+
The aggregation layer allows Kubernetes to be extended with additional APIs, beyond what is
21+
offered by the core Kubernetes APIs.
22+
The additional APIs can either be ready-made solutions such as a
23+
[metrics server](https://github.com/kubernetes-sigs/metrics-server), or APIs that you develop yourself.
2224
-->
2325
使用聚合层(Aggregation Layer),用户可以通过附加的 API 扩展 Kubernetes,
2426
而不局限于 Kubernetes 核心 API 提供的功能。
@@ -27,7 +29,10 @@ The additional APIs can either be ready-made solutions such as a [metrics server
2729
或者你自己开发的 API。
2830

2931
<!--
30-
The aggregation layer is different from [Custom Resources](/docs/concepts/extend-kubernetes/api-extension/custom-resources/), which are a way to make the {{< glossary_tooltip term_id="kube-apiserver" text="kube-apiserver" >}} recognise new kinds of object.
32+
The aggregation layer is different from
33+
[Custom Resources](/docs/concepts/extend-kubernetes/api-extension/custom-resources/),
34+
which are a way to make the {{< glossary_tooltip term_id="kube-apiserver" text="kube-apiserver" >}}
35+
recognise new kinds of object.
3136
-->
3237
聚合层不同于
3338
[定制资源(Custom Resources)](/zh-cn/docs/concepts/extend-kubernetes/api-extension/custom-resources/)
@@ -39,7 +44,11 @@ The aggregation layer is different from [Custom Resources](/docs/concepts/extend
3944
<!--
4045
## Aggregation layer
4146
42-
The aggregation layer runs in-process with the kube-apiserver. Until an extension resource is registered, the aggregation layer will do nothing. To register an API, you add an _APIService_ object, which "claims" the URL path in the Kubernetes API. At that point, the aggregation layer will proxy anything sent to that API path (e.g. `/apis/myextension.mycompany.io/v1/…`) to the registered APIService.
47+
The aggregation layer runs in-process with the kube-apiserver. Until an extension resource is
48+
registered, the aggregation layer will do nothing. To register an API, you add an _APIService_
49+
object, which "claims" the URL path in the Kubernetes API. At that point, the aggregation layer
50+
will proxy anything sent to that API path (e.g. `/apis/myextension.mycompany.io/v1/…`) to the
51+
registered APIService.
4352
-->
4453
## 聚合层 {#aggregation-layer}
4554

@@ -49,7 +58,11 @@ The aggregation layer runs in-process with the kube-apiserver. Until an extensio
4958
转发到已注册的 APIService。
5059

5160
<!--
52-
The most common way to implement the APIService is to run an *extension API server* in Pod(s) that run in your cluster. If you're using the extension API server to manage resources in your cluster, the extension API server (also written as "extension-apiserver") is typically paired with one or more {{< glossary_tooltip text="controllers" term_id="controller" >}}. The apiserver-builder library provides a skeleton for both extension API servers and the associated controller(s).
61+
The most common way to implement the APIService is to run an *extension API server* in Pod(s) that
62+
run in your cluster. If you're using the extension API server to manage resources in your cluster,
63+
the extension API server (also written as "extension-apiserver") is typically paired with one or
64+
more {{< glossary_tooltip text="controllers" term_id="controller" >}}. The apiserver-builder
65+
library provides a skeleton for both extension API servers and the associated controller(s).
5366
-->
5467
APIService 的最常见实现方式是在集群中某 Pod 内运行 **扩展 API 服务器**
5568
如果你在使用扩展 API 服务器来管理集群中的资源,该扩展 API 服务器(也被写成“extension-apiserver”)
@@ -62,7 +75,8 @@ apiserver-builder 库同时提供构造扩展 API 服务器和控制器框架代
6275
Extension API servers should have low latency networking to and from the kube-apiserver.
6376
Discovery requests are required to round-trip from the kube-apiserver in five seconds or less.
6477
65-
If your extension API server cannot achieve that latency requirement, consider making changes that let you meet it.
78+
If your extension API server cannot achieve that latency requirement, consider making changes that
79+
let you meet it.
6680
-->
6781
### 响应延迟 {#response-latency}
6882

@@ -78,7 +92,8 @@ If your extension API server cannot achieve that latency requirement, consider m
7892
* Then, [setup an extension api-server](/docs/tasks/extend-kubernetes/setup-extension-api-server/) to work with the aggregation layer.
7993
* Read about [APIService](/docs/reference/kubernetes-api/cluster-resources/api-service-v1/) in the API reference
8094
81-
Alternatively: learn how to [extend the Kubernetes API using Custom Resource Definitions](/docs/tasks/extend-kubernetes/custom-resources/custom-resource-definitions/).
95+
Alternatively: learn how to
96+
[extend the Kubernetes API using Custom Resource Definitions](/docs/tasks/extend-kubernetes/custom-resources/custom-resource-definitions/).
8297
-->
8398
* 阅读[配置聚合层](/zh-cn/docs/tasks/extend-kubernetes/configure-aggregation-layer/) 文档,
8499
了解如何在自己的环境中启用聚合器。

0 commit comments

Comments
 (0)