//===----------------------------------------------------------------------===// // Copyright © 2025-2026 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 ContainerizationOCI import Foundation /// A multi-arch kernel image represented by an OCI image. public struct KernelImage: Sendable { /// The media type for a kernel image. public static let mediaType = "application/vnd.apple.containerization.kernel" /// The name or reference of the image. public var name: String { image.reference } let image: Image public init(image: Image) { self.image = image } } extension KernelImage { /// Return the kernel from a multi arch image for a specific system platform. public func kernel(for platform: SystemPlatform) async throws -> Kernel { let manifest = try await image.manifest(for: platform.ociPlatform()) guard let descriptor = manifest.layers.first, descriptor.mediaType == Self.mediaType else { throw ContainerizationError(.notFound, message: "kernel descriptor for \(platform) not found") } let content = try await image.getContent(digest: descriptor.digest) return Kernel( path: content.path, platform: platform ) } /// Create a new kernel image with the reference as the name. /// This will create a multi arch image containing kernel's for each provided architecture. public static func create(reference: String, binaries: [Kernel], labels: [String: String] = [:], imageStore: ImageStore, contentStore: ContentStore) async throws -> KernelImage { let indexDescriptorStore = AsyncStore() try await contentStore.ingest { ingestPath in var descriptors = [Descriptor]() let writer = try ContentWriter(for: ingestPath) for kernel in binaries { var result = try writer.create(from: kernel.path) let platform = kernel.platform.ociPlatform() let layerDescriptor = Descriptor( mediaType: mediaType, digest: result.digest.digestString, size: result.size, platform: platform) let rootfsConfig = ContainerizationOCI.Rootfs(type: "layers", diffIDs: [result.digest.digestString]) let runtimeConfig = ContainerizationOCI.ImageConfig(labels: labels) let imageConfig = ContainerizationOCI.Image(architecture: platform.architecture, os: platform.os, config: runtimeConfig, rootfs: rootfsConfig) result = try writer.create(from: imageConfig) let configDescriptor = Descriptor(mediaType: ContainerizationOCI.MediaTypes.imageConfig, digest: result.digest.digestString, size: result.size) let manifest = Manifest(config: configDescriptor, layers: [layerDescriptor]) result = try writer.create(from: manifest) let manifestDescriptor = Descriptor( mediaType: ContainerizationOCI.MediaTypes.imageManifest, digest: result.digest.digestString, size: result.size, platform: platform) descriptors.append(manifestDescriptor) } let index = ContainerizationOCI.Index(manifests: descriptors) let result = try writer.create(from: index) let indexDescriptor = Descriptor(mediaType: ContainerizationOCI.MediaTypes.index, digest: result.digest.digestString, size: result.size) await indexDescriptorStore.set(indexDescriptor) } guard let indexDescriptor = await indexDescriptorStore.get() else { throw ContainerizationError(.notFound, message: "image for \(reference) not found") } let description = Image.Description(reference: reference, descriptor: indexDescriptor) let image = try await imageStore.create(description: description) return KernelImage(image: image) } }