1. CRD 基础概念

1.1 什么是 CustomResourceDefinition

CustomResourceDefinition（CRD）是 Kubernetes 内置的一种 API 资源类型，它允许用户在不修改核心 Kubernetes 源码的前提下，向集群中注册并管理自定义的资源类型。CRD 本质上是 Kubernetes API 的扩展机制，通过声明式配置定义新资源的名称、分组、版本和结构，Kubernetes 会为其自动生成 RESTful API 端点、存储（etcd）以及基础的 CRUD 操作。

以下是一个典型的 CRD 定义示例，它定义了一个名为 Application 的自定义资源：

apiVersion: apiextensions.k8s.io/v1
kind: CustomResourceDefinition
metadata:
  name: applications.example.com
spec:
  group: example.com
  names:
    kind: Application
    plural: applications
    singular: application
    shortNames:
      - app
  scope: Namespaced
  versions:
    - name: v1
      served: true
      storage: true
      schema:
        openAPIV3Schema:
          type: object
          properties:
            spec:
              type: object
              properties:
                replicas:
                  type: integer
                image:
                  type: string
            status:
              type: object
              properties:
                availableReplicas:
                  type: integer
                phase:
                  type: string

1.2 CRD 与原生资源的关系

CRD 定义的自定义资源与 Kubernetes 原生资源（如 Pod、Service、Deployment）在 API 机制上完全对等，但在实现深度上存在本质差异。下表从多个维度对比两者的关系：

1.3 CRD 在 Kubernetes 生态中的角色

CRD 是 Kubernetes 生态扩展能力的基石，它使得 Kubernetes 从一个容器编排平台演变为一个通用的云原生应用平台。CRD 在生态中扮演以下核心角色：

• 平台扩展层：CRD 允许平台团队定义业务领域模型（如 Database、Certificate、Pipeline），将 Kubernetes 从“资源调度层”提升为“业务抽象层”。
• Operator 模式的基础：几乎所有 Operator（如 etcd-operator、prometheus-operator、cert-manager）都依赖 CRD 定义其管理的资源类型，CRD 是 Operator 的“数据模型”。
• 声明式配置的载体：CRD 实例以 YAML/JSON 形式存在，天然适配 GitOps 工作流，支持版本控制、审计和自动化运维。
• 生态互操作的契约：不同项目通过 CRD 暴露其 API，例如 Istio 的 VirtualService、Knative 的 Service，CRD 成为生态组件之间的标准化接口。

1.4 CRD 的生命周期与版本管理

CRD 本身也是一种 API 资源，拥有完整的生命周期管理能力。理解 CRD 的生命周期对于 Operator 开发和故障排查至关重要：

1. 创建阶段：提交 CRD YAML 到集群，API Server 校验 Schema 合法性，注册新的 RESTful 端点。
2. 版本演进：CRD 支持多个版本共存（如 v1alpha1、v1beta1、v1），通过 spec.versions 定义。每个版本可以独立定义 Schema，但只有一个版本被标记为 storage: true。
3. 废弃与删除：删除 CRD 会级联删除所有自定义资源实例（除非设置了 preserveUnknownFields）。建议先移除所有实例再删除 CRD。