k8s的API资源对象CustomResourceDefinition（CRD）

API资源对象CustomResourceDefinition（CRD）**

在Kubernetes中，像Pod、Service和Deployment这样的资源是由内置的资源类型如Pod、Service和Deployment表示的。而CustomResourceDefinition（CRD）允许你定义和创建自己的资源类型，以满足您的应用程序或基础设施需求。

一旦定义了CRD，可以通过Kubernetes API服务器创建和管理自定义资源的实例，就像处理任何其他本机资源一样。这意味着您可以使用熟悉的Kubernetes工具如kubectl或Kubernetes控制器与管理您的自定义资源进行交互。

CRD提供了一种扩展Kubernetes平台以适应特定要求的方式，并能够构建自定义的运算符或控制器来自动化管理自定义资源。运算符可以监视自定义资源的更改并相应地采取操作，例如提供额外的资源、扩展或执行自定义操作。

CRD已成为扩展Kubernetes的流行机制，在Kubernetes生态系统中的各种项目和框架中广泛使用，如Prometheus、Istio和Knative。

示例：

cat > crd-example.yaml << EOF
apiVersion: apiextensions.k8s.io/v1
kind: CustomResourceDefinition
metadata:
  name: myresources.example.com
spec:
  group: example.com
  versions:
    - name: v1
      served: true
      storage: true
      schema:
        openAPIV3Schema:
          description: Define CronTab YAML Spec
          type: object
          properties:
            spec:
              type: object
              properties:
                name:
                  type: string
                age:
                  type: integer
  scope: Namespaced
  names:
    plural: myresources
    singular: myresource
    kind: MyResource
    shortNames:
      - mr
EOF

说明：

和我们定义普通的资源对象比较类似，这里可以随意定义一个自定义的资源对象，但是在创建资源的时候，肯定不是任由我们随意去编写 YAML 文件的，当我们把上面的 CRD 文件提交给 Kubernetes 之后，Kubernetes 会对我们提交的声明文件进行校验，从定义可以看出 CRD 是基于 OpenAPI v3 schem 进行规范的。

apiVersion：指定所使用的 CRD API 的版本，此示例使用了 apiextensions.k8s.io/v1 版本。
kind：定义资源类型为 CustomResourceDefinition。
metadata：定义元数据，其中 name 字段指定了 CRD 的名称为 myresources.example.com。
spec：定义了 CRD 的规范。
group：指定 CRD 所属的 API 组，此示例中为 example.com。
versions：定义 CRD 的版本列表。
name：指定版本的名称，此示例中为 v1。
served：指定此版本是否由 API 服务器提供服务，设为 true 表示提供服务。
storage：指定此版本是否持久化存储数据，设为 true 表示持久化存储。
openAPIV3Schema：指定自定义资源的 OpenAPI v3 架构定义
type：定义类型
properties：定义对象属性
name/age：自定义具体属性的名字
scope：指定资源的作用域，此示例中为 Namespaced，表示资源在命名空间级别进行管理。
names：定义了资源的名称相关信息。
plural：指定资源的复数形式名称，此示例中为 myresources。
singular：指定资源的单数形式名称，此示例中为 myresource。
kind：指定资源的类型名称，此示例中为 MyResource。
shortNames：指定资源的缩略名称列表，此示例中只包含一个缩略名称 mr。

应用

kubectl apply -f crd-example.yaml

查看crd

kubectl get crd

一旦创建完自定义的CRD，那么就会生成一个自定义的API

/apis/example.com/v1/namespaces/*/myresources/...

创建自定义资源实例，基于前面CRD定义的资源

cat > myresource-instance.yaml <<EOF
apiVersion: example.com/v1
kind: MyResource   ##和上面CRD里相对应
metadata:
  name: myresource-instance
spec: ##以下两个key必须在CRD中有过定义
  name: example
  age: 25
EOF

应用

kubectl apply -f myresource-instance.yaml

查看MyResource

kubectl get MyResource  #或者用短名称
kubectl get mr

以上定义的CRD，仅仅是写入到了etcd中，并没有其它用处，要想让它有进一步作用，还得去定义Controller

而Controller更多的是开发范畴的事情，咱们暂时先不涉及。