crds-catalog/README.md
Robert Kaussow 9621e23cb1
All checks were successful
continuous-integration/drone/push Build is passing
docs: use multi-line syntax for kubeconform example
2023-12-07 12:00:23 +01:00

26 lines
1.3 KiB
Markdown

# crds-catalog
[![Build Status](https://img.shields.io/drone/build/infra/crds-catalog?logo=drone&server=https%3A%2F%2Fdrone.rknet.org)](https://drone.rknet.org/infra/crds-catalog)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?label=license)](LICENSE)
This repository to aggregatepopular Kubernetes CRDs (CustomResourceDefinition) in JSON schema format. These schemas can be used by various tools such as Datree, Kubeconform and Kubeval to perform validation on custom (and native) Kuberentes 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).
The project is inspired by [Datree's CRDs-catalog](https://github.com/datreeio/CRDs-catalog) and was created to manage CRDs required for my own Kubernetes deployments.
## Usage
Schemes are generated by the CI and automatically pushed to the `catalog` branch.
### Kubeconform
```Shell
kubeconform \
-schema-location default \
-schema-location 'https://gitea.rknet.org/infra/crds-catalog/raw/branch/catalog/{{.Group}}/{{.ResourceKind}}_{{.ResourceAPIVersion}}.json' \
<path/to/manifest.yaml>
```
## License
This project is licensed under the MIT License - see the [LICENSE](https://github.com/ansible/galaxy/blob/main/LICENSE) file for details.