kubernetes-configuration

README

kubernetes-configuration

This repository holds the API definitions for Kong's Kubernetes configuration.

👷 🚧 This is currently a work in progress which is heavily based on Kong's Ingress Controller CRDs Before KIC starts using these CRDs this repo should contain only additive, non-breaking changes on top of KIC's types.

Repository structure

• api/ directory contains Go types that are the source for generating
  • pkg/clientset: Go clientsets for users who want to interact with Kong's Kubernetes configuration in Go
  • config/crd: Kubernetes CRDs for Kong configuration
• test/ directory contains Go tests
  • test/crdsvalidation directory contains Go tests which perform operations against a live Kubernetes cluster, testing CEL rules set on API types
  • test/unit directory contains Go unit tests for generated Go types
• docs/ directory contains generated API reference markdown files

Install CRDs

In order to install the CRDs from this repo:

kustomize build github.com/kong/kubernetes-configuration/config/crd | kubectl apply -f -

Generate code

In order to run code generation in this repo you can use make generate.

Adding new CRDs

When you add a new CRD make sure to

• Add it to CRD kustomization.yaml
• Add unit tests in test/unit
• Add CRD validation tests in test/crdsvalidation
• If this CRD is meant to have Konnect helpers functions generated for it, add it in konnect-funcs supported type list.