CRDs-catalog支持的500+ CRD分类指南：快速找到所需资源定义

📅 2026/7/6 19:35:45 👁️ 阅读次数 📝 编程学习
CRDs-catalog支持的500+ CRD分类指南：快速找到所需资源定义

CRDs-catalog支持的500+ CRD分类指南：快速找到所需资源定义

【免费下载链接】CRDs-catalogPopular Kubernetes CRDs (CustomResourceDefinition) in JSON schema format.项目地址: https://gitcode.com/gh_mirrors/cr/CRDs-catalog

Kubernetes CRDs-catalog是一个包含500多个分类、超过4000个JSON schema文件的强大资源库，专门为Kubernetes自定义资源定义提供标准化验证支持。这个开源项目帮助开发者和运维人员快速查找和使用各种CRD资源，实现左移验证策略。无论您是Kubernetes新手还是经验丰富的专家，这份完整指南将带您深入了解如何高效使用这个庞大的CRD分类目录。

📊 CRDs-catalog项目概览

CRDs-catalog项目汇集了来自各个知名厂商和开源项目的Kubernetes自定义资源定义，以JSON schema格式进行标准化存储。这些schema可以被Datree、Kubeconform和Kubeval等工具直接使用，替代传统的kubectl --dry-run验证方式，在不访问集群的情况下进行本地验证。

项目的主要价值在于：

  • 标准化格式：所有CRD都以统一的JSON schema格式存储
  • 广泛覆盖：涵盖云原生生态系统中绝大多数流行CRD
  • 即插即用：可直接用于CI/CD流水线和开发环境
  • 社区驱动：持续更新和维护，保持与最新版本同步

🗂️ CRD分类体系解析

CRDs-catalog按照CRD的API组进行逻辑分类，每个目录对应一个特定的API组。这种分类方式让用户能够快速定位所需资源。让我们深入了解主要的分类体系：

云服务提供商CRD分类

AWS相关CRD：

  • acm.services.k8s.aws/- AWS证书管理器
  • acmpca.services.k8s.aws/- AWS私有CA服务
  • aga.k8s.aws/- AWS全局加速器
  • apigatewayv2.services.k8s.aws/- API Gateway v2

Google Cloud相关CRD：

  • accesscontextmanager.cnrm.cloud.google.com/- 访问上下文管理器
  • alloydb.cnrm.cloud.google.com/- AlloyDB数据库
  • billingbudgets.cnrm.cloud.google.com/- 计费预算
  • metastore.cnrm.cloud.google.com/- 元数据存储

Azure相关CRD：

  • alertsmanagement.azure.com/- 警报管理
  • network.frontdoor.azure.com/- 前端门服务
  • app.azure.com/- 应用服务

Kubernetes原生扩展CRD分类

核心Kubernetes扩展：

  • autoscaling.k8s.io/- 自动扩缩容
  • batch.k8s.io/- 批处理作业
  • certificates.k8s.io/- 证书管理
  • coordination.k8s.io/- 协调服务

网络与安全CRD：

  • cilium.io/- Cilium网络策略
  • gateway.networking.k8s.io/- 网关API
  • networking.k8s.io/- 网络策略
  • policy.k8s.io/- 安全策略

数据库与存储CRD分类

关系型数据库：

  • aiven.io/- Aiven云数据库服务
  • barmancloud.cnpg.io/- CloudNativePG备份
  • mongodbcommunity.mongodb.com/- MongoDB社区版
  • mysql.oracle.com/- MySQL Operator

NoSQL与缓存：

  • cassandra.datastax.com/- Cassandra数据库
  • redis.redis.opstreelabs.in/- Redis操作
  • postgresql.cnpg.io/- CloudNative PostgreSQL

监控与可观测性CRD分类

监控告警系统：

  • alerting.grafana.crossplane.io/- Grafana告警
  • monitoring.coreos.com/- Prometheus监控
  • monitoring.grafana.crossplane.io/- Grafana监控

日志与追踪：

  • logging.banzaicloud.io/- 日志收集
  • opentelemetry.io/- 分布式追踪
  • tracing.jaegertracing.io/- Jaeger追踪

GitOps与持续交付CRD分类

Flux CD生态系统：

  • helm.toolkit.fluxcd.io/- Helm控制器
  • image.toolkit.fluxcd.io/- 镜像自动化
  • kustomize.toolkit.fluxcd.io/- Kustomize控制器
  • notification.toolkit.fluxcd.io/- 通知控制器

Argo CD生态系统：

  • argoproj.io/- Argo工作流与CD
  • argocd.argoproj.io/- Argo CD应用

🔍 快速查找CRD的实用技巧

按API组搜索

CRDs-catalog的目录结构基于API组命名，这使得搜索变得非常直观。例如：

  1. 查找证书管理CRD：

    • 搜索包含"cert"的目录：cert-manager.io/、certificates.k8s.io/

  2. 查找网络相关CRD：

    • 搜索包含"net"的目录：networking.k8s.io/、networkaddonsoperator.kubevirt.io/

  3. 查找存储相关CRD：

    • 搜索包含"storage"的目录：storage.k8s.io/、storage.cnrm.cloud.google.com/

使用通配符匹配

在项目根目录下，您可以使用简单的shell命令快速查找：

# 查找所有AWS相关CRD ls -d *.k8s.aws # 查找所有Google Cloud相关CRD ls -d *.cloud.google.com # 查找所有监控相关CRD ls -d *monitoring*

理解版本后缀

每个JSON schema文件都包含版本信息：

  • _v1.json- 稳定版本
  • _v1alpha1.json- Alpha测试版本
  • _v1beta1.json- Beta测试版本
  • _v2.json- 第二版API

🛠️ 实际应用场景

场景一：VS Code智能提示配置

在VS Code中使用Red Hat YAML插件时，您可以在YAML文件中添加schema注释：

# yaml-language-server: $schema=https://datreeio.github.io/CRDs-catalog/cert-manager.io/certificate_v1.json apiVersion: cert-manager.io/v1 kind: Certificate metadata: name: example-cert spec: secretName: example-cert-tls dnsNames: - example.com

场景二：CI/CD流水线验证

在GitHub Actions中使用Kubeconform进行验证：

- name: Validate Kubernetes manifests uses: yannh/kubeconform-action@v3 with: schema-location: 'default,https://raw.githubusercontent.com/datreeio/CRDs-catalog/main/{{.Group}}/{{.ResourceKind}}_{{.ResourceAPIVersion}}.json' files: 'manifests/**/*.yaml'

场景三：本地开发验证

使用Datree进行本地验证：

# 验证单个文件 datree test deployment.yaml # 验证整个目录 datree test ./manifests/

📁 项目结构深度解析

顶级目录组织

项目采用扁平化目录结构，每个API组对应一个目录：

CRDs-catalog/ ├── aadpodidentity.k8s.io/ │ ├── azureassignedidentity_v1.json │ └── azureidentity_v1.json ├── acm.services.k8s.aws/ │ └── certificate_v1alpha1.json ├── cert-manager.io/ │ ├── certificate_v1.json │ └── issuer_v1.json └── ...

版本管理策略

每个CRD可能有多个版本，项目会保留历史版本以确保向后兼容性：

cert-manager.io/ ├── certificate_v1.json # 稳定版本 ├── certificate_v1alpha1.json # Alpha版本 └── certificate_v1beta1.json # Beta版本

跨版本兼容性

项目维护不同API版本的schema，确保用户可以根据自己的Kubernetes集群版本选择合适的schema文件。

🚀 高效使用的最佳实践

实践一：建立本地缓存

对于频繁使用的CRD，建议建立本地缓存：

# 下载常用CRD schema curl -L https://raw.githubusercontent.com/datreeio/CRDs-catalog/main/cert-manager.io/certificate_v1.json -o schemas/cert-manager-certificate.json

实践二：创建schema索引

创建自定义的schema索引文件，记录常用CRD的位置：

# schema-index.yaml schemas: cert-manager: certificate: https://datreeio.github.io/CRDs-catalog/cert-manager.io/certificate_v1.json issuer: https://datreeio.github.io/CRDs-catalog/cert-manager.io/issuer_v1.json ingress-nginx: ingress: https://datreeio.github.io/CRDs-catalog/networking.k8s.io/ingress_v1.json

实践三：团队共享配置

在团队项目中共享schema配置：

# .vscode/settings.json { "yaml.schemas": { "https://datreeio.github.io/CRDs-catalog/cert-manager.io/certificate_v1.json": "certificate.yaml", "https://datreeio.github.io/CRDs-catalog/networking.k8s.io/ingress_v1.json": "ingress-*.yaml" } }

🔄 保持同步与更新

定期更新策略

  1. 订阅仓库更新：关注项目的GitHub releases
  2. 自动化同步：使用GitHub Actions定期拉取更新
  3. 版本检查：定期验证使用的schema是否最新

贡献新CRD

如果您发现缺少某个CRD，可以通过以下方式贡献：

  1. 使用项目提供的CRD Extractor工具从集群提取CRD
  2. 提交Pull Request到相应目录
  3. 确保遵循项目的命名规范和版本约定

📈 性能优化建议

减少网络延迟

对于CI/CD环境，建议：

  1. 预下载schema：在构建镜像时包含常用schema
  2. 使用CDN缓存：配置本地镜像或CDN加速
  3. 批量验证：合并多个文件的验证请求

选择性加载

只加载实际使用的schema，避免不必要的网络请求：

# 只验证特定类型的资源 kubeconform \ -schema-location default \ -schema-location 'https://raw.githubusercontent.com/datreeio/CRDs-catalog/main/cert-manager.io/{{.ResourceKind}}_{{.ResourceAPIVersion}}.json' \ -skip 'CustomResourceDefinition' \ manifests/

🎯 常见问题解答

Q: 如何找到特定厂商的CRD？

A: 使用厂商域名作为搜索关键词，如查找AWS相关CRD：ls -d *.amazonaws.com *.k8s.aws

Q: schema验证失败怎么办？

A: 首先检查API版本是否匹配，然后确认使用的schema URL是否正确。可以使用项目的annotate-yaml.py工具自动添加正确的schema注释。

Q: 如何验证自定义CRD？

A: 使用CRD Extractor工具从您的集群提取CRD并生成schema，然后将其添加到本地验证配置中。

Q: 项目是否支持私有CRD？

A: 项目主要收集公开可用的CRD。对于私有CRD，建议使用CRD Extractor生成schema并在内部使用。

🌟 总结

CRDs-catalog项目为Kubernetes生态提供了宝贵的资源定义库，通过500+分类的精心组织，让开发者能够快速定位和使用各种CRD。无论您是构建云原生应用、配置CI/CD流水线，还是进行本地开发验证，这个项目都能显著提升您的工作效率。

记住这些关键点：

  • 按API组分类查找最快捷
  • 合理使用版本后缀选择合适schema
  • 结合VS Code插件获得最佳开发体验
  • 定期更新schema以保持兼容性

通过掌握这份分类指南，您将能够充分利用CRDs-catalog的强大功能，在Kubernetes世界中游刃有余！ 🚀

【免费下载链接】CRDs-catalogPopular Kubernetes CRDs (CustomResourceDefinition) in JSON schema format.项目地址: https://gitcode.com/gh_mirrors/cr/CRDs-catalog

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

编程学习 技术分享 实战经验

相关新闻

UOS Libvirt Exporter社区贡献指南：如何参与开源项目开发

2026/7/6 19:35:45

基于TPAFE0808与PIC32的多通道实时信号采集系统设计

2026/7/6 19:35:45

FocalNet vs Swin Transformer：如何选择最适合你的视觉Transformer模型？终极性能对比指南

2026/7/6 19:35:50

最新新闻

HokoBlur核心功能解析：Native、OpenGL与Java三种模糊方案对比

2026/7/6 20:25:54

3大技术突破：开源BMS修复工具如何打破厂商锁定壁垒

2026/7/6 20:25:54

AMP by Example入门教程：如何在5分钟内创建你的第一个AMP页面

2026/7/6 20:25:54

本地部署AI图像生成工具：从环境配置到API集成的完整实践指南

2026/7/6 20:25:54

解决方案：Stremio Torrentio插件｜3大核心模块｜5步智能部署

2026/7/6 20:25:54

zgrab配置文件详解：轻松定制你的网络扫描策略

2026/7/6 20:25:54

日新闻

SAM2模型解析：图像分割新突破与实战指南

2026/7/6 0:00:22

Windows Hypervisor Platform (WHP) 原理解析：VMWare 15.5.5 如何从 VMM 切换到用户态

2026/7/6 0:00:22

基于Si4731与STM32F207的嵌入式音频系统开发指南

2026/7/6 0:00:22

周新闻

基于YOLOv12的番茄成熟度智能检测系统开发

2026/7/6 9:56:08

Claude API国内使用合规指南与国产替代方案

2026/7/6 9:57:41

终极RimWorld模组管理指南：用RimSort告别模组冲突烦恼

2026/7/6 9:57:39

月新闻

[C++]内存管理：串顺序存储的内存回收

2026/7/6 15:02:18

足球口袋教练 HarmonyOS 离线应用实战（03/20）：ArkUI 首页仪表盘搭建

2026/7/6 19:11:14

抖音内容监控助手：告别手动刷新，让优质内容主动找你

2026/7/6 18:52:25