1
0
Fork 0
mirror of https://github.com/arangodb/kube-arangodb.git synced 2024-12-15 17:51:03 +00:00
kube-arangodb/docs/crds.md
Nikita Vaniasin 82cb7f1298
(Feature) Add generator for CRD validation schemas (#1488)
* (Feature) Add generator for CRD validation schemas

* Improve docs / log output for crd installation

* Add ability to force-update CRDs to allow testing
2023-11-15 10:20:18 +01:00

1.8 KiB

Custom resources overview

Main CRDs:

Operator manages the CustomResources based on CustomResourceDefinitions installed in your cluster.

There are different options how CustomResourceDefinitions can be created.

Deprecated options:

  • Install CRDs directly from manifests folder.
  • Install kube-arangodb-crd helm chart before installing kube-arangodb chart.
  • Install CRDs using kustomize all or crd manifests.

Recommended: Use kube-arangodb Helm chart. If you've chosen not to install CRDs automatically (--skip-crds), the operator will try to install CRDs automatically. Make sure that ServiceAccount for operator has permissions to create CustomResourceDefinitions.

To disable the automatic creation of CRDs, set enableCRDManagement=false template parameter, e.g.:

helm install --generate-name https://github.com/arangodb/kube-arangodb/releases/download/$VER/kube-arangodb-$VER.tgz --set "operator.enableCRDManagement=false"

Schema validation

Starting with v1.2.36, the schema validation is supported for all CRDs.

Schema validation can be enabled only on cluster with no CRDs installed or by upgrading your CR from one CRD version to another.

To enable creation of CRD with validation schema, pass additional args to operator command line, e.g.:

--crd.validation-schema=arangobackuppolicies.backup.arangodb.com=true --crd.validation-schema=arangodeployments.database.arangodb.com=false