3. 核心API资源：CRD定义、CRD版本管理、CRD字段校验

在Kubernetes Operator开发中，自定义资源定义（Custom Resource Definition, CRD）是扩展API的基石。CRD定义了Operator所管理资源的Schema、版本演进规则以及字段合法性约束。本章深入剖析CRD的三大核心能力：定义结构、版本管理与字段校验，帮助你在Operator资源限制与性能调优场景中精准控制资源模型。

3.1 CRD定义结构

一个完整的CRD由spec中的group、names、scope和versions四部分构成。以下是一个面向资源限制场景的CRD示例，定义了一个名为ResourceProfile的自定义资源：

apiVersion: apiextensions.k8s.io/v1
kind: CustomResourceDefinition
metadata:
  name: resourceprofiles.operator.example.com
spec:
  group: operator.example.com
  names:
    kind: ResourceProfile
    plural: resourceprofiles
    singular: resourceprofile
    shortNames:
      - rp
  scope: Namespaced
  versions:
    - name: v1
      served: true
      storage: true
      schema:
        openAPIV3Schema:
          type: object
          properties:
            spec:
              type: object
              properties:
                cpuLimit:
                  type: string
                  pattern: '^[0-9]+m?$'
                memoryLimit:
                  type: string
                  pattern: '^[0-9]+(Ki|Mi|Gi)?$'
                replicas:
                  type: integer
                  minimum: 1
                  maximum: 100
                priority:
                  type: string
                  enum: [low, medium, high]

3.2 CRD版本管理

CRD版本管理是Operator演进的关键能力。Kubernetes支持在同一个CRD中定义多个API版本，并通过转换Webhook或存储版本选择实现平滑升级。版本管理策略直接影响Operator的兼容性与性能。

3.3 CRD字段校验

CRD字段校验通过OpenAPI v3 Schema实现，在资源创建或更新时由API Server自动执行。合理的字段校验可以提前捕获配置错误，减少Operator运行时异常，提升系统稳定性。在资源限制场景中，字段校验尤为重要，可防止用户设置不合理的资源配额。

3.3.1 常用校验规则

3.3.2 高级校验：x-kubernetes-validations

Kubernetes 1.25+ 引入了CRD Validation Rules（x-kubernetes-validations），支持基于CEL（Common Expression Language）的复杂校验逻辑。这对于资源限制场景非常有用，例如校验CPU与内存的比例关系：

openAPIV3Schema:
  type: object
  properties:
    spec:
      type: object
      properties:
        cpuLimit:
          type: string
        memoryLimit:
          type: string
        replicas:
          type: integer
      x-kubernetes-validations:
        - rule: "self.cpuLimit != '' && self.memoryLimit != ''"
          message: "cpuLimit and memoryLimit must not be empty"
        - rule: "self.replicas >= 1 && self.replicas <= 100"
          message: "replicas must be between 1 and 100"
        - rule: "self.memoryLimit.matches('^[0-9]+(Ki|Mi|Gi)?$')"
          message: "memoryLimit must be a valid Kubernetes memory quantity"

3.4 CRD字段校验与资源限制的关联

在Operator资源限制与性能调优中，CRD字段校验直接决定了资源模型的健壮性。以下是一个典型的资源限制校验矩阵：