Skip to content

Popular Kubernetes CRDs (CustomResourceDefinition) in JSON schema format.

License

Notifications You must be signed in to change notification settings

datreeio/CRDs-catalog

Folders and files

NameName
Last commit message
Last commit date

Latest commit

43e4407 Â· Feb 25, 2025
Jan 13, 2025
Jan 13, 2025
Jun 1, 2024
Sep 5, 2024
Jan 8, 2025
Jul 4, 2023
Jan 27, 2025
Dec 14, 2023
Aug 26, 2023
Mar 21, 2023
Sep 18, 2024
Oct 21, 2024
Jan 23, 2025
Feb 12, 2023
Feb 6, 2025
Sep 5, 2024
Jul 4, 2023
Sep 5, 2024
Jan 23, 2025
Apr 7, 2023
Sep 18, 2024
Sep 17, 2024
Oct 6, 2024
Sep 5, 2024
Jul 4, 2023
Nov 10, 2024
Nov 10, 2024
Aug 6, 2023
Jan 22, 2024
Nov 20, 2024
Jun 23, 2022
Jan 23, 2025
Jun 1, 2024
Sep 18, 2024
Sep 5, 2022
Mar 21, 2023
Jun 4, 2024
Mar 21, 2023
Sep 18, 2024
Sep 5, 2024
Jan 23, 2025
Jan 23, 2025
Jan 23, 2025
Sep 5, 2024
Jan 23, 2025
Sep 5, 2024
Jan 23, 2025
Jun 20, 2024
Jun 20, 2024
Mar 24, 2023
Mar 20, 2023
Aug 28, 2024
Dec 19, 2024
Jan 27, 2025
Jul 6, 2024
Jan 23, 2025
Dec 12, 2024
Nov 19, 2024
Oct 21, 2024
Sep 5, 2024
Jan 23, 2025
Feb 9, 2025
Jul 4, 2023
Jun 20, 2024
Sep 5, 2024
Jun 20, 2024
Sep 5, 2024
Sep 5, 2024
Jan 23, 2025
Jul 6, 2024
Sep 5, 2024
Jul 4, 2023
Jul 4, 2023
Mar 21, 2023
Mar 21, 2023
Aug 6, 2024
Jan 23, 2025
Jun 22, 2024
Jun 20, 2024
Feb 12, 2023
Jan 23, 2025
Sep 5, 2024
Jan 23, 2025
Aug 28, 2024
Jun 20, 2024
Nov 24, 2024
Dec 9, 2024
Jun 20, 2024
May 22, 2023
May 22, 2023
Jan 23, 2025
Feb 6, 2025
Jan 23, 2025
Jan 23, 2025
Jun 20, 2024
Jun 20, 2024
Sep 5, 2024
Sep 5, 2024
Jun 4, 2023
Sep 5, 2024
Jun 1, 2024
Sep 5, 2024
Jan 23, 2025
Jan 23, 2025
Feb 12, 2023
Jun 20, 2024
Jan 23, 2025
Sep 5, 2024
Jul 29, 2024
Sep 18, 2024
Dec 4, 2024
Dec 14, 2023
Jul 4, 2023
Jul 4, 2023
Jun 20, 2024
Jun 20, 2024
Feb 2, 2025
Jul 4, 2023
Jun 1, 2024
Sep 18, 2024
Feb 2, 2025
Jul 4, 2023
Feb 12, 2023
Sep 18, 2024
Sep 5, 2024
Jan 23, 2025
Jul 4, 2023
Oct 6, 2024
Jun 22, 2024
Feb 2, 2025
Nov 11, 2024
Jun 22, 2024
Aug 2, 2024
Nov 10, 2024
Sep 5, 2024
Sep 5, 2024
Sep 5, 2024
Sep 5, 2024
Sep 5, 2024
Jan 23, 2025
Dec 17, 2024
Nov 11, 2024
Oct 6, 2024
Oct 6, 2024
Feb 23, 2025
Jun 20, 2024
Nov 19, 2024
Feb 19, 2025
Feb 12, 2023
Nov 11, 2024
Aug 1, 2023
Jun 20, 2024
Jan 23, 2025
Feb 12, 2023
Feb 15, 2025
Feb 12, 2023
Feb 19, 2025
Jan 23, 2025
Jun 1, 2024
Jan 2, 2025
Sep 1, 2024
Jan 23, 2025
Jul 4, 2023
Jun 20, 2024
Sep 5, 2024
Jun 4, 2024
Dec 23, 2024
Oct 26, 2023
Mar 21, 2023
Aug 18, 2024
Jul 17, 2022
Aug 28, 2024
Feb 12, 2025
Dec 14, 2023
Jun 22, 2023
Jan 30, 2025
Nov 10, 2024
Aug 2, 2024
Jul 4, 2023
Aug 12, 2024
Aug 18, 2024
Aug 18, 2024
Jun 4, 2024
Sep 18, 2024
Jul 4, 2023
Jan 23, 2025
Jul 4, 2023
Jul 17, 2022
Feb 9, 2025
Jun 4, 2024
Nov 11, 2024
Jul 4, 2023
Nov 24, 2024
Oct 21, 2024
Oct 21, 2024
Jan 23, 2025
Nov 19, 2024
Sep 18, 2024
Jan 13, 2025
Sep 18, 2024
Jan 23, 2025
Jul 4, 2023
Mar 2, 2023
Feb 12, 2025
Sep 5, 2024
Jul 6, 2024
Jan 23, 2025
Feb 25, 2025
Jun 21, 2023
Jul 4, 2023
Jun 22, 2024
Jun 6, 2024
Jun 1, 2024
Jan 23, 2025
Jul 4, 2023
Dec 23, 2024
Feb 2, 2025
Dec 9, 2024
Sep 5, 2024
Jun 20, 2024
Jan 23, 2025
Sep 5, 2024
Jun 4, 2024
Feb 21, 2025
Dec 14, 2023
Jun 6, 2024
Jul 4, 2023
Jul 6, 2024
Dec 8, 2024
Jan 27, 2024
Oct 23, 2024
Feb 20, 2025
Jan 27, 2024
Jul 4, 2023
Sep 5, 2024
Jan 23, 2025
Sep 5, 2024
Feb 12, 2023
Jun 4, 2023
Sep 18, 2024
Jul 4, 2023
Feb 6, 2025
Oct 26, 2023
Feb 19, 2025
Nov 24, 2024
Feb 22, 2025
Jun 1, 2024
Feb 12, 2025
Jan 23, 2025
Jan 23, 2025
Jun 20, 2024
Jul 4, 2023
Aug 11, 2024
Feb 2, 2025
Jun 20, 2024
Sep 5, 2024
Sep 15, 2024
Jul 16, 2024
Apr 7, 2023
Feb 12, 2023
Oct 26, 2023
Jul 4, 2023
Sep 16, 2024
Jan 23, 2025
Jun 20, 2024
Nov 24, 2024
Jul 4, 2023
Jan 23, 2025
Mar 21, 2023
Jul 4, 2023
Jul 4, 2023
Jan 27, 2024
Jan 23, 2025
Oct 30, 2022
Feb 6, 2025
Jun 5, 2024
Jun 1, 2024
Jan 23, 2025
Feb 2, 2025
Sep 5, 2024
Jun 20, 2024
Jun 20, 2024
Dec 4, 2024
Sep 5, 2024
Sep 19, 2024
Jul 4, 2023
Mar 2, 2023
Sep 5, 2024
Jan 8, 2023
Jul 4, 2023
Jan 2, 2025
Jun 20, 2024
Jan 23, 2025
Oct 26, 2023
Sep 28, 2022
Jan 23, 2025
Jul 4, 2023
Sep 18, 2024
Jun 22, 2024
Sep 16, 2024
Sep 5, 2024
Jun 23, 2024
Jun 22, 2024
Sep 5, 2024
Feb 2, 2025
Jun 22, 2024
Jun 6, 2024
Feb 12, 2025
Mar 20, 2023
Jan 23, 2025
Dec 11, 2022
Nov 24, 2024
Dec 23, 2024
Jul 6, 2024
Oct 26, 2023
Feb 2, 2025
Jan 23, 2025
Dec 14, 2023
Jun 20, 2024
Feb 2, 2025
Oct 6, 2024
Sep 5, 2024
Jan 23, 2025
May 17, 2022
May 18, 2022
Mar 1, 2022
Jul 18, 2023
Apr 7, 2023

Repository files navigation

CRDs Catalog

This repository aggregates hundreds of popular Kubernetes CRDs (CustomResourceDefinition) in JSON schema format. These schemas can be used by various tools such as Datree, Kubeconform and Kubeval, as an alternative to kubectl --dry-run, to perform validation on custom (and native) Kubernetes resources.

Running Kubernetes schema validation checks helps apply the "shift-left approach" on machines without giving them access to your cluster (e.g. locally or on CI).

How to use the schemas in the catalog

Datree

datree test [MANIFEST]

Kubeconform

kubeconform -schema-location default -schema-location 'https://raw.githubusercontent.com/datreeio/CRDs-catalog/main/{{.Group}}/{{.ResourceKind}}_{{.ResourceAPIVersion}}.json' [MANIFEST]

kubeval

Only supported with the CRD Extractor

👉 If you encounter custom resources that are not part of the catalog, or you want to validate the schemas in an air-gapped environment, use the CRD Extractor.


CRD Extractor

This repository also contains a handy utility that extracts all CRDs from a cluster and converts them to JSON schema.

What does this utility do?

  1. Checks that the prerequisites are installed.
  2. Extracts your CRDs from your cluster using kubectl.
  3. Downloads a script from the kubeconform repo that converts your CRDs from openAPI to JSON schema.
  4. Runs the script, and saves the output to your machine under $HOME/.datree/crdSchemas/

Supported Platforms

This utility supports MacOS and Linux.

Prerequisites

The following programs are required to be installed on the machine running this utility:

Usage

To use the CRD Extractor:

  1. Download the latest release from this repository.
  2. Extract, and run the utility:
./crd-extractor.sh

image


Shifting left CRD validation - Video by Datree


Contributing CRDs to the catalog

If the catalog is missing public custom resources (CRs) that you would like to automatically validate using these tools, you can open an issue or use the CRD Extractor to add the schemas to this repository by creating a pull request.

Resources