kubebuilder以下简称kb,是k8s社区编写CRD的工具。它可以自动化生成CRD工程代码,提高编写operator的效率。官网的示例CronJob对于初学者来说太复杂了,我试了下,基本的代码可以运行起来。
应该是sdk-operator比较先出现,kubebuilder是后来者。极客时间上学习k8s时,张磊还没有提及kubebuilder。两者没有什么本质区别,不过看知乎中的说法,两者社区有融合的趋势。新手还是学习kubebuilder比较好。
https://www.zhihu.com/question/290497164
除了官网的kubebuilder,还有其他的工具controller-gen, kustomize需要安装,官网的文档里没有说安装方法。
按照官网文档的命令,安装比较简单。https://book.kubebuilder.io/quick-start.html
安装完成,通过如下命令确认安装成功。
$ kubebuilder version <<<
Version: main.version{KubeBuilderVersion:"3.1.0", KubernetesVendor:"unknown", GitCommit:"92e0349ca7334a0a8e5e499da4fb077eb524e94a", BuildDate:"2021-05-29T05:57:53+01:00", GoOs:"darwin", GoArch:"amd64"}
一定要使用比较新的kubbuilder版本。
controller-gen是用来生成控制器代码的工具。
可以去github仓库中找到安装方法。go get + go install即可安装。mac下面可以直接使用brew install controller-gen
安装。
kustomize是用来生成CRD定义的工具。安装方法参考controller-gen。
基本的工具安装完成后,还需要一个k8s集群,1.16+的。并且本地配置好有kubectl。
执行如下命令。
mkdir -pv hello
go mod init example.com/hello
执行如下命令。
kubebuilder init --domain example.com --license apache2 --owner "lin lin"
完成后,会生成Makefile和main.go等工程框架。
创建一个API。
kubebuilder create api --group me --version v1 --kind Case
$ kubebuilder create api --group me --version v1 --kind Case
Create Resource [y/n]
y
Create Controller [y/n]
y
有两个交互提示,都选y。
执行过程中有报错,提示一个go的依赖未找到,可以通过手动go get方式拉取。
至此工程已经初始化完成了。
执行make install
,即可自动把CRD安装到k8s集群中。通过kubectl get crd
确认安装结果。
创建如下的定义。符合定义的API GVK要素。在招待make run ENABLE_WEBHOOKS=false
之后,
执行kubectl apply -f case.yaml,创建资源,可以在终端上看到operator的Reconcil循环中有监测到资源的变动。
apiVersion: me.example.com/v1
kind: Case
metadata:
name: hello
spec:
foo: "world"
2021-08-04T20:37:37.617+0800 INFO controller-runtime.metrics metrics server is starting to listen {"addr": ":8080"}
2021-08-04T20:37:37.617+0800 INFO setup starting manager
2021-08-04T20:37:37.618+0800 INFO controller-runtime.manager starting metrics server {"path": "/metrics"}
2021-08-04T20:37:37.619+0800 INFO controller-runtime.controller Starting EventSource {"controller": "case", "source": "kind source: /, Kind="}
2021-08-04T20:37:37.719+0800 INFO controller-runtime.controller Starting Controller {"controller": "case"}
2021-08-04T20:37:37.719+0800 INFO controller-runtime.controller Starting workers {"controller": "case", "worker count": 1}
2021-08-04T20:37:37.976+0800 DEBUG controller-runtime.controller Successfully Reconciled {"controller": "case", "request": "default/hello"}
2021-08-04T20:37:48.188+0800 DEBUG controller-runtime.controller Successfully Reconciled {"controller": "case", "request": "default/hello"}
至此整个示例完成了。由于没有编写任何代码,所以Reconcil中只能看到有事件,具体是添加还是删除,还是扩容都还不知道。这是下一步的工作。下一步就是扩展api/v1的CR的完整定义,并在Reconcil循环中进行真正的业务逻辑了。