Files
kamaji/charts/kamaji-crds
Matteo Ruina b40428825d feat: add ObservedGeneration (#1069)
* feat: add ObservedGeneration to all status types

Add ObservedGeneration field to DataStoreStatus, KubeconfigGeneratorStatus,
and TenantControlPlaneStatus to track which generation the controller has
processed. This enables clients and tools like kstatus to determine if the
controller has reconciled the latest spec changes.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* refactor: follow Cluster API pattern for ObservedGeneration

Move ObservedGeneration setting for TenantControlPlane from intermediate
status updates to the final successful reconciliation completion. This
follows Cluster API conventions where ObservedGeneration indicates the
controller has fully processed the given generation.

Previously, ObservedGeneration was set on every status update during
resource processing, which could mislead clients into thinking the spec
was fully reconciled when the controller was still mid-reconciliation
or had hit a transient error.

Now:
- DataStore: Sets ObservedGeneration before single status update (simple controller)
- KubeconfigGenerator: Sets ObservedGeneration before single status update (simple controller)
- TenantControlPlane: Sets ObservedGeneration only after ALL resources processed successfully

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* test: verify ObservedGeneration equals Generation after reconciliation

Add assertion to e2e test to verify that status.observedGeneration
equals metadata.generation after a TenantControlPlane is successfully
reconciled.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* chore: regenerate CRDs with ObservedGeneration field

Run make crds to regenerate CRDs with the new ObservedGeneration
field in status types.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Run make manifests

* Run make apidoc

* Remove rbac role

* Remove webhook manifest

---------

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-03 12:18:46 +01:00
..
2026-02-03 12:18:46 +01:00

kamaji-crds

Version: 0.0.0+latest Type: application AppVersion: latest

Kamaji is the Hosted Control Plane Manager for Kubernetes.

Maintainers

Name Email Url
Dario Tranchitella dario@tranchitella.eu https://clastix.io
Adriano Pezzuto me@bsctl.io https://clastix.io

Source Code

Kamaji Custom Resource Definitions packaged as Helm Charts.

How to use this chart

Add clastix Helm repository:

helm repo add clastix https://clastix.github.io/charts

Install the Chart with the release name kamaji-crds:

helm upgrade --install --namespace kamaji-system --create-namespace kamaji-crds clastix/kamaji-crds

Show the status:

helm status kamaji-crds -n kamaji-system

Upgrade the Chart

helm upgrade kamaji-crds -n kamaji-system clastix/kamaji-crds

Uninstall the Chart

helm uninstall kamaji-crds -n kamaji-system

Customize the installation

There are two methods for specifying overrides of values during Chart installation: --values and --set.

The --values option is the preferred method because it allows you to keep your overrides in a YAML file, rather than specifying them all on the command line. Create a copy of the YAML file values.yaml and add your overrides to it.

Specify your overrides file when you install the Chart:

helm upgrade kamaji-crds --install --namespace kamaji-system --create-namespace clastix/kamaji-crds --values myvalues.yaml

The values in your overrides file myvalues.yaml will override their counterparts in the Chart's values.yaml file. Any values in values.yaml that werent overridden will keep their defaults.

If you only need to make minor customizations, you can specify them on the command line by using the --set option. For example:

helm upgrade kamaji-crds --install --namespace kamaji-system --create-namespace clastix/kamaji-crds --set kamajiCertificateName=kamaji

Values

Key Type Default Description
fullnameOverride string "" Overrides the full name of the resources created by the chart.
kamajiCertificateName string "kamaji-serving-cert" The cert-manager Certificate resource name, holding the Certificate Authority for webhooks.
kamajiNamespace string "kamaji-system" The namespace where Kamaji has been installed: required to inject the Certificate Authority for cert-manager.
kamajiService string "kamaji-webhook-service" The Kamaji webhook Service name.
nameOverride string "" Overrides the name of the chart for resource naming purposes.