磁盘镜像资产与命名

"某系统的官方介质,装配为可引导镜像"的资产类:这类包是什么、如何命名、配方声明什么。这里没有任何引擎词汇——引擎不知道这些名字;该类资产服务任何引导镜像的消费者。

类定义#

磁盘镜像包携带一个系统的字节,为模拟器准备好:发布者的官方介质,装配为带串口控制台的可引导镜像,在两个资源服务器发布且双侧同一 sha。它是资产,不是机制:模拟器与退出码约定属于引导它的 runner,永不属于这个包。镜像自身的应答 --- 提示符、shell 的引号规则、文件盘挂载的位置 --- 是镜像的事实,包可以把它作为 runner 的数据携带:镜像旁的 dirun.toml,即 dirun 引导它所用的描述(dirun --profile {pkg:<system>-disk-image}/dirun.toml -- {})。

命名#

为什么是 disk-image 而非其他:disk 单用可能读作硬件;image 单用已被容器占用;iso 在介质换成 qcow2 那天就撒谎;boot- 前缀说的东西磁盘镜像本身已经说了。

该类配方声明什么#

-- <system>-disk-image.lua — an asset package: install only, nothing on PATH
package = {
    spec = "2",
    name = "<system>-disk-image",
    description = "The <Publisher> official <version> media, assembled into a bootable disk image with a serial console, for emulator runners",
    licenses = { "<publisher license>" },
    repo = "<publisher source>",
    type = "package",
    status = "dev",
    archs = { "x86_64", "aarch64" },
    xpm = {
        ["<os>"] = {
            source = {
                GLOBAL = "https://github.com/xlings-res/<system>-disk-image/releases/download/${version}/<system>-${version}.<arch>.qcow2",
                CN = "https://gitcode.com/xlings-res/<system>-disk-image/releases/download/${version}/<system>-${version}.<arch>.qcow2",
            },
            ["latest"] = { ref = "<version>" },
            ["<version>"] = { sha256 = { ["x86_64"] = "…", ["aarch64"] = "…" } },
        },
    },
}
-- install(): the image lands under the package root; config()/uninstall():
-- none. A consumer is a runner declaration that names the image's path.

矫正变更#