Kubernetes API 开发（四）
生成代码
除了 default-gen, deepcopy-gen, conversion-gen, 和 openapi-gen 外，还有其他的生成器：
go-to-protobufclient-genlister-geninformer-gencodecgen(使用 ugorji codec快速串行化json)
大部分生成器基于 gengo ，拥有相同的命令行选项。 --verify-only 会检查磁盘上的将要生成的文件。
生成器生成代码时有个 --go-header-file 选项，该选项指定包含生成代码头部内容的文件。头部内容一般是版权信息，放在生成代码的最前面，并且会被稍后的 repo-infra/verify/verify-boilerplane.sh 脚本检查。
执行 make update 会调用一系列脚本 包括以上的生成器。请继续阅读以下段落，因为某些生成器的使用需要一些先决条件，而且执行 make update 耗时太久，下面还会介绍如何单独调用生成器。
Generate protobuf objects
对于任意 core API object ，我们需要生成 Protobuf IDL 和 marshallers。通过调用以下脚本生成：
| |
大部分 object 对于转换成 protobuf 不需要太多的考虑，但是我们需要注意哪些依赖 golang 标准库类型的的 object，可能需要提供一些额外的工作，实践上我们一般使用自定义的 JONST 串行化。pkg/api/serialization_test.go 会测试你的 protobuf 串行化，多运行几次确保没有非兼容的字段。
Generate Clientset
client-gen 是为顶层 API object 生成 clientsets 的工具。
client-gen 要求每个想要导出的类型前添加 // +genclient 注释，包括 internal type pkg/apis/<group>/types.go 和 versioned type staging/src/k8s.io/api/<group>/<version>/types.go 。
如果 apiserver 注册的 API group 名字和文件系统中存储的 group 路径不相同（一般在文件系统中存储会删除 k8s.io 后缀，例如 admission vs admission.k8s.io），你可以在向 client-gen 指定正确的 group name，通过在 doc.go 添加 // +groupName= 注释，当然 internal version pkg/apis/<group>/doc.go 和 versioned API staging/src/k8s.io/api/<group>/<version>/types.go 都要添加。
添加 groupName 注释后，执行以下命令生成 client：
| |
你可以使用可选选项 // +groupGoName= 使用 Golang 驼峰标识符来为 group 指定别名, 解决冲突。例如 policy.authorization.k8s.io 和 policy.k8s.io。 这两个 group 默认都映射到 Policy() 这个名字的 client 中，这个时候就需要执行 groupGoName 来帮助区分这两个 client group 名。
| |
第一个用来定义 RESTfully 接口的资源，第二个用来定义生成的 Golang 代码中的名字，例如在 clientset 中访问该 group verion：
| |
clent-gen 可配置性很强，如果你要为非 kubernets API 生成代码，可以看这篇文档
Generate Listers
lister-gen 为 client 生成 lister。 这个复用 // +genclient 和 // +groupName= 注释，所有你不用指定额外的注释。
运行 hack/update-codegen.sh 脚本的时候会调用 lister-gen。
Generate Informers
informer-gen 生成有用的 informers，用于监控 API 资源的变化. 这个复用 // +genclient 和 // +groupName= 注释，所有你不用指定额外的注释。
运行 hack/update-codegen.sh 脚本的时候会调用 informer-gen。
Edit json (un)marshaling code
我们只用自动生成的代码来为 API object 进行 marshalling 和 unmarshalling 操作 —— 这比 reflect 提高了系统性能。
自动生成的代码放在每个 versioned API 中：
staging/src/k8s.io/api/<group>/<version>/generated.protostaging/src/k8s.io/api/<group>/<version>/generated.pb.go
运行一下脚本重新生成：
| |