内容提要
pgrx 0.20 发布,最大亮点是 `cargo pgrx package` 可直接生成 RPM 和 DEB 包,无需 spec 文件或 debian 目录,只需在 Cargo.toml 添加空配置段。默认安装路径遵循 PGDG 仓库惯例,每个 PostgreSQL 版本需分别运行命令。该版本还自动生成 C 宏的 Rust 版本、支持 PG15–19、修复若干安全 API,并新增 `cargo pgrx migrate` 组装升级脚本。作者希望借此免除扩展作者各自打包的重复劳动。
延伸解读
打包从“手工活”变成命令的一部分
文章指出,此前 cargo pgrx package 只生成目录树,扩展作者需自行处理 RPM/DEB 打包。以 PostgreSQL Anonymizer 为例,每个版本要发布 24 个包,作者曾用 nfpm 解决。0.20 将这一环节内置,只需在 Cargo.toml 添加空配置段,即可在输出目录得到对应包。对维护者而言,重复的打包脚本可被统一命令替代,但文章也提醒这是首个版本,签名尚未支持。
默认路径对齐 PGDG,但版本仍需逐次构建
新命令按 pg_config 选定的 PostgreSQL 版本各生成一个包,默认安装路径遵循 PGDG 仓库惯例,便于与官方包共存。若需覆盖 PG15 至 19,就要用五个不同的 pg_config 分别运行五次。这意味着 CI 配置仍需按版本矩阵展开,并非一次命令产出全部版本。文章还说明,包名会带上 pg18 这类版本标识,安装位置也随版本变化。
元数据复用 Cargo 字段,注意与 cargo deb 冲突
包的 description、license 和第一作者取自 crate 字段,缺失时命令会提示;在 [package.metadata.rpm] 或 [package.metadata.deb] 中设置的键会覆盖默认值,并支持 ${PG_MAJOR_VERSION}、${ARCH} 等变量。文章特别警告:若项目已使用 cargo deb,同一段 [package.metadata.deb] 会被读取,但参数含义可能不同,导致打包失败。此时可用 --no-distrib-packages 保留原有配置。
升级脚本与构建体积的连带变化
除打包外,0.20 还引入 cargo pgrx migrate,把每次变更写成小 SQL 片段再组装成升级脚本,减少手工维护大段升级文件的负担。构建方面,扩展和 cargo-pgrx 本身编译的 crate 更少,Linux 上安装 cargo-pgrx 不再需要 OpenSSL 头文件。这些改动与打包能力一起,降低了扩展从开发到分发的整体摩擦,但文章未给出具体性能或体积数据。
Q&A
pgrx 0.20 的 cargo pgrx package 现在能直接生成哪些包格式?
可以直接生成 RPM 和 DEB 包,无需 spec 文件或 debian/ 目录,也无需额外工具。
如何让 cargo pgrx package 生成 RPM 和 DEB 包?
在 Cargo.toml 中添加空的 [package.metadata.rpm] 和 [package.metadata.deb] 配置段,然后运行 cargo pgrx package --pg-config /path/to/pg_config 即可。
pgrx 0.20 默认把扩展安装到哪个路径?
默认安装路径遵循 PGDG 仓库惯例,例如对于 PG18 会安装到 /usr/pgsql-18/ 下。
pgrx 0.20 除了打包,还有哪些主要更新?
自动生成 C 宏的 Rust 版本、支持 PG15–19(放弃 13/14)、修复若干安全 API、新增 cargo pgrx migrate 组装升级脚本、构建更轻量(Linux 安装 cargo-pgrx 不再需要 OpenSSL 头文件)。
如果之前用过 cargo deb,现在用 cargo pgrx package 需要注意什么?
cargo deb 也会读取 [package.metadata.deb],但元数据参数可能不同,可能导致 cargo pgrx package 失败。若想保留原有 cargo deb 配置,可使用 --no-distrib-packages 选项。
为什么作者要添加 RPM/DEB 打包功能?
因为每个 pgrx 扩展作者都在用各自的脚本解决相同的打包问题,作者希望 cargo pgrx 能直接内置该能力,免除重复劳动。