mirror of
https://github.com/apple/container.git
synced 2026-09-12 18:55:43 +00:00
Danny Canter
056a909081
Today this protocols create method is just odd. Our only implementation of it immediately casts to LinuxContainer, failing if it cannot do so. I think what might make more sense is to pass in a configuration itself with core parameters that we expect every vmm to be able to support, and then in a specific implementation they can continue to cast this type to a specific one to possibly extract some extra configuration values (rosetta for VZ for example). This rework will also make it simpler to support a Pod type, as the vm setup is identical and simple.
64 lines
2.2 KiB
Swift
64 lines
2.2 KiB
Swift
//===----------------------------------------------------------------------===//
|
|
// Copyright © 2025 Apple Inc. and the Containerization project authors.
|
|
//
|
|
// 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 ContainerizationError
|
|
import Foundation
|
|
|
|
/// The runtime state of the virtual machine instance.
|
|
public enum VirtualMachineInstanceState: Sendable {
|
|
case starting
|
|
case running
|
|
case stopped
|
|
case stopping
|
|
case unknown
|
|
}
|
|
|
|
/// A live instance of a virtual machine.
|
|
public protocol VirtualMachineInstance: Sendable {
|
|
associatedtype Agent: VirtualMachineAgent
|
|
|
|
// The state of the virtual machine.
|
|
var state: VirtualMachineInstanceState { get }
|
|
|
|
var mounts: [String: [AttachedFilesystem]] { get }
|
|
/// Dial the Agent. It's up the VirtualMachineInstance to determine
|
|
/// what port the agent is listening on.
|
|
func dialAgent() async throws -> Agent
|
|
/// Dial a vsock port in the guest.
|
|
func dial(_ port: UInt32) async throws -> FileHandle
|
|
/// Listen on a host vsock port.
|
|
func listen(_ port: UInt32) throws -> VsockConnectionStream
|
|
/// Stop listening on a vsock port.
|
|
func stopListen(_ port: UInt32) throws
|
|
/// Start the virtual machine.
|
|
func start() async throws
|
|
/// Stop the virtual machine.
|
|
func stop() async throws
|
|
/// Pause the virtual machine.
|
|
func pause() async throws
|
|
/// Resume the virtual machine.
|
|
func resume() async throws
|
|
}
|
|
|
|
extension VirtualMachineInstance {
|
|
func pause() async throws {
|
|
throw ContainerizationError(.unsupported, message: "pause")
|
|
}
|
|
func resume() async throws {
|
|
throw ContainerizationError(.unsupported, message: "resume")
|
|
}
|
|
}
|