You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: 003-streamshub-console-helm.md
+4-3Lines changed: 4 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -49,12 +49,13 @@ Chart versioning will be **independent from the operator version**.
49
49
50
50
Chart and operator versions will naturally diverge over time - for example, when a chart only fix is needed without an operator release.
51
51
Starting from an independent versioning scheme avoids confusion from the outset.
52
+
Chart versioning will follow the format <CONSOLE_VERSION>-<CHART_PATCH> (e.g. 1.0.0 for the initial release, 1.0.0-1 if a chart-only fix follows).
53
+
This keeps the chart version anchored to the specific operator release it targets, while still allowing chart only patch releases without requiring an operator release.
52
54
A clear mapping between chart versions and compatible operator versions will be maintained on the release page and in the documentation.
53
55
54
56
## CRD management
55
57
56
58
CRD lifecycle management in Helm has known limitations that need to be addressed explicitly.
57
-
Understanding these is important both for the standalone chart and for potential future use as a subchart.
58
59
59
60
### The core CRDs problem
60
61
@@ -63,9 +64,9 @@ Helm's built-in CRD support - placing CRDs in the `crds/` directory - has two si
63
64
1.**CRDs in `crds/` are not upgraded during `helm upgrade`**. This creates version drift risk: a new operator release may depend on an updated CRD schema or a new stored version that is not present in the cluster after a routine upgrade.
64
65
2.**CRDs in subcharts are silently skipped**. If this chart is later used as a subchart in an umbrella chart, Helm only processes CRDs from the top-level chart's `crds/` directory. Any CRDs in subchart `crds/` directories are silently ignored on install, meaning the Console CRDs would not be present when the operator tries to reconcile.
65
66
66
-
### Recommended approach
67
+
### Solution
67
68
68
-
The recommended approach is the **`crds/` directory pattern**, consistent with how Strimzi manages its CRDs.
69
+
CRDs will be managed using the **`crds/` directory pattern**, consistent with how Strimzi manages its CRDs.
69
70
70
71
CRDs are installed automatically on `helm install`. The CRD upgrade limitation must be explicitly documented: users must manually apply updated CRDs before upgrading the operator chart (e.g. `kubectl apply -f crds/`).
71
72
This is the exactly same pattern Strimzi uses and is an understood trade-off in the Helm ecosystem.
0 commit comments