operator-sdk alpha config-gen

config-gen programatically generates configuration for a controller-runtime based project using the project source code (golang) and a KubebuilderConfigGen resource file.

This is an alternative to expressing configuration as a static set of kustomize patches in the “config” directory.

config-gen may be used as a standalone command run against a file, as a kustomize transformer plugin, or as a configuration function (e.g. kpt).

Following is an example KubebuilderConfigGen resource used by config-gen:

kubebuilderconfiggen.yaml

this resource describes how to generate configuration for a controller-runtime

based project

apiVersion: kubebuilder.sigs.k8s.io/v1alpha1 kind: KubebuilderConfigGen metadata: name: my-project-name spec: controllerManager: image: my-org-name/my-project-name:v0.1.0

If this file was at the project source root, config-gen could be used to emit configuration using:

The KubebuilderConfigGen resource has the following fields:

apiVersion: kubebuilder.sigs.k8s.io/v1alpha1 kind: KubebuilderConfigGen

metadata: # name of the project. used in various resource names. # required name: project-name

  2. controllerManager:
  3.   # image to run
  4.   image: my-org/my-project:v0.1.0
  6.   # if set, use component config for the controller-manager
  7.   # optional
  8.   componentConfig:
  9.     # use component config
  10.     enable: true
  12.     # path to component config to put into a ConfigMap
  13.     configFilepath: ./path/to/componentconfig.yaml
  15.   # configure how metrics are exposed
  16.   metrics:
  17.     # disable the auth proxy required for scraping metrics
  18.     # disable: false
  20.     # generate prometheus ServiceMonitor resource
  21.     enableServiceMonitor: true
  23. # configure how webhooks are generated
  24. # optional -- defaults to not generating webhook configuration
  25. webhooks:
  26.   # enable will cause webhook config to be generated
  27.   enable: true
  29.   enableConversion:
  30.     # key is the name of the CRD
  31.     "bars.example.my.domain": true
  33.   # configures where to get the certificate used for webhooks
  35.   certificateSource:
  36.     # type of certificate source
  37.     # one of ["certManager", "dev", "manual"] -- defaults to "manual"
  38.     # certManager: certmanager is used to manage certificates -- requires CertManager to be installed
  39.     # dev: certificate is generated and wired into resources
  40.     # manual: no certificate is generated or wired into resources
  41.     type: "dev"
  43.     # options for a dev certificate -- requires "dev" as the type
  44.     devCertificate:
  45.       duration: 1h
  1. #
  2. # As command
  3. #
  4. # create the kubebuilderconfiggen.yaml at project root
  5. cat > kubebuilderconfiggen.yaml <<EOF
  6. apiVersion: kubebuilder.sigs.k8s.io/v1alpha1
  7.   kind: KubebuilderConfigGen
  8.   metadata:
  9.     name: project
  10.   spec:
  11.     controllerManager
  12.       image: org/project:v0.1.0
  13. EOF
  15. # run the config generator
  16. kubebuilder alpha config-gen kubebuilderconfiggen.yaml
  18. # run the config generator and apply
  19. kubebuilder alpha config-gen kubebuilderconfiggen.yaml | kubectl apply -f -
  21. kubebuilder alpha config-gen kubebuilderconfiggen.yaml patch1.yaml patch2.yaml
  23. #
  24. # As Kustomize plugin
  25. # this allows using config-gen with kustomize features such as patches, commonLabels,
  26. # commonAnnotations, resources, configMapGenerator and other transformer plugins.
  27. #
  29. # install the latest kustomize
  30. GO111MODULE=on go get sigs.k8s.io/kustomize/kustomize/v4
  32. # install the command as a kustomize plugin
  33. kubebuilder alpha config-gen install-as-plugin
  35. # create the kustomization.yaml containing the KubebuilderConfigGen resource
  36. cat > kustomization.yaml <<EOF
  37. apiVersion: kustomize.config.k8s.io/v1beta1
  38. kind: Kustomization
  39. transformers:
  40. - |-
  41.   apiVersion: kubebuilder.sigs.k8s.io
  42.   kind: KubebuilderConfigGen
  43.   metadata:
  44.     name: my-project
  45.   spec:
  46.     controllerManager:
  47.       image: my-org/my-project:v0.1.0
  48. EOF
  50. # generate configuration from kustomize > v4.0.0
  51. kustomize build --enable-alpha-plugins .
  53. # generate configuration from kustomize <= v4.0.0
  54. kustomize build --enable_alpha_plugins .
  1.       --plugins strings   plugin keys to be used for this subcommand execution