包仓库与签名¶
仓库布局¶
apk 仓库就是一个静态目录:
build/repo/
└── riscv64/ # 每个架构一个子目录(apk 按 --arch 自取)
├── APKINDEX.tar.gz # 索引(含签名流)
├── a20-base-0.2.0-r0.apk
├── a20-drivers-0.2.0-r0.apk
└── a20-kernel-0.2.0-r0.apk
建立/更新:
make pkg-repo ARCH=riscv64
# 等价于:make pkgs → cp 到 build/repo/riscv64/ → tools/packaging/mka20repo.sh 建索引
tools/packaging/mka20repo.sh 用 apk index 生成 APKINDEX.tar.gz;给出--sign-key 时会用 tools/packaging/apk-sign-stream.py 对索引做 RSA/SHA-256 签名(与 abuild-sign 相同的做法:对索引文件签名后把签名流前置于 tar 之前)。
信任链全貌¶
发布私钥(CI secret A20_REPO_SIGNING_KEY)
│ 签名
↓
每个 .apk 包 APKINDEX.tar.gz(仓库索引)
│ │
└── 消费侧用公钥验证 ──────────┘
公钥目录:Alpine 官方公钥(自动获取)+ A20OS 发布公钥(随发布产物提供)
签名有四处需要配齐:
- 包签名由
mka20pkg.py --sign-key在包内写入.SIGN.RSA256.<key-name>段,--key-name必须与公钥文件名一致(apk 按签名条目里的名字在 keys 目录里找公钥); - 索引签名由
mka20repo.sh --sign-key自动完成; - 公钥格式是 SPKI(
-----BEGIN PUBLIC KEY-----,即openssl rsa -in key -pubout的输出),不是 PKCS#1 的 "BEGIN RSA PUBLIC KEY"; - Alpine 公钥由 mkrootfs 在首次需要时从镜像站下载
alpine-keys包提取(这是一次信任引导;之后缓存复用)。
密钥管理¶
开发密钥(本地)¶
make pkg-key(也是 make pkgs 的自动依赖)生成build/keys/a20os-dev.rsa{,.pub}。位于 build/ 下、被 gitignore,仅用于本机闭环验证,不要把它的公钥分发给用户。
发布密钥(项目级)¶
# 一次性生成(由维护者保管私钥)
openssl genrsa -out a20os-release.rsa 4096
openssl rsa -in a20os-release.rsa -pubout -out a20os-release.rsa.pub
- 私钥 → GitHub 仓库 secret
A20_REPO_SIGNING_KEY(release workflow 自动使用); - 公钥 → 由 workflow 从私钥导出(
build/keys/a20os-release.rsa.pub),随各架构 artifact 和交付 bundle 分发; - 未配置 secret 时,release workflow 默认失败。仅 repository variable
ALLOW_UNSIGNED_RELEASE=1明确允许无签名产物,并输出警告;消费侧需要--allow-untrusted; - 私钥泄露 = 立刻吊销:换密钥对、重发索引、公告用户换公钥。
仓库分发¶
当前工作流将每个架构的仓库(build/repo/<arch>/,含 APKINDEX.tar.gz)、公钥、内核、bootstrap 和 world 一起装入交付 bundle。手动候选运行上传 artifact;成功的 tag 流程将同一批构建的 bundle 与镜像发布到 GitHub Release。
独立 HTTP apk 仓库服务不在当前发布链路中。GitHub Pages 网站由 pages.yml 管理;包仓库通过上述 bundle 分发,职责见 CI/CD 说明。
目标形态(发布后):仓库是静态目录,每个架构一个子目录:
https://<owner>.github.io/<repo>/riscv64/APKINDEX.tar.gz (+ 各架构)
https://<owner>.github.io/<repo>/a20os-release.rsa.pub (公钥)
在运行 apk 的 A20OS 系统(或任何 apk 环境)里使用:
# 目标系统上执行一次:信任 A20OS 发布公钥
wget -O /etc/apk/keys/a20os-release.rsa.pub \
https://<owner>.github.io/<repo>/a20os-release.rsa.pub
# 添加仓库
echo "https://<owner>.github.io/<repo>" >> /etc/apk/repositories
# 之后就是普通的 apk 世界
apk update && apk add a20-base
注意 apk 会自己给仓库 URL 追加 /<arch>/,所以 repositories 里写站点根即可,不要手写架构目录。
本地/内网仓库¶
仓库是纯静态文件,任何 HTTP 服务器都能托管,甚至可以直接用本地路径(CI 与 mkrootfs 正是这么用的):