GITBOOK-124: No subject

Author: mouuii

Diff for: SUMMARY.md

@@ -50,6 +50,7 @@
   * [5.8 event](k8s-yuan-ma-ren-cai-fu-hua-xun-lian-ying/di-wu-zhang-apimachinery/5.8-event.md)
   * [5.10 多版本和序列化](k8s-yuan-ma-ren-cai-fu-hua-xun-lian-ying/di-wu-zhang-apimachinery/5.10-duo-ban-ben-he-xu-lie-hua.md)
   * [5.11 Kubernetes API Scheme 解析](k8s-yuan-ma-ren-cai-fu-hua-xun-lian-ying/di-wu-zhang-apimachinery/5.11-kubernetes-api-scheme-jie-xi.md)
+  * [5.12 k8s api-changes](k8s-yuan-ma-ren-cai-fu-hua-xun-lian-ying/di-wu-zhang-apimachinery/5.12-k8s-api-changes.md)
 * [认证授权](k8s-yuan-ma-ren-cai-fu-hua-xun-lian-ying/ren-zheng-shou-quan/README.md)
   * [01-认证](k8s-yuan-ma-ren-cai-fu-hua-xun-lian-ying/ren-zheng-shou-quan/01-ren-zheng.md)
 

Diff for: k8s-yuan-ma-ren-cai-fu-hua-xun-lian-ying/di-wu-zhang-apimachinery/5.12-k8s-api-changes.md

@@ -0,0 +1,40 @@
+# 5.12 k8s api-changes
+
+## So you want to change the API?
+
+在尝试更改 API 之前，您应该熟悉一些现有的 API 类型和[API 约定](https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md)。如果创建新的 API 类型/资源，我们还建议您首先发送仅包含新 API 类型提案的 PR。
+
+Kubernetes API 有两个主要组件 - 内部结构和版本化 API。版本化 API 的目的是稳定，而内部结构的实现是为了最好地反映 Kubernetes 代码本身的需求。
+
+对于 API 更改来说，这意味着您必须在处理更改的方式上深思熟虑，并且必须接触多个部分才能做出完整的更改。本文档旨在指导您完成整个过程，但并非所有 API 更改都需要所有这些步骤。
+
+## Operational overview
+
+为了浏览本文档的其余部分，对 Kubernetes 中使用的 API 系统有一个深入的了解非常重要。
+
+如上所述，API 对象的内部表示与任何一个 API 版本是解耦的。这提供了很大的自由来发展代码，但它需要强大的基础设施来在表示之间进行转换。处理 API 操作有多个步骤 - 即使像 GET 这样简单的操作也涉及大量的机制。
+
+这个转换过程在逻辑上是一个以内部形式为中心的“星”。每个版本化 API 都可以转换为内部形式（反之亦然），但版本化 API 不会直接转换为其他版本化 API。这听起来像是一个繁重的过程，但实际上我们并不打算同时保留少量版本。虽然所有 Kubernetes 代码都在内部结构上运行，但它们在写入存储（磁盘或 etcd）或通过线路发送之前始终会转换为版本化形式。客户端应专门使用和操作版本化 API。
+
+为了演示一般过程，这里有一个（假设的）示例：
+
+1. 用户将`Pod`对象发布到`/api/v7beta1/...`
+2. JSON 被解组为`v7beta1.Pod`结构
+3. 默认值应用于`v7beta1.Pod`
+4. `v7beta1.Pod`转换为`api.Pod`结构
+5. `api.Pod`已验证，任何错误都会返回给用户
+6. `api.Pod`转换为`v6.Pod` （因为 v6 是最新的稳定版本）
+7. `v6.Pod`被编组为 JSON 并写入 etcd
+
+现在我们已经存储了`Pod`对象，用户可以在任何受支持的 api 版本中获取该对象。例如：
+
+1. 用户从`/api/v5/...`获取`Pod`
+2. JSON 从 etcd 读取并解组为`v6.Pod`结构
+3. 默认值应用于`v6.Pod`
+4. `v6.Pod`转换为`api.Pod`结构
+5. `api.Pod`转换为`v5.Pod`结构
+6. `v5.Pod`被编组为 JSON 并发送给用户
+
+此过程的含义是 API 更改必须谨慎且向后兼容。
+
+### On compatibility