advance developer guide

pull/136/head
rootsongjc 2018-02-11 09:57:48 +08:00
parent 1f008494e9
commit 0b3930bf12
2 changed files with 101 additions and 0 deletions

View File

@ -188,6 +188,7 @@
- [单元测试和集成测试](develop/testing.md)
- [client-go示例](develop/client-go-sample.md)
- [Operator](develop/operator.md)
- [高级开发指南](develop/advance-developer.md)
- [社区贡献](develop/contribute.md)
- [Minikube](develop/minikube.md)

View File

@ -0,0 +1,100 @@
# 高级开发指南
本页假定您已经熟悉 Kubernetes 的核心概念并可以轻松的部署自己的应用程序。如果还不能,您需要先查看下[中级应用开发者](/docs/user-journeys/users/application-developer/intermediate/)主题。
在浏览了本页面及其链接的内容后,您将会更好的理解如下部分:
- 可以在应用程序中使用的高级功能
- 扩展 Kubernetes API 的各种方法
## 使用高级功能部署应用
现在您知道了 Kubernetes 中提供的一组 API 对象。理解了 daemonset 和 deployment 之间的区别对于应用程序部署通常是足够的。也就是说,熟悉 Kubernetes 中其它的鲜为人知的功能也是值得的。因为这些功能有时候对于特别的用例是非常强大的。
#### 容器级功能
如您所知,将整个应用程序(例如容器化的 Rails 应用程序MySQL 数据库以及所有应用程序)迁移到单个 Pod 中是一种反模式。这就是说,有一些非常有用的模式超出了容器和 Pod 之间的 1:1 的对应关系:
- **Sidecar 容器**:虽然 Pod 中依然需要有一个主容器,你还可以添加一个副容器作为辅助(见 [日志示例](/docs/concepts/cluster-administration/logging/#using-a-sidecar-container-with-the-logging-agent))。*单个 Pod 中的两个容器可以[通过共享卷](/docs/tasks/access-application-cluster/communicate-containers-same-pod-shared-volume/)进行通信*。
- **Init 容器***Init 容器*在 Pod 的应用容器(如主容器和 sidecar 容器)之前运行。[阅读更多](/docs/concepts/workloads/pods/init-containers/),查看 [nginx 服务器示例](/docs/tasks/configure-pod-container/configure-pod-initialization/),并[学习如何调试这些容器](/docs/tasks/debug-application-cluster/debug-init-containers/)。
#### Pod 配置
通常,您可以使用 label 和 annotation 将元数据附加到资源上。将数据注入到资源,您可以会创建 ConfigMap用于非机密数据或 Secret用于机密数据
下面是一些其他不太为人所知的配置资源 Pod 的方法:
- Taint污点和 Toleration容忍这些为节点“吸引”或“排斥” Pod 提供了一种方法。当需要将应用程序部署到特定硬件(例如用于科学计算的 GPU经常使用它们。[阅读更多](/docs/concepts/configuration/taint-and-toleration/)。
- **向下 API**:这允许您的容器使用有关自己或集群的信息,而不会过度耦合到 Kubernetes API server。这可以通过[环境变量](/docs/tasks/inject-data-application/environment-variable-expose-pod-information/) 或者 [DownwardAPIVolumeFiles](/docs/tasks/inject-data-application/downward-api-volume-expose-pod-information/)。
- **Pod 预设**通常要将运行时需求例如环境变量、ConfigMap 和 Secret安装到资源中可以在资源的配置文件中指定它们。*[PodPresets](/docs/concepts/workloads/pods/podpreset/)允许您在创建资源时动态注入这些需求。例如,这允许团队 A 将任意数量的新Secret 安装到团队 B 和 C 创建的资源中,而不需要 B 和 C 的操作。[请参阅示例](/docs/tasks/inject-data-application/podpreset/)*。
#### 其他 API 对象
在设置以下资源之前,请检查这是否属于您组织的集群管理员的责任。
- **Horizontal Pod Autoscaler (HPA)** 这些资源是在CPU使用率或其他[自定义度量](https://github.com/kubernetes/community/blob/master/contributors/design-proposals/instrumentation/custom-metrics-api.md)标准“秒杀”时自动化扩展应用程序的好方法。*[查看示例](/docs/tasks/run-application/horizontal-pod-autoscale-walkthrough/)*以了解如何设置HPA。
- **联合集群对象**:如果使用 *federation* 在多个 Kubernetes 集群上运行应用程序,则需要部署标准 Kubernetes API 对象的联合版本。有关参考,请查看设置 [联合 ConfigMap](/docs/tasks/administer-federation/configmap/) 和[联合 Deployment](/docs/tasks/administer-federation/deployment/) 的指南。
## 扩展 Kubernetes API
Kubernetes 在设计之初就考虑到了可扩展性。如果上面提到的 API 资源和功能不足以满足您的需求,则可以自定义其行为,而无需修改核心 Kubernetes 代码。
#### 理解 Kubernetes 的默认行为
在进行任何自定义之前,了解 Kubernetes API 对象背后的一般抽象很重要。虽然 Deployment 和 Secret 看起来可能完全不同,但对于*任何*对象来说,以下概念都是正确的:
- **Kubernetes对象是存储有关您的集群的结构化数据的一种方式。**
在 Deployment 的情况下,该数据代表期望的状态(例如“应该运行多少副本?”),但也可以是通用的元数据(例如数据库凭证)。
- **Kubernetes 对象通过 Kubernetes API** 修改。
换句话说,您可以对特定的资源路径(例如 `<api-server-url>/api/v1/namespaces/default/deployments` )执行 `GET``POST` 请求来读取或修改对应的对象类型。
- **利用 [Controller 模式](/docs/concepts/api-extension/custom-resources/#custom-controllers)Kubernetes 对象可被确保达到期望的状态**。为了简单起见,您可以将 Controller 模式看作以下连续循环:
1. 检查当前状态(副本数、容器镜像等)
2. 对比当前状态和期望状态
3. 如果不匹配则更新当前状态
这些状态是通过 Kubernetes API 来获取的。
并非所有的 Kubernetes 对象都需要一个 Controller。尽管 Deployment 触发群集进行状态更改,但 ConfigMaps 纯粹作为存储。
#### 创建自定义资源
基于上述想法,您可以定义与 Deployment 一样合法的[自定义资源](/docs/concepts/api-extension/custom-resources/#custom-resources)。例如,如果 `CronJobs` 不能提供所有您需要的功能,您可能需要定义 `Backup` 对象以进行定期备份。
创建自定义资源有以下两种方式:
1. **自定义资源定义CRD**:这种实现方式的工作量最小。参考[示例](/docs/tasks/access-kubernetes-api/extend-api-custom-resource-definitions/)。
2. **API 聚合**:在实际设置单独的[扩展 API server](/docs/tasks/access-kubernetes-api/setup-extension-api-server/) 之前,此方法需要一些[预配置](/docs/tasks/access-kubernetes-api/configure-aggregation-layer/)
请注意,与依赖内置的 [`kube-controller-manager`](/docs/reference/generated/kube-controller-manager/) 不同,您需要编写并运行[自定义控制器](https://github.com/kubernetes/sample-controller)。
下面是一些有用的链接:
- [如何才知道自定义资源是否符合您的使用场景](/docs/concepts/api-extension/custom-resources/#should-i-use-a-configmap-or-a-custom-resource)
- [CRD 还是 API 聚合,如何选择?](/docs/concepts/api-extension/custom-resources/#choosing-a-method-for-adding-custom-resources)
#### Service Catalog
如果您想要使用或提供完整的服务(而不是单个资源),**Service Catalog** 为此提供了一个[规范](https://github.com/openservicebrokerapi/servicebroker)。这些服务使用 Service Broker注册请参阅 [示例](https://github.com/openservicebrokerapi/servicebroker/blob/master/gettingStarted.md#example-service-brokers))。
如果您没有集群管理员来管理 Service Catalog 的安装,您可以使用 [Helm](/docs/tasks/service-catalog/install-service-catalog-using-helm/) 或 [二进制安装器](/docs/tasks/service-catalog/install-service-catalog-using-sc/)。
## 探索其他资源
#### 参考
以下主题对构建更复杂的应用程序也很有用:
- [Kubernetes 中的其他扩展点](/docs/concepts/overview/extending/) - 在哪里可以挂勾到 Kubernetes 架构的概念性的概述
- [Kubernetes 客户端库](/docs/reference/client-libraries/) - 用于构建需要与 Kubernetes API 大量交互的应用程序。
#### 下一步
恭喜您完成了应用开发者之旅!您已经了解了 Kubernetes 提供的大部分功能。现在怎么办?
- 如果您想推荐新功能或跟上Kubernetes应用开发的最新进展请考虑加入 SIG如 [SIG Apps](https://github.com/kubernetes/community/tree/master/sig-apps)。
- 如果您有兴趣详细了解 Kubernetes 的内部运作(例如网络),请考虑查看[集群运维之旅](/docs/user-journeys/users/cluster-operator/foundational/)。