operator: implement roundtripping conversion of v1alpha3

This commit adds the initial set of conversion routines to support
roundtripping all valid configurations of the v1alpha3 CR through the v1alpha2
CR.

To aid in the development and testing of the conversion routines, the
`exhaustruct` linter has been enabled on files ending in `_conversion.go`. It
requires all fields to be explicitly declared which will prevent future
additions to either CR from causing regressions.

It should be noted that v1alpha2 can NOT be roundtripped. Therefore the
v1alpha3 CRD can not be _safely_ enabled.

Future work will:
- Improve user facing documentation of all fields
- Support roundtripping v1alpha2 through v1alpha3
- (Potentially) refactor conversion to make use of the conversion-gen tool.

Author: chrisseto

.golangci.yml

@@ -20,7 +20,7 @@ linters:
   default: none
   enable:
   - depguard
-#  - errcheck
+  - exhaustruct
   - gosec
   - govet
   - importas
@@ -52,6 +52,14 @@ linters:
           - pkg: "^github.com/redpanda-data/redpanda-operator/charts$"
             desc: 'import specific charts, the overarching charts module is now deprecated'
 
+    exhaustruct:
+      # The default is to include all structs. To disable we add a regexp that
+      # doesn't match anything.
+      include:
+      - '^github.com/redpanda-data/redpanda-operator/operator/api/redpanda/v1alpha3\..*'
+      - '^github.com/redpanda-data/redpanda-operator/operator/api/redpanda/v1alpha2\..*'
+      exclude: []
+
     gosec:
       excludes:
       - G115 # integer overflows aren't super likely to be a problem for us and we're really just at the mercy of the APIs we use.
@@ -104,3 +112,9 @@ linters:
       - gosec
       - wrapcheck
       path: '(.+)_test\.go'
+    # We're primarily concerned about conversion routines supplying a value for each possible field.
+    # The linter doesn't support selective enablement so we're simply ignoring
+    # all reports outside of conversion code.
+    - linters:
+      - exhaustruct
+      path-except: '_conversion\.go'

acceptance/go.mod

@@ -213,7 +213,7 @@ require (
 	github.com/redpanda-data/console/backend v0.0.0-20240303221210-05d5d9e85f20 // indirect
 	github.com/redpanda-data/redpanda-operator/charts/connectors v0.0.0-20250407180246-dc814fb6b3b8 // indirect
 	github.com/redpanda-data/redpanda-operator/charts/console v0.0.0-20250407180246-dc814fb6b3b8 // indirect
-	github.com/redpanda-data/redpanda-operator/charts/redpanda/v5 v5.10.3-0.20250528165859-05efa25f40a6 // indirect
+	github.com/redpanda-data/redpanda-operator/charts/redpanda/v5 v5.10.3-0.20250530212252-f020b773160c // indirect
 	github.com/redpanda-data/redpanda-operator/gotohelm v1.1.0 // indirect
 	github.com/redpanda-data/redpanda/src/go/rpk v0.0.0-20240827155712-244863ea0ae8 // indirect
 	github.com/rivo/uniseg v0.4.7 // indirect

acceptance/go.sum

@@ -749,8 +749,8 @@ github.com/redpanda-data/redpanda-operator/charts/console v0.0.0-20250407180246-
 github.com/redpanda-data/redpanda-operator/charts/console v0.0.0-20250407180246-dc814fb6b3b8/go.mod h1:Sof2HY8U+RLesHJInGLoqhUMzN8iN8gUHXALbROsew8=
 github.com/redpanda-data/redpanda-operator/charts/console/v3 v3.1.0 h1:6jvBn+Xr1+62BEFSHoKxayRM/Xt9hp6O5nhnE368ge4=
 github.com/redpanda-data/redpanda-operator/charts/console/v3 v3.1.0/go.mod h1:y/8tR/cBC11uDPvjosxT8DAxnuSlPWtEzVYeCAqa4K4=
-github.com/redpanda-data/redpanda-operator/charts/redpanda/v5 v5.10.3-0.20250528165859-05efa25f40a6 h1:L47y1LcYVimapky8oXc58pQ9+PFnl8sxTfGKfb7zAUc=
-github.com/redpanda-data/redpanda-operator/charts/redpanda/v5 v5.10.3-0.20250528165859-05efa25f40a6/go.mod h1:33q+FpNfYgIVnV5EOPTKWk2udlG6JoYi0UqLX8YHU/E=
+github.com/redpanda-data/redpanda-operator/charts/redpanda/v5 v5.10.3-0.20250530212252-f020b773160c h1:o6uYfqPWRUDRPl5xGj5jf38oCUYFo0z/loOQ39Fwu4w=
+github.com/redpanda-data/redpanda-operator/charts/redpanda/v5 v5.10.3-0.20250530212252-f020b773160c/go.mod h1:33q+FpNfYgIVnV5EOPTKWk2udlG6JoYi0UqLX8YHU/E=
 github.com/redpanda-data/redpanda-operator/gotohelm v1.1.0 h1:IV2Ic66JDKPtCnNU4Kn1naJlzZmhl0izRj17qgTCo20=
 github.com/redpanda-data/redpanda-operator/gotohelm v1.1.0/go.mod h1:usCpPzzzhgtPrRTiUQOzFqGmukce8U0SrzEeX2ONDFE=
 github.com/redpanda-data/redpanda/src/go/rpk v0.0.0-20240827155712-244863ea0ae8 h1:uTQKqF8UPNxYxKBJ11VlG6Vt2l9ctkkeXsmmjHUSUG4=

acceptance/steps/scaling.go

@@ -13,7 +13,7 @@ import (
 	redpandav1alpha2 "github.com/redpanda-data/redpanda-operator/operator/api/redpanda/v1alpha2"
 )
 
-func iCreateABasicClusterWithNodes(ctx context.Context, t framework.TestingT, clusterName string, nodeCount int) {
+func iCreateABasicClusterWithNodes(ctx context.Context, t framework.TestingT, clusterName string, nodeCount int32) {
 	key := t.ResourceKey(clusterName)
 	image := &redpandav1alpha2.RedpandaImage{
 		Tag:        ptr.To("dev"),
@@ -66,7 +66,7 @@ func iCreateABasicClusterWithNodes(ctx context.Context, t framework.TestingT, cl
 	})
 }
 
-func iScaleToNodes(ctx context.Context, t framework.TestingT, clusterName string, nodeCount int) {
+func iScaleToNodes(ctx context.Context, t framework.TestingT, clusterName string, nodeCount int32) {
 	var cluster redpandav1alpha2.Redpanda
 	var err error
 

charts/redpanda/go.mod

@@ -12,7 +12,7 @@ require (
 	github.com/quasilyte/go-ruleguard/dsl v0.3.22
 	github.com/redpanda-data/common-go/rpadmin v0.1.14-0.20250425125657-8ab73f3ad62e
 	github.com/redpanda-data/redpanda-operator/charts/console/v3 v3.1.0
-	github.com/redpanda-data/redpanda-operator/gotohelm v0.0.0-20250327164623-c3883a149a17
+	github.com/redpanda-data/redpanda-operator/gotohelm v1.1.0
 	github.com/redpanda-data/redpanda-operator/operator v0.0.0-20250528175436-e8cca0053dc6
 	github.com/redpanda-data/redpanda-operator/pkg v0.0.0-20250528175436-e8cca0053dc6
 	github.com/redpanda-data/redpanda/src/go/rpk v0.0.0-20240827155712-244863ea0ae8

charts/redpanda/go.sum

@@ -537,8 +537,8 @@ github.com/redpanda-data/common-go/secrets v0.1.3 h1:VRo+OFS4Zgb2UMvwcIuUujdMhAP
 github.com/redpanda-data/common-go/secrets v0.1.3/go.mod h1:WjUU/5saSXwItZx6veFOGbQZUgPQz4MQ65z22y0Ky84=
 github.com/redpanda-data/redpanda-operator/charts/console/v3 v3.1.0 h1:6jvBn+Xr1+62BEFSHoKxayRM/Xt9hp6O5nhnE368ge4=
 github.com/redpanda-data/redpanda-operator/charts/console/v3 v3.1.0/go.mod h1:y/8tR/cBC11uDPvjosxT8DAxnuSlPWtEzVYeCAqa4K4=
-github.com/redpanda-data/redpanda-operator/gotohelm v0.0.0-20250327164623-c3883a149a17 h1:aARsVhc9XYhrC/aeJpDHnel8QicHbo6BtZzbhqe33UY=
-github.com/redpanda-data/redpanda-operator/gotohelm v0.0.0-20250327164623-c3883a149a17/go.mod h1:QkZMtADhtFgS5Bixk6N931yazp9mBtQ7VAJ5gWPrsgg=
+github.com/redpanda-data/redpanda-operator/gotohelm v1.1.0 h1:IV2Ic66JDKPtCnNU4Kn1naJlzZmhl0izRj17qgTCo20=
+github.com/redpanda-data/redpanda-operator/gotohelm v1.1.0/go.mod h1:usCpPzzzhgtPrRTiUQOzFqGmukce8U0SrzEeX2ONDFE=
 github.com/redpanda-data/redpanda-operator/operator v0.0.0-20250528175436-e8cca0053dc6 h1:7ZGF97PVyQ5yst9mvcmnllYCfMgRSts/1XYgh84Q6Pw=
 github.com/redpanda-data/redpanda-operator/operator v0.0.0-20250528175436-e8cca0053dc6/go.mod h1:C4oYf3EfNvIhrNnRqciGojBoeiBm06hO8QrquzYJFG4=
 github.com/redpanda-data/redpanda-operator/pkg v0.0.0-20250528175436-e8cca0053dc6 h1:3j3DgUcLJIDXnQYv+bOt2GShkTq0LZlFzFypSaZFUMc=

gen/go.mod

@@ -88,6 +88,7 @@ require (
 	github.com/cespare/xxhash/v2 v2.3.0 // indirect
 	github.com/chai2010/gettext-go v1.0.2 // indirect
 	github.com/cisco-open/k8s-objectmatcher v1.9.0 // indirect
+	github.com/cloudhut/common v0.10.0 // indirect
 	github.com/cockroachdb/logtags v0.0.0-20230118201751-21c54148d20b // indirect
 	github.com/cockroachdb/redact v1.1.5 // indirect
 	github.com/containerd/containerd v1.7.24 // indirect
@@ -112,6 +113,7 @@ require (
 	github.com/fsnotify/fsnotify v1.9.0 // indirect
 	github.com/fxamacker/cbor/v2 v2.8.0 // indirect
 	github.com/getsentry/sentry-go v0.27.0 // indirect
+	github.com/go-chi/chi/v5 v5.0.12 // indirect
 	github.com/go-errors/errors v1.5.1 // indirect
 	github.com/go-gorp/gorp/v3 v3.1.0 // indirect
 	github.com/go-logr/logr v1.4.2 // indirect
@@ -154,6 +156,7 @@ require (
 	github.com/json-iterator/go v1.1.12 // indirect
 	github.com/kballard/go-shellquote v0.0.0-20180428030007-95032a82bc51 // indirect
 	github.com/klauspost/compress v1.18.0 // indirect
+	github.com/knadh/koanf v1.5.0 // indirect
 	github.com/kr/pretty v0.3.1 // indirect
 	github.com/kr/text v0.2.0 // indirect
 	github.com/kylelemons/godebug v1.1.0 // indirect
@@ -173,6 +176,7 @@ require (
 	github.com/mitchellh/go-ps v1.0.0 // indirect
 	github.com/mitchellh/go-wordwrap v1.0.1 // indirect
 	github.com/mitchellh/hashstructure v1.1.0 // indirect
+	github.com/mitchellh/mapstructure v1.5.0 // indirect
 	github.com/mitchellh/reflectwalk v1.0.2 // indirect
 	github.com/moby/locker v1.0.1 // indirect
 	github.com/moby/spdystream v0.5.0 // indirect
@@ -198,6 +202,10 @@ require (
 	github.com/redpanda-data/common-go/net v0.1.0 // indirect
 	github.com/redpanda-data/common-go/rpadmin v0.1.14-0.20250425125657-8ab73f3ad62e // indirect
 	github.com/redpanda-data/common-go/secrets v0.1.3 // indirect
+	github.com/redpanda-data/console/backend v0.0.0-20240303221210-05d5d9e85f20 // indirect
+	github.com/redpanda-data/redpanda-operator/charts/connectors v0.0.0-20250407180246-dc814fb6b3b8 // indirect
+	github.com/redpanda-data/redpanda-operator/charts/console v0.0.0-20250407180246-dc814fb6b3b8 // indirect
+	github.com/redpanda-data/redpanda-operator/charts/redpanda/v5 v5.10.3-0.20250530212252-f020b773160c // indirect
 	github.com/redpanda-data/redpanda-operator/gotohelm v1.1.0 // indirect
 	github.com/redpanda-data/redpanda/src/go/rpk v0.0.0-20240827155712-244863ea0ae8 // indirect
 	github.com/rivo/uniseg v0.4.7 // indirect
@@ -220,6 +228,7 @@ require (
 	github.com/twmb/franz-go v1.18.0 // indirect
 	github.com/twmb/franz-go/pkg/kadm v1.12.0 // indirect
 	github.com/twmb/franz-go/pkg/kmsg v1.9.0 // indirect
+	github.com/twmb/franz-go/pkg/sr v1.2.0 // indirect
 	github.com/twmb/tlscfg v1.2.1 // indirect
 	github.com/virtuald/go-ordered-json v0.0.0-20170621173500-b18e6e673d74 // indirect
 	github.com/wk8/go-ordered-map/v2 v2.1.8 // indirect