feat(crds): add configurable annotations

Justfile

@@ -41,12 +41,27 @@ generate-mock:
   go generate -run mockgen ./...
 
 helm-update:
+  #!/bin/bash
+  set pipefail -e
+
   rm -f helm/operator/templates/gen/*
   rm -f helm/crds/templates/crds/*
 
   kustomize build config/default --output helm/operator/templates/gen
   kustomize build config/crd --output helm/crds/templates/crds
 
+  # Patch all CRD files to add helm.sh/resource-policy and custom annotations support
+  for file in helm/crds/templates/crds/*.yaml; do
+    awk '/controller-gen.kubebuilder.io\/version:/ {
+      print
+      print "    helm.sh/resource-policy: keep"
+      print "    {{{{- with .Values.annotations }}"
+      print "    {{{{- toYaml . | nindent 4 }}"
+      print "    {{{{- end }}"
+      next
+    } 1' "$file" > "$file.tmp" && mv "$file.tmp" "$file"
+  done
+
   rm -f helm/operator/templates/gen/v1_namespace*.yaml
   rm -f helm/operator/templates/gen/apps_v1_deployment_*.yaml
   helm dependencies update ./helm/operator

config/crd/kustomization.yaml

@@ -2,32 +2,32 @@
 # since it depends on service name and namespace that are out of this kustomize package.
 # It should be run by config/default
 resources:
-  - bases/formance.com_databases.yaml
-  - bases/formance.com_stacks.yaml
-  - bases/formance.com_brokertopics.yaml
-  - bases/formance.com_gatewayhttpapis.yaml
-  - bases/formance.com_ledgers.yaml
-  - bases/formance.com_gateways.yaml
-  - bases/formance.com_auths.yaml
-  - bases/formance.com_authclients.yaml
-  - bases/formance.com_wallets.yaml
-  - bases/formance.com_orchestrations.yaml
-  - bases/formance.com_webhooks.yaml
-  - bases/formance.com_reconciliations.yaml
-  - bases/formance.com_payments.yaml
-  - bases/formance.com_searches.yaml
-  - bases/formance.com_benthosstreams.yaml
-  - bases/formance.com_benthos.yaml
-  - bases/formance.com_stargates.yaml
-  - bases/formance.com_versions.yaml
-  - bases/formance.com_settings.yaml
-  - bases/formance.com_resourcereferences.yaml
-  - bases/formance.com_brokerconsumers.yaml
-  - bases/formance.com_brokers.yaml
+- bases/formance.com_databases.yaml
+- bases/formance.com_stacks.yaml
+- bases/formance.com_brokertopics.yaml
+- bases/formance.com_gatewayhttpapis.yaml
+- bases/formance.com_ledgers.yaml
+- bases/formance.com_gateways.yaml
+- bases/formance.com_auths.yaml
+- bases/formance.com_authclients.yaml
+- bases/formance.com_wallets.yaml
+- bases/formance.com_orchestrations.yaml
+- bases/formance.com_webhooks.yaml
+- bases/formance.com_reconciliations.yaml
+- bases/formance.com_payments.yaml
+- bases/formance.com_searches.yaml
+- bases/formance.com_benthosstreams.yaml
+- bases/formance.com_benthos.yaml
+- bases/formance.com_stargates.yaml
+- bases/formance.com_versions.yaml
+- bases/formance.com_settings.yaml
+- bases/formance.com_resourcereferences.yaml
+- bases/formance.com_brokerconsumers.yaml
+- bases/formance.com_brokers.yaml
+
 #+kubebuilder:scaffold:crdkustomizeresource
 
-commonAnnotations:
-  helm.sh/resource-policy: keep
+# commonAnnotations:
 # [WEBHOOK] To enable webhook, uncomment all the sections with [WEBHOOK] prefix.
 # patches here are for enabling the conversion webhook for each CRD
 #- path: patches/webhook_in_databases.yaml

helm/crds/Chart.yaml

@@ -12,9 +12,9 @@ type: application
 # This is the chart version. This version number should be incremented each time you make changes
 # to the chart and its templates, including the app version.
 # Versions are expected to follow Semantic Versioning (https://semver.org/)
-version: "3.4.0"
+version: "3.5.0"
 # This is the version number of the application being deployed. This version number should be
 # incremented each time you make changes to the application. Versions are not expected to
 # follow Semantic Versioning. They should reflect the version the application is using.
 # It is recommended to use it with quotes.
-appVersion: v3.4.0
+appVersion: v3.5.0

helm/crds/templates/crds/apiextensions.k8s.io_v1_customresourcedefinition_authclients.formance.com.yaml

@@ -4,6 +4,9 @@ metadata:
   annotations:
     controller-gen.kubebuilder.io/version: v0.18.0
     helm.sh/resource-policy: keep
+    {{- with .Values.annotations }}
+    {{- toYaml . | nindent 4 }}
+    {{- end }}
   name: authclients.formance.com
 spec:
   group: formance.com

helm/crds/templates/crds/apiextensions.k8s.io_v1_customresourcedefinition_auths.formance.com.yaml

@@ -4,6 +4,9 @@ metadata:
   annotations:
     controller-gen.kubebuilder.io/version: v0.18.0
     helm.sh/resource-policy: keep
+    {{- with .Values.annotations }}
+    {{- toYaml . | nindent 4 }}
+    {{- end }}
   labels:
     formance.com/kind: module
   name: auths.formance.com

helm/crds/templates/crds/apiextensions.k8s.io_v1_customresourcedefinition_benthos.formance.com.yaml

@@ -4,6 +4,9 @@ metadata:
   annotations:
     controller-gen.kubebuilder.io/version: v0.18.0
     helm.sh/resource-policy: keep
+    {{- with .Values.annotations }}
+    {{- toYaml . | nindent 4 }}
+    {{- end }}
   name: benthos.formance.com
 spec:
   group: formance.com

helm/crds/templates/crds/apiextensions.k8s.io_v1_customresourcedefinition_benthosstreams.formance.com.yaml

@@ -4,6 +4,9 @@ metadata:
   annotations:
     controller-gen.kubebuilder.io/version: v0.18.0
     helm.sh/resource-policy: keep
+    {{- with .Values.annotations }}
+    {{- toYaml . | nindent 4 }}
+    {{- end }}
   name: benthosstreams.formance.com
 spec:
   group: formance.com

helm/crds/templates/crds/apiextensions.k8s.io_v1_customresourcedefinition_brokerconsumers.formance.com.yaml

@@ -4,6 +4,9 @@ metadata:
   annotations:
     controller-gen.kubebuilder.io/version: v0.18.0
     helm.sh/resource-policy: keep
+    {{- with .Values.annotations }}
+    {{- toYaml . | nindent 4 }}
+    {{- end }}
   name: brokerconsumers.formance.com
 spec:
   group: formance.com

helm/crds/templates/crds/apiextensions.k8s.io_v1_customresourcedefinition_brokers.formance.com.yaml

@@ -4,6 +4,9 @@ metadata:
   annotations:
     controller-gen.kubebuilder.io/version: v0.18.0
     helm.sh/resource-policy: keep
+    {{- with .Values.annotations }}
+    {{- toYaml . | nindent 4 }}
+    {{- end }}
   name: brokers.formance.com
 spec:
   group: formance.com

helm/crds/templates/crds/apiextensions.k8s.io_v1_customresourcedefinition_brokertopics.formance.com.yaml

@@ -4,6 +4,9 @@ metadata:
   annotations:
     controller-gen.kubebuilder.io/version: v0.18.0
     helm.sh/resource-policy: keep
+    {{- with .Values.annotations }}
+    {{- toYaml . | nindent 4 }}
+    {{- end }}
   name: brokertopics.formance.com
 spec:
   group: formance.com

helm/crds/templates/crds/apiextensions.k8s.io_v1_customresourcedefinition_databases.formance.com.yaml

@@ -4,6 +4,9 @@ metadata:
   annotations:
     controller-gen.kubebuilder.io/version: v0.18.0
     helm.sh/resource-policy: keep
+    {{- with .Values.annotations }}
+    {{- toYaml . | nindent 4 }}
+    {{- end }}
   name: databases.formance.com
 spec:
   group: formance.com

helm/crds/templates/crds/apiextensions.k8s.io_v1_customresourcedefinition_gatewayhttpapis.formance.com.yaml

@@ -4,6 +4,9 @@ metadata:
   annotations:
     controller-gen.kubebuilder.io/version: v0.18.0
     helm.sh/resource-policy: keep
+    {{- with .Values.annotations }}
+    {{- toYaml . | nindent 4 }}
+    {{- end }}
   name: gatewayhttpapis.formance.com
 spec:
   group: formance.com

helm/crds/templates/crds/apiextensions.k8s.io_v1_customresourcedefinition_gateways.formance.com.yaml

@@ -4,6 +4,9 @@ metadata:
   annotations:
     controller-gen.kubebuilder.io/version: v0.18.0
     helm.sh/resource-policy: keep
+    {{- with .Values.annotations }}
+    {{- toYaml . | nindent 4 }}
+    {{- end }}
   labels:
     formance.com/kind: module
   name: gateways.formance.com

helm/crds/templates/crds/apiextensions.k8s.io_v1_customresourcedefinition_ledgers.formance.com.yaml

@@ -4,6 +4,9 @@ metadata:
   annotations:
     controller-gen.kubebuilder.io/version: v0.18.0
     helm.sh/resource-policy: keep
+    {{- with .Values.annotations }}
+    {{- toYaml . | nindent 4 }}
+    {{- end }}
   labels:
     formance.com/kind: module
   name: ledgers.formance.com

helm/crds/templates/crds/apiextensions.k8s.io_v1_customresourcedefinition_orchestrations.formance.com.yaml

@@ -4,6 +4,9 @@ metadata:
   annotations:
     controller-gen.kubebuilder.io/version: v0.18.0
     helm.sh/resource-policy: keep
+    {{- with .Values.annotations }}
+    {{- toYaml . | nindent 4 }}
+    {{- end }}
   labels:
     formance.com/is-ee: "true"
     formance.com/kind: module

helm/crds/templates/crds/apiextensions.k8s.io_v1_customresourcedefinition_payments.formance.com.yaml

@@ -4,6 +4,9 @@ metadata:
   annotations:
     controller-gen.kubebuilder.io/version: v0.18.0
     helm.sh/resource-policy: keep
+    {{- with .Values.annotations }}
+    {{- toYaml . | nindent 4 }}
+    {{- end }}
   labels:
     formance.com/kind: module
   name: payments.formance.com

helm/crds/templates/crds/apiextensions.k8s.io_v1_customresourcedefinition_reconciliations.formance.com.yaml

@@ -4,6 +4,9 @@ metadata:
   annotations:
     controller-gen.kubebuilder.io/version: v0.18.0
     helm.sh/resource-policy: keep
+    {{- with .Values.annotations }}
+    {{- toYaml . | nindent 4 }}
+    {{- end }}
   labels:
     formance.com/is-ee: "true"
     formance.com/kind: module

helm/crds/templates/crds/apiextensions.k8s.io_v1_customresourcedefinition_resourcereferences.formance.com.yaml

@@ -4,6 +4,9 @@ metadata:
   annotations:
     controller-gen.kubebuilder.io/version: v0.18.0
     helm.sh/resource-policy: keep
+    {{- with .Values.annotations }}
+    {{- toYaml . | nindent 4 }}
+    {{- end }}
   name: resourcereferences.formance.com
 spec:
   group: formance.com

helm/crds/templates/crds/apiextensions.k8s.io_v1_customresourcedefinition_searches.formance.com.yaml

@@ -4,6 +4,9 @@ metadata:
   annotations:
     controller-gen.kubebuilder.io/version: v0.18.0
     helm.sh/resource-policy: keep
+    {{- with .Values.annotations }}
+    {{- toYaml . | nindent 4 }}
+    {{- end }}
   labels:
     formance.com/is-ee: "true"
     formance.com/kind: module

helm/crds/templates/crds/apiextensions.k8s.io_v1_customresourcedefinition_settings.formance.com.yaml

@@ -4,6 +4,9 @@ metadata:
   annotations:
     controller-gen.kubebuilder.io/version: v0.18.0
     helm.sh/resource-policy: keep
+    {{- with .Values.annotations }}
+    {{- toYaml . | nindent 4 }}
+    {{- end }}
   name: settings.formance.com
 spec:
   group: formance.com

helm/crds/templates/crds/apiextensions.k8s.io_v1_customresourcedefinition_stacks.formance.com.yaml

@@ -4,6 +4,9 @@ metadata:
   annotations:
     controller-gen.kubebuilder.io/version: v0.18.0
     helm.sh/resource-policy: keep
+    {{- with .Values.annotations }}
+    {{- toYaml . | nindent 4 }}
+    {{- end }}
   name: stacks.formance.com
 spec:
   group: formance.com

helm/crds/templates/crds/apiextensions.k8s.io_v1_customresourcedefinition_stargates.formance.com.yaml

@@ -4,6 +4,9 @@ metadata:
   annotations:
     controller-gen.kubebuilder.io/version: v0.18.0
     helm.sh/resource-policy: keep
+    {{- with .Values.annotations }}
+    {{- toYaml . | nindent 4 }}
+    {{- end }}
   labels:
     formance.com/kind: module
   name: stargates.formance.com

helm/crds/templates/crds/apiextensions.k8s.io_v1_customresourcedefinition_versions.formance.com.yaml

@@ -4,6 +4,9 @@ metadata:
   annotations:
     controller-gen.kubebuilder.io/version: v0.18.0
     helm.sh/resource-policy: keep
+    {{- with .Values.annotations }}
+    {{- toYaml . | nindent 4 }}
+    {{- end }}
   name: versions.formance.com
 spec:
   group: formance.com

helm/crds/templates/crds/apiextensions.k8s.io_v1_customresourcedefinition_wallets.formance.com.yaml

@@ -4,6 +4,9 @@ metadata:
   annotations:
     controller-gen.kubebuilder.io/version: v0.18.0
     helm.sh/resource-policy: keep
+    {{- with .Values.annotations }}
+    {{- toYaml . | nindent 4 }}
+    {{- end }}
   labels:
     formance.com/is-ee: "true"
     formance.com/kind: module

helm/crds/templates/crds/apiextensions.k8s.io_v1_customresourcedefinition_webhooks.formance.com.yaml

@@ -4,6 +4,9 @@ metadata:
   annotations:
     controller-gen.kubebuilder.io/version: v0.18.0
     helm.sh/resource-policy: keep
+    {{- with .Values.annotations }}
+    {{- toYaml . | nindent 4 }}
+    {{- end }}
   labels:
     formance.com/is-ee: "true"
     formance.com/kind: module

helm/crds/values.yaml

@@ -0,0 +1 @@
+annotations: {}

helm/operator/Chart.lock

@@ -1,6 +1,6 @@
 dependencies:
 - name: operator-crds
   repository: file://../crds
-  version: 3.4.0
-digest: sha256:f9702cf4ebf8f0a7f098b5be864571bee7180b68fe3103eafcca4d9af397a5b8
-generated: "2026-01-27T10:21:01.910344+01:00"
+  version: 3.5.0
+digest: sha256:ddf3ae005c2951b27c1ef968ac19eef153cd3070b9ed53d407c62d0a6dd92ba0
+generated: "2026-02-03T12:18:41.125807+01:00"

helm/operator/Chart.yaml

@@ -12,12 +12,12 @@ type: application
 # This is the chart version. This version number should be incremented each time you make changes
 # to the chart and its templates, including the app version.
 # Versions are expected to follow Semantic Versioning (https://semver.org/)
-version: "3.4.0"
+version: "3.5.0"
 # This is the version number of the application being deployed. This version number should be
 # incremented each time you make changes to the application. Versions are not expected to
 # follow Semantic Versioning. They should reflect the version the application is using.
 # It is recommended to use it with quotes.
-appVersion: "v3.4.0"
+appVersion: "v3.5.0"
 dependencies:
 - name: operator-crds
   version: "3.X"