kubernetes学习记录（14）——使用CustomResourceDefinitions（CRD）扩展Kubernetes API

工作中即将开始写operator，先提前学习一下相关的知识

目前我们的kubernetes集群版本为1.15.0，故参考文档为官方文档《Extend the Kubernetes API with CustomResourceDefinitions》

创建一个CustomResourceDefinition

• 官方例子

# resourcedefinition.yaml
apiVersion: apiextensions.k8s.io/v1beta1
kind: CustomResourceDefinition
metadata:
  # name must match the spec fields below, and be in the form: <plural>.<group>
  name: crontabs.stable.example.com
spec:
  # group name to use for REST API: /apis/<group>/<version>
  group: stable.example.com
  # list of versions supported by this CustomResourceDefinition
  versions:
    - name: v1
      # Each version can be enabled/disabled by Served flag.
      served: true
      # One and only one version must be marked as the storage version.
      storage: true
  # either Namespaced or Cluster
  scope: Namespaced
  names:
    # plural name to be used in the URL: /apis/<group>/<version>/<plural>
    plural: crontabs
    # singular name to be used as an alias on the CLI and for display
    singular: crontab
    # kind is normally the CamelCased singular type. Your resource manifests use this.
    kind: CronTab
    # shortNames allow shorter string to match your resource on the CLI
    shortNames:
    - ct
  preserveUnknownFields: false
  validation:
    openAPIV3Schema:
      type: object
      properties:
        spec:
          type: object
          properties:
            cronSpec:
              type: string
            image:
              type: string
            replicas:
              type: integer

• 根据yaml创建crd

# kubectl apply -f resourcedefinition.yaml
customresourcedefinition.apiextensions.k8s.io/crontabs.stable.example.com created
# kubectl get crd | grep crontabs
crontabs.stable.example.com             2020-01-08T07:49:53Z

创建自定义对象

• 根据上文定义的CRD，创建CRD对象

# my-crontab.yaml
apiVersion: "stable.example.com/v1"
kind: CronTab
metadata:
  name: my-new-cron-object
spec:
  cronSpec: "* * * * */5"
  image: my-awesome-cron-image

# kubectl apply -f my-crontab.yaml
# kubectl get crontab
NAME                 AGE
my-new-cron-object   28s

删除自定义对象

删除CustomResourceDefinition时，服务器将卸载RESTful API端点并删除其中存储的所有自定义对象

# kubectl delete -f resourcedefinition.yaml
# kubectl get crontabs
Error from server (NotFound): Unable to list "stable.example.com/v1, Resource=crontabs": the server could not find the requested resource (get crontabs.stable.example.com)