zh-trans: add apiserver-aggregation.md

2018-11-19 23:15:32 +08:00
parent 2f5f90a093
commit 1cbaddef4a
1 changed files with 73 additions and 0 deletions
@@ -0,0 +1,73 @@
+<!--
+---
+title: Extending the Kubernetes API with the aggregation layer
+reviewers:
+- lavalamp
+- cheftako
+- chenopis
+content_template: templates/concept
+weight: 10
+---
+-->
+
+---
+title: 通过聚合层扩展 Kubernetes API
+reviewers:
+- lavalamp
+- cheftako
+- chenopis
+content_template: templates/concept
+weight: 10
+---
+
+{{% capture overview %}}
+
+<!--
+The aggregation layer allows Kubernetes to be extended with additional APIs, beyond what is offered by the core Kubernetes APIs. 
+-->
+
+聚合层允许 Kubernetes 通过额外的 API 进行扩展，而不局限于 Kubernetes 核心 API 提供的功能。
+
+{{% /capture %}}
+
+{{% capture body %}}
+
+<!--
+## Overview
+
+The aggregation layer enables installing additional Kubernetes-style APIs in your cluster. These can either be pre-built, existing 3rd party solutions, such as [service-catalog](https://github.com/kubernetes-incubator/service-catalog/blob/master/README.md), or user-created APIs like [apiserver-builder](https://github.com/kubernetes-incubator/apiserver-builder/blob/master/README.md), which can get you started.
+-->
+
+## 概述
+
+聚合层使你的集群可以安装其他 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。
+
+<!--
+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。
+
+<!--
+Ordinarily, the APIService will be implemented by an *extension-apiserver* in a pod running in the cluster. This extension-apiserver will normally need to be paired with one or more controllers if active management of the added resources is needed. As a result, the apiserver-builder will actually provide a skeleton for both. As another example, when the service-catalog is installed, it provides both the extension-apiserver and controller for the services it provides.
+-->
+
+正常情况下，集群上运行的 Pod 的 *extension-apiserver* 将会执行 APIService。如果需要对增加的资源进行动态管理，extension-apiserver 经常需要和一个或多个控制器一起使用。做为结果，apiserver-builder 将会为双方提供框架。另外一个例子，当安装了 service-catalog 时，它会为自己提供的服务提供 extension-apiserver 和控制器。
+
+{{% /capture %}}
+
+{{% capture whatsnext %}}
+
+<!--
+* To get the aggregator working in your environment, [configure the aggregation layer](/docs/tasks/access-kubernetes-api/configure-aggregation-layer/).
+* Then, [setup an extension api-server](/docs/tasks/access-kubernetes-api/setup-extension-api-server/) to work with the aggregation layer.
+* 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/)。
+* 然后[安装扩展的 api-server](/docs/tasks/access-kubernetes-api/setup-extension-api-server/) 来开始使用聚合层。
+* 也可以学习怎样 [使用客户资源定义扩展 Kubernetes API](/docs/tasks/access-kubernetes-api/extend-api-custom-resource-definitions/)。
+
+{{% /capture %}}
+
+