1
2
3
4

apiVersion: apps/v1 # 这个是 GV，G 是 apps，V 是 v1
kind: Deployment    # 这个就是 Kind
sepc:               # 加上下放的 spec 就是 Resource了
  ...

1

kubebuilder init --domain lailin.xyz --repo github.com/mohuishou/blog-code/k8s-operator/02-kubebuilder

1

2021/04/25 20:47:14 failed to initialize project: unable to run pre-scaffold tasks of "base.go.kubebuilder.io/v3": go version 'go1.16' is incompatible because 'requires 1.13 <= version < 1.16'. You can skip this check using the --skip-go-version-check flag

1

kubebuilder init --domain lailin.xyz --repo github.com/mohuishou/blog-code/k8s-operator/02-kubebuilder --skip-go-version-check

1
2
3
4
5
6
7
8
9
10
11
12
13
14

.
├── Dockerfile
├── Makefile # 这里定义了很多脚本命令，例如运行测试，开始执行等
├── PROJECT  # 这里是 kubebuilder 的一些元数据信息
├── config
│   ├── default    # 一些默认配置
│   ├── manager    # 部署 crd 所需的 yaml
│   ├── prometheus # 监控指标数据采集配置
│   └── rbac # 部署所需的 rbac 授权 yaml
├── go.mod
├── go.sum
├── hack
│   └── boilerplate.go.txt
└── main.go

1

kubebuilder create api --group apps --version v1 --kind Application

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

.
├── api
│   └── v1
│       ├── application_types.go # 这里是定义 spec 的地方
│       ├── groupversion_info.go # GV 的定义，一般无需修改
│       └── zz_generated.deepcopy.go
├── config
│   ├── crd # 自动生成的 crd 文件，不用修改这里，只需要修改了 v1 中的 go 文件之后执行 make generate 即可
│   ├── default
│   ├── manager
│   ├── prometheus
│   ├── rbac
│   └── samples # 这里是 crd 示例文件，可以用来部署到集群当中
├── controllers
│   ├── application_controller.go # 在这里实现 controller 的逻辑
│   └── suite_test.go # 这里写测试

1
2
3
4
5
6
7
8
9
10
11

// api/v1/application_types.go
// ApplicationSpec defines the desired state of Application
type ApplicationSpec struct {
	// INSERT ADDITIONAL SPEC FIELDS - desired state of cluster
	// Important: Run "make" to regenerate code after modifying this file
	// Product 该应用所属的产品
	Product string `json:"product,omitempty"`
}

1
2
3
4
5
6
7

# config/crd/bases/apps.lailin.xyz_applications.yaml
......
			properties:
              product:
                description: Product 该应用所属的产品
                type: string
......

1
2
3
4
5
6
7
8
9

// controllers/application_controller.go
func (r *ApplicationReconciler) Reconcile(ctx context.Context, req ctrl.Request) (ctrl.Result, error) {
	_ = r.Log.WithValues("application", req.NamespacedName)
	r.Log.Info("app changed", "ns", req.Namespace)
	return ctrl.Result{}, nil
}

1
2
3
4
5
6
7

go run ./main.go
2021-04-25T21:55:55.578+0800    INFO    controller-runtime.metrics     metrics server is starting to listen     {"addr": ":8080"}
2021-04-25T21:55:55.579+0800    INFO    setup   starting manager
2021-04-25T21:55:55.579+0800    INFO    controller-runtime.manager     starting metrics server  {"path": "/metrics"}
2021-04-25T21:55:55.579+0800    INFO    controller-runtime.manager.controller.application       Starting EventSource    {"reconciler group": "apps.lailin.xyz", "reconciler kind": "Application", "source": "kind source: /, Kind="}
2021-04-25T21:55:55.680+0800    INFO    controller-runtime.manager.controller.application       Starting Controller     {"reconciler group": "apps.lailin.xyz", "reconciler kind": "Application"}
2021-04-25T21:55:55.680+0800    INFO    controller-runtime.manager.controller.application       Starting workers        {"reconciler group": "apps.lailin.xyz", "reconciler kind": "Application", "worker count": 1}

1
2
3
4
5
6
7

apiVersion: apps.lailin.xyz/v1
kind: Application
metadata:
  name: application-sample
spec:
  # Add fields here
  product: test

1

2021-04-25T21:57:12.618+0800    INFO    controllers.Application app changed     {"ns": "default"}