Poudriere 项目安装与使用指南

1. 项目目录结构及介绍

Poudriere 是一个用于 FreeBSD 系统上构建和测试软件包的工具。以下是 Poudriere 项目的主要目录结构及其功能介绍：

poudriere/
├── build-aux/
├── completions/
├── external/
├── m4/
├── src/
├── test-ports/
├── test/
├── cirrus.yml
├── .gitattributes
├── .gitignore
├── LICENSE
├── Makefile.am
├── Makefile.in
├── README.md
├── aclocal.m4
├── autogen.sh
├── configure
├── configure.ac
├── freebsd.cfg
└── ...

• build-aux/: 包含构建过程中所需的辅助文件。
• completions/: 包含命令行自动补全的脚本。
• external/: 包含外部依赖或工具的配置文件。
• m4/: 包含用于生成配置脚本的 M4 宏文件。
• src/: 包含 Poudriere 的主要源代码文件。
• test-ports/: 包含用于测试的端口配置文件。
• test/: 包含测试脚本和测试数据。
• cirrus.yml: CI/CD 配置文件。
• .gitattributes: Git 属性配置文件。
• .gitignore: Git 忽略文件配置。
• LICENSE: 项目许可证文件。
• Makefile.am: Automake 配置文件。
• Makefile.in: Makefile 模板文件。
• README.md: 项目介绍和使用说明。
• aclocal.m4: Automake 宏文件。
• autogen.sh: 自动生成配置脚本的脚本。
• configure: 配置脚本。
• configure.ac: 配置脚本模板。
• freebsd.cfg: FreeBSD 配置文件。

2. 项目启动文件介绍

Poudriere 项目的启动文件主要是 configure 和 autogen.sh。以下是这两个文件的介绍：

• configure: 这是一个自动生成的脚本，用于配置项目的编译环境。运行 ./configure 后，系统会根据当前环境生成 Makefile 和其他必要的配置文件。

• autogen.sh: 这是一个脚本，用于自动生成 configure 脚本。在项目首次编译之前，通常需要运行 ./autogen.sh 来生成 configure 脚本。

3. 项目的配置文件介绍

Poudriere 的主要配置文件是 /usr/local/etc/poudriere.conf。以下是该文件的主要配置项介绍：

• ZPOOL: 指定用于 Poudriere 的 ZFS 存储池。
• FREEBSD_HOST: 指定 FreeBSD 源代码的下载地址。
• RESOLV_CONF: 指定 DNS 解析配置文件的路径。
• BASEFS: 指定 Poudriere 的工作目录。
• USE_PORTLINT: 是否启用 portlint 工具进行端口检查。
• NO_ZFS: 是否禁用 ZFS 支持。
• DISTFILES_CACHE: 指定 distfiles 缓存目录。
• PKG_REPO_SIGNING_KEY: 指定用于签名软件包的 GPG 密钥。

配置文件示例：

ZPOOL=tank
FREEBSD_HOST=ftp://ftp.freebsd.org
RESOLV_CONF=/etc/resolv.conf
BASEFS=/poudriere
USE_PORTLINT=yes
NO_ZFS=no
DISTFILES_CACHE=/usr/ports/distfiles
PKG_REPO_SIGNING_KEY=/usr/local/etc/poudriere/keys/repo.key

通过以上配置，Poudriere 可以高效地构建和测试 FreeBSD 软件包。