mirror of
https://github.com/apple/container.git
synced 2026-07-15 14:07:04 +00:00
Morris Richman
dd6bdc20cf
## Type of Change - [ ] Bug fix - [x] New feature - [ ] Breaking change - [ ] Documentation update ## Motivation and Context Plugins technically exist, but to add shortcuts or to do existing things with functions in `container` requires calling a compiled binary. This pull request aims to remove that hurdle and instability by exposing commands as a new `ContainerCommands ` target. Simply import `ContainerCommands` and you can access almost any command as if it were a native part of the binary. This makes plugin development significantly easier. Closes #609.
104 lines
3.8 KiB
Swift
104 lines
3.8 KiB
Swift
//===----------------------------------------------------------------------===//
|
|
// Copyright © 2025 Apple Inc. and the container project authors. All rights reserved.
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
//
|
|
// https://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
import ArgumentParser
|
|
import ContainerClient
|
|
import ContainerizationError
|
|
import ContainerizationOS
|
|
import Foundation
|
|
|
|
extension Application {
|
|
public struct ContainerExec: AsyncParsableCommand {
|
|
public init() {}
|
|
|
|
public static let configuration = CommandConfiguration(
|
|
commandName: "exec",
|
|
abstract: "Run a new command in a running container")
|
|
|
|
@OptionGroup
|
|
var processFlags: Flags.Process
|
|
|
|
@OptionGroup
|
|
var global: Flags.Global
|
|
|
|
@Argument(help: "Running containers ID")
|
|
var containerID: String
|
|
|
|
@Argument(parsing: .captureForPassthrough, help: "New process arguments")
|
|
var arguments: [String]
|
|
|
|
public func run() async throws {
|
|
var exitCode: Int32 = 127
|
|
let container = try await ClientContainer.get(id: containerID)
|
|
try ensureRunning(container: container)
|
|
|
|
let stdin = self.processFlags.interactive
|
|
let tty = self.processFlags.tty
|
|
|
|
var config = container.configuration.initProcess
|
|
config.executable = arguments.first!
|
|
config.arguments = [String](self.arguments.dropFirst())
|
|
config.terminal = tty
|
|
config.environment.append(
|
|
contentsOf: try Parser.allEnv(
|
|
imageEnvs: [],
|
|
envFiles: self.processFlags.envFile,
|
|
envs: self.processFlags.env
|
|
))
|
|
|
|
if let cwd = self.processFlags.cwd {
|
|
config.workingDirectory = cwd
|
|
}
|
|
|
|
let defaultUser = config.user
|
|
let (user, additionalGroups) = Parser.user(
|
|
user: processFlags.user, uid: processFlags.uid,
|
|
gid: processFlags.gid, defaultUser: defaultUser)
|
|
config.user = user
|
|
config.supplementalGroups.append(contentsOf: additionalGroups)
|
|
|
|
do {
|
|
let io = try ProcessIO.create(tty: tty, interactive: stdin, detach: false)
|
|
defer {
|
|
try? io.close()
|
|
}
|
|
|
|
if !self.processFlags.tty {
|
|
var handler = SignalThreshold(threshold: 3, signals: [SIGINT, SIGTERM])
|
|
handler.start {
|
|
print("Received 3 SIGINT/SIGTERM's, forcefully exiting.")
|
|
Darwin.exit(1)
|
|
}
|
|
}
|
|
|
|
let process = try await container.createProcess(
|
|
id: UUID().uuidString.lowercased(),
|
|
configuration: config,
|
|
stdio: io.stdio
|
|
)
|
|
|
|
exitCode = try await Application.handleProcess(io: io, process: process)
|
|
} catch {
|
|
if error is ContainerizationError {
|
|
throw error
|
|
}
|
|
throw ContainerizationError(.internalError, message: "failed to exec process \(error)")
|
|
}
|
|
throw ArgumentParser.ExitCode(exitCode)
|
|
}
|
|
}
|
|
}
|