mirror of
https://github.com/apple/container.git
synced 2026-07-15 05:57:01 +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.
90 lines
3.0 KiB
Swift
90 lines
3.0 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 TerminalProgress
|
|
|
|
extension Application {
|
|
public struct ContainerStart: AsyncParsableCommand {
|
|
public init() {}
|
|
|
|
public static let configuration = CommandConfiguration(
|
|
commandName: "start",
|
|
abstract: "Start a container")
|
|
|
|
@Flag(name: .shortAndLong, help: "Attach STDOUT/STDERR")
|
|
var attach = false
|
|
|
|
@Flag(name: .shortAndLong, help: "Attach container's STDIN")
|
|
var interactive = false
|
|
|
|
@OptionGroup
|
|
var global: Flags.Global
|
|
|
|
@Argument(help: "Container's ID")
|
|
var containerID: String
|
|
|
|
public func run() async throws {
|
|
var exitCode: Int32 = 127
|
|
|
|
let progressConfig = try ProgressConfig(
|
|
description: "Starting container"
|
|
)
|
|
let progress = ProgressBar(config: progressConfig)
|
|
defer {
|
|
progress.finish()
|
|
}
|
|
progress.start()
|
|
|
|
let container = try await ClientContainer.get(id: containerID)
|
|
do {
|
|
let detach = !self.attach && !self.interactive
|
|
let io = try ProcessIO.create(
|
|
tty: container.configuration.initProcess.terminal,
|
|
interactive: self.interactive,
|
|
detach: detach
|
|
)
|
|
defer {
|
|
try? io.close()
|
|
}
|
|
|
|
let process = try await container.bootstrap(stdio: io.stdio)
|
|
progress.finish()
|
|
|
|
if detach {
|
|
try await process.start()
|
|
try io.closeAfterStart()
|
|
print(self.containerID)
|
|
return
|
|
}
|
|
|
|
exitCode = try await Application.handleProcess(io: io, process: process)
|
|
} catch {
|
|
try? await container.stop()
|
|
|
|
if error is ContainerizationError {
|
|
throw error
|
|
}
|
|
throw ContainerizationError(.internalError, message: "failed to start container: \(error)")
|
|
}
|
|
throw ArgumentParser.ExitCode(exitCode)
|
|
}
|
|
}
|
|
}
|