K8s CRD

CR

定制资源（Custom Resource） 是对 Kubernetes API 的扩展.
资源（Resource） 是 Kubernetes API 中的一个端点， 其中存储的是某个类别的 API 对象 的一个集合。 例如内置的 pods 资源包含一组 Pod 对象

定制资源（Custom Resource） 是对 Kubernetes API 的扩展，不一定在默认的 Kubernetes 安装中就可用。定制资源所代表的是对特定 Kubernetes 安装的一种定制。 不过，很多 Kubernetes 核心功能现在都用定制资源来实现，这使得 Kubernetes 更加模块化

定制资源可以通过动态注册的方式在运行中的集群内或出现或消失，集群管理员可以独立于集群 更新定制资源。一旦某定制资源被安装，用户可以使用 kubectl 来创建和访问其中的对象，就像他们为 pods 这种内置资源所做的一样

CRD

CustomResourceDefinition API 资源允许你定义定制资源。 定义 CRD 对象的操作会使用你所设定的名字和模式定义（Schema）创建一个新的定制资源， Kubernetes API 负责为你的定制资源提供存储和访问服务。 CRD 对象的名称必须是合法的 DNS 子域名

创建CRD

例如，下面是一个crd.yaml的例子

# mybooks-crd.yaml
apiVersion: apiextensions.k8s.io/v1
kind: CustomResourceDefinition
metadata:
  # 名字必需与下面的 spec 字段匹配，并且格式为 '<名称的复数形式>.<组名>'
  name: mybooks.cloud.lilq.cn
spec:
  # 组名称，用于 REST API: /apis/<组>/<版本> 
  group: cloud.lilq.cn
  # 列举此 CustomResourceDefinition 所支持的版本
  versions:
    # 版本名称，比如 v1、v2beta1 等等   
  - name: v1
    # 每个版本都可以通过 served 标志来独立启用或禁止 
    served: true
    # 其中一个且只有一个版本必需被标记为存储版本
    storage: true
    # 定义自定义对象的声明规范
    schema:
      openAPIV3Schema:
        description: Define MyBook YAML Spec
        type: object
        properties:
          # 自定义CRD的字段类型
          spec:
            type: object
            properties:
              uuid:
                type: string
              name:
                type: string
              price:
                type: integer
  # 定义作用范围：Namespaced（命名空间级别）或者 Cluster（整个集群）
  scope: Namespaced
  names:
    # kind 通常是单数形式的帕斯卡编码（PascalCased）形式。你的资源清单会使用这一形式
    kind: MyBook
    # plural 名字用于 REST API 中的定义：/apis/<group>/<version>/<plural>    
    plural: mybooks
    # singular 名称用于 CLI 操作或显示的一个别名 
    singular: mybook
    # shortNames 允许你在命令行使用较短的字符串来匹配资源
    shortNames:
    - mb  

• 创建
  kubectl apply -f mybooks-crd.yaml
• 查看创建的RESTful API
  kubectl get --raw /apis/cloud.lilq.cn/v1 | python -m json.tool
• 查看创建的CRD
  kubectl get crd

创建定制对象

针对上面创建MyBook对象进行添加，删除，更新等操作了，先添加一条记录

# mybook.yaml
apiVersion: cloud.lilq.cn/v1
kind: MyBook
metadata:
  name: my-new-mybook-object
spec:
  uuid: "2c4789b2-30f2-4d31-ab71-ca115ea8c100"
  name: "mybook"
  price: 500

• 创建
  kubectl apply -f mybook.yaml
• 查看
  kubectl get mb
kubectl get mybook
kubectl get mb -o yaml
• 删除
  kubectl delete -f mybook.yaml