如何创建 CRD？

推荐答案

要创建 Kubernetes 自定义资源定义（CRD），可以按照以下步骤进行：

1. 定义 CRD YAML 文件：首先，创建一个 YAML 文件来定义 CRD。这个文件描述了自定义资源的 API 组、版本、类型等信息。

// www.javascriptcn.com code example
apiVersion: apiextensions.k8s.io/v1
kind: CustomResourceDefinition
metadata:
  name: mycustomresources.example.com
spec:
  group: example.com
  versions:
    - name: v1
      served: true
      storage: true
      schema:
        openAPIV3Schema:
          type: object
          properties:
            spec:
              type: object
              properties:
                size:
                  type: integer
                image:
                  type: string
  scope: Namespaced
  names:
    plural: mycustomresources
    singular: mycustomresource
    kind: MyCustomResource
    shortNames:
    - mcr

1. 应用 CRD 到 Kubernetes 集群：使用 kubectl apply 命令将 CRD 应用到 Kubernetes 集群中。

kubectl apply -f my-crd.yaml

1. 验证 CRD 是否创建成功：使用 kubectl get crd 命令查看 CRD 是否成功创建。

kubectl get crd mycustomresources.example.com

1. 创建自定义资源实例：在 CRD 创建成功后，可以创建自定义资源的实例。

apiVersion: example.com/v1
kind: MyCustomResource
metadata:
  name: my-custom-resource-instance
spec:
  size: 3
  image: "nginx:latest"

1. 应用自定义资源实例：使用 kubectl apply 命令将自定义资源实例应用到集群中。

kubectl apply -f my-custom-resource-instance.yaml

本题详细解读

什么是 CRD？

CRD（Custom Resource Definition）是 Kubernetes 中的一种扩展机制，允许用户定义自己的资源类型。通过 CRD，用户可以将自定义资源（Custom Resource）添加到 Kubernetes API 中，从而扩展 Kubernetes 的功能。

CRD 的核心字段

• apiVersion: 指定 CRD 的 API 版本，通常为 apiextensions.k8s.io/v1。
• kind: 指定资源类型为 CustomResourceDefinition。
• metadata: 包含 CRD 的元数据，如 name。
• spec: 定义 CRD 的规范，包括：
  • group: 自定义资源的 API 组。
  • versions: 定义资源的版本，每个版本可以有不同的 schema。
  • scope: 定义资源的作用域，可以是 Namespaced 或 Cluster。
  • names: 定义资源的名称，包括 plural、singular、kind 和 shortNames。

创建 CRD 的步骤

1. 定义 CRD YAML 文件：通过 YAML 文件定义 CRD 的结构和属性。
2. 应用 CRD 到集群：使用 kubectl apply 命令将 CRD 应用到 Kubernetes 集群中。
3. 验证 CRD 创建：使用 kubectl get crd 命令验证 CRD 是否成功创建。
4. 创建自定义资源实例：定义并应用自定义资源的实例。
5. 管理自定义资源：通过 Kubernetes API 或 kubectl 管理自定义资源。

注意事项

• 版本管理：在定义 CRD 时，可以指定多个版本，但只有一个版本可以作为存储版本。
• Schema 验证：可以通过 openAPIV3Schema 定义资源的 schema，Kubernetes 会根据这个 schema 验证资源的合法性。
• 资源命名：确保 CRD 的名称和自定义资源的名称符合 Kubernetes 的命名规范。