K8s CRD是啥？怎么用？一文讲透自定义资源定义

应用并验证：

 apply -f my-.yaml
# 输出: /my-new-cron- 
 get 
# 输出:
# NAME                   AGE
# my-new-cron-     10s
   my-new-cron-
# 输出包含spec等详细信息

3.3 删除CRD（注意：会级联删除所有自定义资源）

  crd 

4. CRD设计最佳实践

4.1 API组与版本命名规范

4.2 结构定义（）强制要求

必须提供 ，原因：

提供API请求的自动验证

生成准确的文档

命令能够显示字段说明

可以通过进行代码生成

编写规范：

:
  :
    type: 
    :
      spec:
        type: 
        :
          # 所有字段必须明确类型
          :
            type:           # 或 , , array, 
            : "字段说明"  # 强烈推荐添加描述
            : "^[a-z]+$"    # 正则验证（可选）
            : 1             # 数值范围（可选）
            : 100
        :                  # 必填字段列表
      :                      # 字段通常由管理
        type: 
        :
          :
            type: 
          :
            type: array

4.3 作用域选择决策

4.4 多版本管理策略

版本共存规则：

每个CRD可以有多个 : true 的版本

有且仅有一个 : true 版本

版本转换通过或自动转换实现

版本演进建议：

1. 新增版本时：新版本 : true，保持旧版本 : true

2. 稳定后切换存储版本：将新版本设为 : true，旧版本 : false

3. 移除版本前：确保没有资源使用该版本，观察期至少3个月

5. 常见问题与解决方案

Q1: 更新CRD定义时失败，提示 “the spec is “

原因： 对CRD spec的变更有限制，某些字段不可变。

解决方案：

# 方法1：删除后重建（会删除所有自定义资源实例）
  crd <crd-name>
 apply -f new-crd.yaml
# 方法2：使用  --force
  --force -f new-crd.yaml
# 方法3：保留现有CRD，通过新版本添加字段（推荐）
# 在spec.中添加新版本，将新字段放在新版本中

不可变字段清单：

spec.group

spec.names.kind

spec.scope

spec.[</>]. 中的现有字段类型（不能修改已有字段类型）

Q2: 如何调试CRD创建的资源无法写入etcd？

排查步骤：

# 1. 查看CRD状态
 get crd <crd-name> -o yaml | grep -A5 
# 2. 检查API服务是否可用
 get  | grep <group>
# 3. 查看API服务器日志（需要访问节点）
# 常见错误：验证失败，字段类型不匹配
# 4. 使用 验证
  <kind> --

Q3: 如何让支持自定义资源的自动补全？

在CRD的 spec.names 中正确配置 ：

names:
  :
ct    # 之后可以使用  get ct

Q4: CRD支持哪些字段类型？

6. 实战：完整的企业级CRD示例

场景：定义一个MySQL数据库集群资源

文件：-crd.yaml

: .k8s.io/v1
kind: tion
:
  name: 
spec:
  group: 
  names:
    : 
    : 
    kind: 
    :
mc
  scope: 
  :
name: v1
    : true
    : true
    :
      :
        type: 
        :
          spec:
            type: 
            :
              :
                type: 
                : "MySQL "
                : "^[0-9]+\.[0-9]+\.[0-9]+$"
                : "8.0.33"
              :
                type: 
                : " of MySQL "
                : 1
                : 10
                : 1
              :
                type: 
                :
                  size:
                    type: 
                    : "^[0-9]+(Gi|Mi)$"
                  :
                    type: 
                :
size
              :
                type: 
                :
                  :
                    type: 
                  :
                    type: 
                :
            :
          :
            type: 
            :
              phase:
                type: 
                enum:
              :
                type: 
              :
                type: array
                items:
                  type: 
                  :
                    type:
                      type: 
                    :
                      type: 
                    :
                      type: 
                      : date-time

创建并使用：

# 1. 创建CRD
 apply -f -crd.yaml
# 2. 创建MySQL集群实例
cat <<EOF |  apply -f -
: /v1
kind: 
:
  name: -mysql
spec:
  : "8.0.33"
  : 3
  :
    size: "100Gi"
    : "fast-ssd"
  :
    : true
    : "0 2   *"
EOF
# 3. 查看集群状态
 get  -mysql -o yaml

7. 高级主题：CRD与的协作

CRD本身只是数据定义，要实现自动化管理，必须配合 （控制器）工作。

典型的模式架构：

1. CRD定义资源期望状态（spec）

2. 监听CRD资源的变更

3. 创建/管理Pod、等基础资源

4. 将实际状态写回字段

开发的常用框架：

8. 权威参考资源

9. 总结：CRD核心要点

1. 本质定位：CRD是的原生扩展机制，将集群变为可编程平台

2. 强制规范：必须使用域名格式的group、必须提供

3. 版本管理：支持多版本共存，仅一个版本，字段类型不可变

4. 作用域选择：根据资源性质选择或

5. 完整方案：CRD通常需要配合才能实现自动化管理

6. 最佳实践：使用或 SDK构建生产级扩展

按照本文档操作，您可以在30分钟内完成第一个CRD的创建和使用，并在理解核心原理后，设计出符合生态规范的企业级自定义资源。