Translation pending. This page is currently available in Chinese.
distro rootfs 是怎么构建出来的¶
make rootfs-alpine 落到 user/rootfs/alpine/build.sh。它做的事说起来简单:用静态的 apk.static 把 packages.txt 里的几百个包装进一个临时目录,把 overlay/ 拷进去,最后用 mkfs.ext4 -d 直接打成一张 ext4 镜像。麻烦都在细节上,下面按步骤讲。
构建流程¶
- 准备 apk 工具。
apk-tools-static(一个 .apk 压缩包)从镜像下载并解包,得到sbin/apk.static。下载和后续的包缓存都落在build/cache/alpine/下,第二次构建基本不联网。 - 装包。
apk.static --arch <arch> --root <tmp> --cache-packages add $packages把packages.txt里的包装进临时 rootfs。这里有个特性必须知道:apk 的 post-install 脚本不跑,所以 gdk-pixbuf 的 loader 缓存、mime 缓存这类本应由 post-install 生成的东西是缺失的,得由 overlay 里的 stage-2 init 在启动时补。 - 拷 overlay。
overlay/里的内容(stage-2 init、会话脚本、etc/a20-distro标记、udev 规则、labwc 配置等)整体拷进 rootfs;再写/etc/apk/repositories(指向同一个镜像),建sbin/init -> /usr/lib/a20/init软链,时区指到Asia/Shanghai。 - 补缓存。chroot 进去跑
gdk-pixbuf-query-loaders --update-cache和update-mime-database,把上面提到缺的缓存补上(失败可容忍)。 - 打镜像。
truncate一个ROOTFS_SIZE_MB(默认 8192)大小的文件,然后mkfs.ext4 -O ... -d <rootfs>直接带目录打进 ext4。所以产物是**没有分区表、没有 bootloader** 的裸 ext4,宿主上mount -o loop或直接当 QEMU 根盘。
关键文件¶
user/rootfs/alpine/packages.txt:包清单。基础是alpine-base+ bash/coreutils/busybox/util-linux 那一组,往上叠 XFCE4、labwc、dbus、elogind、polkit、seatd、eudev、mesa、xterm/xfce4-terminal、xrandr 等,共 439 个包。user/rootfs/alpine/overlay/:A20OS 塞进发行版的私有文件。usr/lib/a20/init是 stage-2 init(见 boot.md),usr/lib/a20/start-xfce4-session是会话入口,etc/a20-distro是 A20OS init 识别"这是发行版 rootfs"的标记。
环境变量¶
ARCH(riscv64/x86_64/aarch64/loongarch64,必填)、OUTPUT(产物路径,必填)、ROOTFS_SIZE_MB(>1024)、ALPINE_MIRROR_ROOT(默认 https://mirrors.ustc.edu.cn/alpine)、ALPINE_VERSION(默认 v3.23)。
构建环境踩过的坑¶
- 官方 CDN 慢到像卡死。容器里
apk add装构建工具时,默认走 dl-cdn.alpinelinux.org,实测十几 KB/s 甚至挂起。解决办法是先把容器的/etc/apk/repositories指到 USTC,或干脆用下面预置好的镜像。 - 推荐用一个预置 docker 镜像
a20rootfs-builder:latest,它预装了 bash/curl/tar/e2fsprogs/coreutils 且 apk 源已指 USTC,一次构建约 2 分钟:
docker run --rm -v "$PWD:/w" -w /w a20rootfs-builder:latest \
sh -c 'ARCH=riscv64 OUTPUT=build/alpine/rootfs.img \
ROOTFS_SIZE_MB=8192 bash user/rootfs/alpine/build.sh'
一次性制作这个镜像:
CID=$(docker run -d alpine:latest sleep 3600)
docker exec $CID sh -c "printf 'https://mirrors.ustc.edu.cn/alpine/latest-stable/main\nhttps://mirrors.ustc.edu.cn/alpine/latest-stable/community\n' > /etc/apk/repositories && apk add --no-cache bash curl tar e2fsprogs coreutils"
docker commit $CID a20rootfs-builder:latest
docker rm -f $CID
- 改了 overlay 必须重建镜像。镜像 8GiB、由 root 生成,普通用户没法用 debugfs 直接改里面单个文件(ext4 的 metadata_csum 会让 debugfs 报 checksum 错打不开 rw)。任何 overlay 改动都老老实实重跑一次构建。
- 产物权限。镜像归 root,QEMU 通常以普通用户跑,启动前要 chown 回来(用 docker
chown 1000:1000最省事)。