kubebuilder-playground

Playground that develops custom resource definition of k8s with kubebuilder.

Commands

Install CRD

Install k8s CRD by using kustomize.

$ make install
${GOPATH}/bin//controller-gen "crd:trivialVersions=true" rbac:roleName=manager-role webhook paths="./..." output:crd:artifacts:config=config/crd/bases
kustomize build config/crd | kubectl apply -f -
customresourcedefinition.apiextensions.k8s.io/guestbooks.webapp.kubebuilder.kamiazya.tech created

Create project

kubebuilder init --domain  kubebuilder.kamiazya.tech

Create API

kubebuilder create api --group webapp --version v1 --kind Guestbook

Apply Sample Resource

# apply
$ kubectl apply -f config/samples/webapp_v1_guestbook.yaml
guestbook.webapp.kubebuilder.kamiazya.tech/guestbook-sample created

Start Development

$ make run
${GOPATH}/bin/controller-gen object:headerFile=./hack/boilerplate.go.txt paths="./..."
go fmt ./...
go vet ./...
${GOPATH}/bin//controller-gen "crd:trivialVersions=true" rbac:roleName=manager-role webhook paths="./..." output:crd:artifacts:config=config/crd/bases
go run ./main.go
2019-10-29T20:57:32.772+0900    INFO    controller-runtime.metrics      metrics server is starting to listen    {"addr": ":8080"}
2019-10-29T20:57:32.772+0900    INFO    controller-runtime.controller   Starting EventSource    {"controller": "guestbook", "source": "kind source: /, Kind="}
2019-10-29T20:57:32.772+0900    INFO    setup   starting manager
2019-10-29T20:57:32.772+0900    INFO    controller-runtime.manager      starting metrics server {"path": "/metrics"}
2019-10-29T20:57:32.874+0900    INFO    controller-runtime.controller   Starting Controller     {"controller": "guestbook"}
2019-10-29T20:57:32.974+0900    INFO    controller-runtime.controller   Starting workers        {"controller": "guestbook", "worker count": 1}
2019-10-29T20:58:55.574+0900    DEBUG   controller-runtime.controller   Successfully Reconciled {"controller": "guestbook", "request": "default/guestbook-sample"}
...

Ctrl + C to stop.

Get and Describe Resource

# get
$ kubectl get guestbook
NAME               AGE
guestbook-sample   2m47s
$ kubectl describe guestbook guestbook-sample
Name:         guestbook-sample
Namespace:    default
Labels:       <none>
Annotations:  kubectl.kubernetes.io/last-applied-configuration:
                {"apiVersion":"webapp.kubebuilder.kamiazya.tech/v1","kind":"Guestbook","metadata":{"annotations":{},"name":"guestbook-sample","namespace":...
API Version:  webapp.kubebuilder.kamiazya.tech/v1
Kind:         Guestbook
Metadata:
  Creation Timestamp:  2019-10-29T11:58:55Z
  Generation:          1
  Resource Version:    100219
  Self Link:           /apis/webapp.kubebuilder.kamiazya.tech/v1/namespaces/default/guestbooks/guestbook-sample
  UID:                 57d25e09-2a8f-40ad-9bd5-5444a610f23c
Spec:
  Foo:   bar
Events:  <none>