You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
title: Extending the Kubernetes API with the aggregation layer
8
+
title: Kubernetes API Aggregation Layer
9
9
reviewers:
10
10
- lavalamp
11
11
- cheftako
@@ -18,47 +18,44 @@ weight: 20
18
18
19
19
<!--
20
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.
21
22
-->
22
-
使用聚合层(Aggregation Layer),用户可以通过额外的 API 扩展 Kubernetes,
23
+
使用聚合层(Aggregation Layer),用户可以通过附加的 API 扩展 Kubernetes,
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.
27
-
28
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.
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, users must 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.
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.
45
43
-->
46
44
## 聚合层 {#aggregation-layer}
47
45
48
46
聚合层在 kube-apiserver 进程内运行。在扩展资源注册之前,聚合层不做任何事情。
49
-
要注册 API,用户必须添加一个 APIService 对象,用它来“申领” Kubernetes API 中的 URL 路径。
50
-
自此以后,聚合层将会把发给该 API 路径的所有内容(例如 `/apis/myextension.mycompany.io/v1/…`)
47
+
要注册 API,你可以添加一个 **APIService** 对象,用它来“申领” Kubernetes API 中的 URL 路径。
48
+
自此以后,聚合层将把发给该 API 路径的所有内容(例如 `/apis/myextension.mycompany.io/v1/…`)
51
49
转发到已注册的 APIService。
52
50
53
51
<!--
54
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).
55
53
-->
56
-
APIService 的最常见实现方式是在集群中某 Pod 内运行 *扩展 API 服务器*。
54
+
APIService 的最常见实现方式是在集群中某 Pod 内运行 **扩展 API 服务器**。
57
55
如果你在使用扩展 API 服务器来管理集群中的资源,该扩展 API 服务器(也被写成“extension-apiserver”)
@@ -67,7 +64,7 @@ Discovery requests are required to round-trip from the kube-apiserver in five se
67
64
68
65
If your extension API server cannot achieve that latency requirement, consider making changes that let you meet it.
69
66
-->
70
-
### 反应延迟 {#response-latency}
67
+
### 响应延迟 {#response-latency}
71
68
72
69
扩展 API 服务器与 kube-apiserver 之间需要存在低延迟的网络连接。
73
70
发现请求需要在五秒钟或更短的时间内完成到 kube-apiserver 的往返。
@@ -77,8 +74,8 @@ If your extension API server cannot achieve that latency requirement, consider m
77
74
## {{% heading "whatsnext" %}}
78
75
79
76
<!--
80
-
* To get the aggregator working in your environment, [configure the aggregation layer](/docs/tasks/access-kubernetes-api/configure-aggregation-layer/).
81
-
* Then, [setup an extension api-server](/docs/tasks/access-kubernetes-api/setup-extension-api-server/) to work with the aggregation layer.
77
+
* To get the aggregator working in your environment, [configure the aggregation layer](/docs/tasks/extend-kubernetes/configure-aggregation-layer/).
78
+
* Then, [setup an extension api-server](/docs/tasks/extend-kubernetes/setup-extension-api-server/) to work with the aggregation layer.
82
79
* Read about [APIService](/docs/reference/kubernetes-api/cluster-resources/api-service-v1/) in the API reference
83
80
84
81
Alternatively: learn how to [extend the Kubernetes API using Custom Resource Definitions](/docs/tasks/extend-kubernetes/custom-resources/custom-resource-definitions/).
@@ -87,6 +84,6 @@ Alternatively: learn how to [extend the Kubernetes API using Custom Resource Def
87
84
了解如何在自己的环境中启用聚合器。
88
85
* 接下来,了解[安装扩展 API 服务器](/zh-cn/docs/tasks/extend-kubernetes/setup-extension-api-server/),
89
86
开始使用聚合层。
90
-
* 从 API 参考资料中研究关于 [APIService](/docs/reference/kubernetes-api/cluster-resources/api-service-v1/) 的内容。
87
+
* 从 API 参考资料中研究关于 [APIService](/zh-cn/docs/reference/kubernetes-api/cluster-resources/api-service-v1/) 的内容。
0 commit comments