参考 on Farrow

配置

Mon, 01 Jan 0001 00:00:00 +0000

发现顺序

依次查找：显式 -f、当前目录的 farrow.yml、farrow.yaml、pigsty.yml、 pigsty.yaml。所有文件名都使用同一种 Pigsty 兼容 YAML Inventory。

命令行

Mon, 01 Jan 0001 00:00:00 +0000

farrow [--json|--yaml] [--verbose] <command> [flags] [node...]

已安装的二进制是当前版本最准确的参考。每一条可见命令都自带操作边界与可复制样例：

farrow --help
farrow setup --help
farrow image pull --help

文本模式下，直接运行 farrow 或 farrow image 这样的命名空间会展示上下文帮助并成功退出；JSON/YAML 模式下，空命名空间返回结构化用法错误。显式 --help 始终输出供人阅读的帮助文本。

镜像

Mon, 01 Jan 0001 00:00:00 +0000

Farrow 使用一份签名静态 Catalog 与不可变 qcow2 工件。更新 Catalog 不需要发布新的 Farrow 二进制，但二进制决定信任哪些签名公钥与镜像安全规则。

警告

EL7 标记为 deprecated；其余内置镜像均为 testing，不是 supported。up 打印的警告是刻意保留的；拉取成功只证明完整性，不代表生产支持承诺。

镜像流水线

Mon, 01 Jan 0001 00:00:00 +0000

packaging/image-pipeline/ 接受一份已下载的不可变 qcow2 与独立获得的 SHA-256。它绝不下载、上传、修改 Farrow 运行时/网络状态、读取签名密钥，也不会把镜像标成 supported。

模式

validate：复制并重哈希，强制 qcow2 检查，校验单元素 Backing Chain，运行 qemu-img check，输出明确不可发布的证据 Bundle；不会修改 Guest 凭据。
offline：额外在 Staged Copy 上使用 libguestfs virt-customize --no-network 与 virt-cat。它拒绝无关 UID/GID 88 占用，归一化锁定的 dba/admin 身份，关闭密码与 Root SSH，清理密钥/历史/Host Identity/cloud-init Cache，恢复定向 SELinux Label，并回读确定性 Marker。

SOURCE_DATE_EPOCH=1787486400

./packaging/image-pipeline/build.sh \
  --mode validate \
  --source /absolute/source.qcow2 \
  --expected-sha256 <digest> \
  --output /absolute/new/evidence-directory \
  --name u24 --release 20260801.0.0 --arch amd64 \
  --source-user ubuntu --boot uefi \
  --source-uri https://immutable.example/source.qcow2 \
  --artifact-url 'https://images.example/u24/{sha256}.qcow2' \
  --license NOASSERTION \
  --source-date-epoch "$SOURCE_DATE_EPOCH" \
  --manifest-version 2026082801

Source/Output 必须是绝对路径；Source 必须 Canonical、普通、非符号链接、复制期间稳定，且不超过 16 GiB；Output 必须不存在。Builder 使用相邻排它锁、0700 Staging 与一次最终 Rename；失败只删除受保护的 Staging。