feat: support kustomize image newName override

api/v1alpha1/stage_types.go

@@ -451,6 +451,10 @@ type KustomizeImageUpdate struct {
 	//
 	// +kubebuilder:validation:Optional
 	UseDigest bool `json:"useDigest" protobuf:"varint,3,opt,name=useDigest"`
+	// NewName specifies a container image name override when setting the image
+	//
+	// +kubebuilder:validation:Optional
+	NewName string `json:"newName,omitempty" protobuf:"bytes,5,opt,name=newName"`
 }
 
 // HelmPromotionMechanism describes how to use Helm to incorporate Freight into

charts/kargo/resources/crds/kargo.akuity.io_stages.yaml

@@ -615,6 +615,10 @@ spec:
                                       (without tag). This is a required field.
                                     minLength: 1
                                     type: string
+                                  newName:
+                                    description: NewName specifies a container image
+                                      name override when setting the image
+                                    type: string
                                   origin:
                                     description: |-
                                       Origin disambiguates the origin from which artifacts used by this promotion

hack/codegen/proto.sh

@@ -35,7 +35,7 @@ function main() {
   go mod vendor
 
   echo "Generate protobuf code from Kubebuilder structs..."
-  GOPATH=${GOPATH} go-to-protobuf \
+    GOPATH=${GOPATH} go-to-protobuf \
     --go-header-file=./hack/boilerplate.go.txt \
     --packages="$(IFS=, ; echo "${API_PKGS[*]}")" \
     --apimachinery-packages="$(IFS=, ; echo "${APIMACHINERY_PKGS[*]}")" \

internal/controller/promotion/kustomize.go

@@ -87,10 +87,14 @@
 			continue
 		}
 		var fqImageRef string // Fully-qualified image reference
+		imageName := image.RepoURL
+		if imgUpdate.NewName != "" {
+			imageName = fmt.Sprintf("%s=%s", imageName, imgUpdate.NewName)
+		}
 		if imgUpdate.UseDigest {
-			fqImageRef = fmt.Sprintf("%s@%s", image.RepoURL, image.Digest)
+			fqImageRef = fmt.Sprintf("%s@%s", imageName, image.Digest)
 		} else {
-			fqImageRef = fmt.Sprintf("%s:%s", image.RepoURL, image.Tag)
+			fqImageRef = fmt.Sprintf("%s:%s", imageName, image.Tag)
 		}
 		dir := filepath.Join(workingDir, imgUpdate.Path)
 		if err := k.setImageFn(dir, fqImageRef); err != nil {

ui/src/gen/schema/stages.kargo.akuity.io_v1alpha1.json

@@ -438,6 +438,10 @@
                               "minLength": 1,
                               "type": "string"
                             },
+                            "newName": {
+                              "description": "NewName specifies a container image name override when setting the image",
+                              "type": "string"
+                            },
                             "origin": {
                               "description": "Origin disambiguates the origin from which artifacts used by this promotion\nmechanism must have originated. This is especially useful in cases where a\nStage may request Freight from multiples origins (e.g. multiple Warehouses)\nand some of those each reference different versions of artifacts from the\nsame repository. This field is optional. When left unspecified, it will\nimplicitly inherit the value of the enclosing KustomizePromotionMechanism's\nOrigin field. If that, too, is unspecified, Promotions will fail if there\nis ever ambiguity regarding from which piece of Freight an artifact is to\nbe sourced.",
                               "properties": {

ui/src/gen/v1alpha1/generated_pb.ts

@@ -3241,6 +3241,15 @@ export class KustomizeImageUpdate extends Message<KustomizeImageUpdate> {
    */
   useDigest?: boolean;
 
+  /**
+   * NewName specifies a container image name override when setting the image
+   *
+   * +kubebuilder:validation:Optional
+   *
+   * @generated from field: optional string newName = 5;
+   */
+  newName?: string;
+
   constructor(data?: PartialMessage<KustomizeImageUpdate>) {
     super();
     proto2.util.initPartial(data, this);
@@ -3253,6 +3262,7 @@ export class KustomizeImageUpdate extends Message<KustomizeImageUpdate> {
     { no: 4, name: "origin", kind: "message", T: FreightOrigin, opt: true },
     { no: 2, name: "path", kind: "scalar", T: 9 /* ScalarType.STRING */, opt: true },
     { no: 3, name: "useDigest", kind: "scalar", T: 8 /* ScalarType.BOOL */, opt: true },
+    { no: 5, name: "newName", kind: "scalar", T: 9 /* ScalarType.STRING */, opt: true },
   ]);
 
   static fromBinary(bytes: Uint8Array, options?: Partial<BinaryReadOptions>): KustomizeImageUpdate {