refactor(operator): Align code with decision

This implements the decision taken in stackabletech/decisions#85

Author: Techassi

crates/stackable-operator/crds/DummyCluster.yaml

@@ -1781,9 +1781,9 @@ spec:
                 properties:
                   custom:
                     description: |-
-                      Overwrite the container image.
+                      Provide a custom container image.
 
-                      Specify the full container image name, e.g. `oci.stackable.tech/sdp/superset:1.4.1-stackable2.1.0`
+                      Specify the full container image name, e.g. `oci.example.tech/namespace/superset:1.4.1-my-tag`
                     type: string
                   productVersion:
                     description: Version of the product, e.g. `1.4.1`.
@@ -1809,18 +1809,10 @@ spec:
                       type: object
                     nullable: true
                     type: array
-                  registry:
-                    description: |-
-                      The container image registry, e.g. `oci.stackable.tech`.
-
-                      If not specified, the operator will use the image registry provided via the operator
-                      environment options.
-                    nullable: true
-                    type: string
-                  repository:
+                  repo:
                     description: |-
                       The repository on the container image registry where the container image is located, e.g.
-                      `sdp/airflow`.
+                      `oci.example.com/namespace`.
 
                       If not specified, the operator will use the image registry provided via the operator
                       environment options.

crates/stackable-operator/src/cli/environment.rs

@@ -14,24 +14,13 @@ pub struct OperatorEnvironmentOptions {
     #[arg(long, env)]
     pub operator_service_name: String,
 
-    /// The image registry which should be used when resolving images provisioned by the operator.
+    /// The image repository which should be used when resolving images provisioned by the operator.
     ///
-    /// Example values include: `127.0.0.1` or `oci.example.org`.
+    /// This argument expects a valid registry host and path. Valid values include:
+    /// `oci.example.org/my/namespace` or `quay.io/organization`
     ///
     /// Note that when running the operator on Kubernetes we recommend to provide this value via
     /// the deployment mechanism, like Helm.
-    #[arg(long, env, value_parser = url::Host::parse)]
-    pub image_registry: url::Host,
-
-    /// The image repository used in conjunction with the `image_registry` to form the final image
-    /// name.
-    ///
-    /// Example values include: `airflow-operator` or `path/to/hbase-operator`.
-    ///
-    /// Note that when running the operator on Kubernetes we recommend to provide this value via
-    /// the deployment mechanism, like Helm. Additionally, care must be taken when this value is
-    /// used as part of the product image selection, as it (most likely) includes the `-operator`
-    /// suffix.
     #[arg(long, env)]
     pub image_repository: String,
 }