From 1cbaddef4a24dbdbe03119228650d150fc249c80 Mon Sep 17 00:00:00 2001 From: AdamDang Date: Mon, 19 Nov 2018 23:15:32 +0800 Subject: [PATCH 1/3] zh-trans: add apiserver-aggregation.md zh-trans: add apiserver-aggregation.md --- .../api-extension/apiserver-aggregation.md | 73 +++++++++++++++++++ 1 file changed, 73 insertions(+) create mode 100644 content/zh/docs/concepts/extend-kubernetes/api-extension/apiserver-aggregation.md diff --git a/content/zh/docs/concepts/extend-kubernetes/api-extension/apiserver-aggregation.md b/content/zh/docs/concepts/extend-kubernetes/api-extension/apiserver-aggregation.md new file mode 100644 index 0000000000..3da87e4af4 --- /dev/null +++ b/content/zh/docs/concepts/extend-kubernetes/api-extension/apiserver-aggregation.md @@ -0,0 +1,73 @@ + + +--- +title: 通过聚合层扩展 Kubernetes API +reviewers: +- lavalamp +- cheftako +- chenopis +content_template: templates/concept +weight: 10 +--- + +{{% capture overview %}} + + + +聚合层允许 Kubernetes 通过额外的 API 进行扩展，而不局限于 Kubernetes 核心 API 提供的功能。 + +{{% /capture %}} + +{{% capture body %}} + + + +## 概述 + +聚合层使你的集群可以安装其他 Kubernetes 风格的 API。这些 API 可以是预编译的、第三方的解决方案提供的例如[service-catalog](https://github.com/kubernetes-incubator/service-catalog/blob/master/README.md)、或者用户创建的类似[apiserver-builder](https://github.com/kubernetes-incubator/apiserver-builder/blob/master/README.md)一样的可以让你开始的 API。 + + + +1.7 版本中，聚合层在 kube-apiserver 进程内运行。在扩展资源注册之前，聚合层不做任何事情。要注册 API，用户必须添加一个 APIService 对象，它来声明 Kubernetes API 中的 URL 路径。在那种情况下，聚合层将会把发给该 API 路径的所有内容（例如 /apis/myextension.mycompany.io/v1/…）代理到已注册的 APIService。 + + + +正常情况下，集群上运行的 Pod 的 *extension-apiserver* 将会执行 APIService。如果需要对增加的资源进行动态管理，extension-apiserver 经常需要和一个或多个控制器一起使用。做为结果，apiserver-builder 将会为双方提供框架。另外一个例子，当安装了 service-catalog 时，它会为自己提供的服务提供 extension-apiserver 和控制器。 + +{{% /capture %}} + +{{% capture whatsnext %}} + + + +* 在你的环境中使用聚合器 [配置聚合层](/docs/tasks/access-kubernetes-api/configure-aggregation-layer/)。 +* 然后[安装扩展的 api-server](/docs/tasks/access-kubernetes-api/setup-extension-api-server/) 来开始使用聚合层。 +* 也可以学习怎样 [使用客户资源定义扩展 Kubernetes API](/docs/tasks/access-kubernetes-api/extend-api-custom-resource-definitions/)。 + +{{% /capture %}} + + From 399c842a61a194b21cdbc5af3576d26be72b39e0 Mon Sep 17 00:00:00 2001 From: AdamDang Date: Tue, 20 Nov 2018 13:19:41 +0800 Subject: [PATCH 2/3] Fixes due to review Fixes due to review --- .../api-extension/apiserver-aggregation.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/content/zh/docs/concepts/extend-kubernetes/api-extension/apiserver-aggregation.md b/content/zh/docs/concepts/extend-kubernetes/api-extension/apiserver-aggregation.md index 3da87e4af4..23dc5757cc 100644 --- a/content/zh/docs/concepts/extend-kubernetes/api-extension/apiserver-aggregation.md +++ b/content/zh/docs/concepts/extend-kubernetes/api-extension/apiserver-aggregation.md @@ -40,19 +40,19 @@ The aggregation layer enables installing additional Kubernetes-style APIs in you ## 概述 -聚合层使你的集群可以安装其他 Kubernetes 风格的 API。这些 API 可以是预编译的、第三方的解决方案提供的例如[service-catalog](https://github.com/kubernetes-incubator/service-catalog/blob/master/README.md)、或者用户创建的类似[apiserver-builder](https://github.com/kubernetes-incubator/apiserver-builder/blob/master/README.md)一样的可以让你开始的 API。 +聚合层使您的集群可以安装其他 Kubernetes 风格的 API。这些 API 可以是预编译的、第三方的解决方案提供的例如[service-catalog](https://github.com/kubernetes-incubator/service-catalog/blob/master/README.md)、或者用户创建的类似[apiserver-builder](https://github.com/kubernetes-incubator/apiserver-builder/blob/master/README.md)一样的API可以帮助你上手。 -1.7 版本中，聚合层在 kube-apiserver 进程内运行。在扩展资源注册之前，聚合层不做任何事情。要注册 API，用户必须添加一个 APIService 对象，它来声明 Kubernetes API 中的 URL 路径。在那种情况下，聚合层将会把发给该 API 路径的所有内容（例如 /apis/myextension.mycompany.io/v1/…）代理到已注册的 APIService。 +1.7 版本中，聚合层在 kube-apiserver 进程内运行。在扩展资源注册之前，聚合层不做任何事情。要注册 API，用户必须添加一个 APIService 对象，它来申领 Kubernetes API 中的 URL 路径。自此以后，聚合层将会把发给该 API 路径的所有内容（例如 /apis/myextension.mycompany.io/v1/…）代理到已注册的 APIService。 -正常情况下，集群上运行的 Pod 的 *extension-apiserver* 将会执行 APIService。如果需要对增加的资源进行动态管理，extension-apiserver 经常需要和一个或多个控制器一起使用。做为结果，apiserver-builder 将会为双方提供框架。另外一个例子，当安装了 service-catalog 时，它会为自己提供的服务提供 extension-apiserver 和控制器。 +正常情况下，APIService 会实现为运行于集群中某 Pod 内的 extension-apiserver。如果需要对增加的资源进行动态管理，extension-apiserver 经常需要和一个或多个控制器一起使用。因此，apiserver-builder 同时提供用来管理新资源的 API 框架和控制器框架。另外一个例子，当安装了 service-catalog 时，它会为自己提供的服务提供 extension-apiserver 和控制器。 {{% /capture %}} @@ -64,7 +64,7 @@ Ordinarily, the APIService will be implemented by an *extension-apiserver* in a * Also, learn how to [extend the Kubernetes API using Custom Resource Definitions](/docs/tasks/access-kubernetes-api/extend-api-custom-resource-definitions/). --> -* 在你的环境中使用聚合器 [配置聚合层](/docs/tasks/access-kubernetes-api/configure-aggregation-layer/)。 +* 阅读[配置聚合层](/docs/tasks/access-kubernetes-api/configure-aggregation-layer/) 文档，了解如何在自己的环境中启用聚合器（aggregator）。 * 然后[安装扩展的 api-server](/docs/tasks/access-kubernetes-api/setup-extension-api-server/) 来开始使用聚合层。 * 也可以学习怎样 [使用客户资源定义扩展 Kubernetes API](/docs/tasks/access-kubernetes-api/extend-api-custom-resource-definitions/)。 From 158f5276d89816b6d78a45f7fcf97456540a90aa Mon Sep 17 00:00:00 2001 From: Qiming Date: Tue, 20 Nov 2018 13:31:15 +0800 Subject: [PATCH 3/3] Update apiserver-aggregation.md --- .../extend-kubernetes/api-extension/apiserver-aggregation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/zh/docs/concepts/extend-kubernetes/api-extension/apiserver-aggregation.md b/content/zh/docs/concepts/extend-kubernetes/api-extension/apiserver-aggregation.md index 23dc5757cc..11dc1e423a 100644 --- a/content/zh/docs/concepts/extend-kubernetes/api-extension/apiserver-aggregation.md +++ b/content/zh/docs/concepts/extend-kubernetes/api-extension/apiserver-aggregation.md @@ -46,7 +46,7 @@ The aggregation layer enables installing additional Kubernetes-style APIs in you In 1.7 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. --> -1.7 版本中，聚合层在 kube-apiserver 进程内运行。在扩展资源注册之前，聚合层不做任何事情。要注册 API，用户必须添加一个 APIService 对象，它来申领 Kubernetes API 中的 URL 路径。自此以后，聚合层将会把发给该 API 路径的所有内容（例如 /apis/myextension.mycompany.io/v1/…）代理到已注册的 APIService。 +1.7 版本中，聚合层在 kube-apiserver 进程内运行。在扩展资源注册之前，聚合层不做任何事情。要注册 API，用户必须添加一个 APIService 对象，用它来申领 Kubernetes API 中的 URL 路径。自此以后，聚合层将会把发给该 API 路径的所有内容（例如 /apis/myextension.mycompany.io/v1/…）代理到已注册的 APIService。