add support for multiple --tag flags in build (#785)

- Closes #732.

## Type of Change
- [ ] Bug fix
- [x] New feature  
- [ ] Breaking change
- [ ] Documentation update

## Motivation and Context
Adds support for specifying multiple `-t` / `--tag` flags with the
`build` command. All specified tags will point to the same built image.

Example:
`container build -t myapp:latest -t myapp:v1.0.0 -t myapp:stable .`

## Testing
- [x] Tested locally
- [x] Added/updated tests
- [x] Added/updated docs

Sources/ContainerBuild/Builder.swift

@@ -243,7 +243,7 @@ public struct Builder: Sendable {
         public let noCache: Bool
         public let platforms: [Platform]
         public let terminal: Terminal?
-        public let tag: String
+        public let tags: [String]
         public let target: String
         public let quiet: Bool
         public let exports: [BuildExport]
@@ -260,7 +260,7 @@ public struct Builder: Sendable {
             noCache: Bool,
             platforms: [Platform],
             terminal: Terminal?,
-            tag: String,
+            tags: [String],
             target: String,
             quiet: Bool,
             exports: [BuildExport],
@@ -276,7 +276,7 @@ public struct Builder: Sendable {
             self.noCache = noCache
             self.platforms = platforms
             self.terminal = terminal
-            self.tag = tag
+            self.tags = tags
             self.target = target
             self.quiet = quiet
             self.exports = exports
@@ -312,9 +312,11 @@ extension CallOptions {
             ("context", URL(filePath: config.contextDir).path(percentEncoded: false)),
             ("dockerfile", config.dockerfile.base64EncodedString()),
             ("progress", config.terminal != nil ? "tty" : "plain"),
-            ("tag", config.tag),
             ("target", config.target),
         ]
+        for tag in config.tags {
+            headers.append(("tag", tag))
+        }
         for platform in config.platforms {
             headers.append(("platforms", platform.description))
         }

Sources/ContainerCommands/BuildCommand.swift

@@ -106,7 +106,9 @@ extension Application {
         var quiet: Bool = false
 
         @Option(name: [.short, .customLong("tag")], help: ArgumentHelp("Name for the built image", valueName: "name"))
-        var targetImageName: String = UUID().uuidString.lowercased()
+        var targetImageNames: [String] = {
+            [UUID().uuidString.lowercased()]
+        }()
 
         @Option(name: .long, help: ArgumentHelp("Set the target build stage", valueName: "stage"))
         var target: String = ""
@@ -195,11 +197,11 @@ extension Application {
                     try? FileManager.default.removeItem(at: tempURL)
                 }
 
-                let imageName: String = try {
-                    let parsedReference = try Reference.parse(targetImageName)
+                let imageNames: [String] = try targetImageNames.map { name in
+                    let parsedReference = try Reference.parse(name)
                     parsedReference.normalize()
                     return parsedReference.description
-                }()
+                }
 
                 var terminal: Terminal?
                 switch self.progress {
@@ -267,7 +269,7 @@ extension Application {
                             noCache: noCache,
                             platforms: [Platform](platforms),
                             terminal: terminal,
-                            tag: imageName,
+                            tags: imageNames,
                             target: target,
                             quiet: quiet,
                             exports: exports,
@@ -294,7 +296,7 @@ extension Application {
                 }
                 unpackProgress.start()
 
-                var finalMessage = "Successfully built \(imageName)"
+                var finalMessage = "Successfully built \(imageNames.joined(separator: ", "))"
                 let taskManager = ProgressTaskCoordinator()
                 // Currently, only a single export can be specified.
                 for exp in exports {
@@ -311,6 +313,12 @@ extension Application {
                         for image in loaded {
                             try Task.checkCancellation()
                             try await image.unpack(platform: nil, progressUpdate: ProgressTaskCoordinator.handler(for: unpackTask, from: unpackProgress.handler))
+
+                            // Tag the unpacked image with all requested tags
+                            for tagName in imageNames {
+                                try Task.checkCancellation()
+                                _ = try await image.tag(new: tagName)
+                            }
                         }
                     case "tar":
                         guard let dest = exp.destination else {
@@ -349,8 +357,10 @@ extension Application {
             guard FileManager.default.fileExists(atPath: contextDir) else {
                 throw ValidationError("context dir does not exist \(contextDir)")
             }
-            guard let _ = try? Reference.parse(targetImageName) else {
-                throw ValidationError("invalid reference \(targetImageName)")
+            for name in targetImageNames {
+                guard let _ = try? Reference.parse(name) else {
+                    throw ValidationError("invalid reference \(name)")
+                }
             }
         }
     }