如何为带Makefile的Apache-Age编写Debian打包规则文件？

核心问题定位 #

你的deb包安装后扩展不生效，核心原因大概率是编译产物未被放置到PostgreSQL的标准扩展目录，或是**make install的路径被debhelper重定向后未正确映射**。

Rules文件核心配置模板 #

PostgreSQL扩展打包必须适配PGXS框架，同时结合debhelper的构建序列。以下是适配Apache-Age的rules文件模板：

#!/usr/bin/make -f

export DH_VERBOSE=1
# 动态获取PostgreSQL路径，避免硬编码版本
PG_CONFIG := /usr/bin/pg_config
PG_EXT_DIR := $(shell $(PG_CONFIG) --sharedir)/extension
PG_MOD_DIR := $(shell $(PG_CONFIG) --pkglibdir)

%:
	dh $@

override_dh_auto_configure:
	# Apache-Age无需额外configure，直接传递PG_CONFIG路径
	dh_auto_configure -- PG_CONFIG=$(PG_CONFIG)

override_dh_auto_build:
	# 强制使用PGXS框架编译，这是PostgreSQL扩展打包的关键
	make USE_PGXS=1

override_dh_auto_install:
	# 清空临时安装目录，避免残留文件干扰
	rm -rf $(CURDIR)/debian/apache-age/usr/
	# 指定DESTDIR将产物放到deb包的临时目录
	make USE_PGXS=1 DESTDIR=$(CURDIR)/debian/apache-age install
	# 可选：验证文件是否被正确复制
	ls -la $(CURDIR)/debian/apache-age$(PG_EXT_DIR)
	ls -la $(CURDIR)/debian/apache-age$(PG_MOD_DIR)

override_dh_installchangelogs:
	dh_installchangelogs CHANGELOG.md

override_dh_clean:
	dh_clean
	# 清理Age编译生成的临时文件
	make USE_PGXS=1 clean

关键参数说明 #

• USE_PGXS=1：强制PostgreSQL扩展使用PGXS框架编译，确保产物路径符合系统标准，这是打包成功的核心前提。
• DESTDIR：指定make install将文件输出到deb包的临时构建目录，而非直接写入系统目录，符合Debian打包规范。
• 动态路径获取：通过pg_config获取PostgreSQL的扩展目录和模块目录，适配不同版本的PostgreSQL环境。

构建验证步骤 #

1. 预编译验证：在Apache-Age源码目录手动执行make USE_PGXS=1 && make USE_PGXS=1 DESTDIR=/tmp/test install，检查/tmp/test下的文件结构：
   • 需存在/usr/share/postgresql/<版本>/extension/age.control及配套SQL文件
   • 需存在/usr/lib/postgresql/<版本>/lib/age.so模块文件
2. 构建过程检查：执行dpkg-buildpackage -rfakeroot -b时，重点观察dh_auto_build和dh_auto_install阶段的输出，确认无编译错误，且文件被正确复制到debian包目录。
3. 安装后验证：安装deb包后，执行pg_config --sharedir和pg_config --pkglibdir，检查对应目录下是否存在Age的相关文件。

实用参考资源 #

• Debian官方PostgreSQL扩展打包规范：重点关注pg_buildext工具的使用逻辑，它能简化多版本PostgreSQL的适配（Age当前版本可参考核心逻辑）
• 已发布PostgreSQL扩展的rules文件：比如postgresql-14-postgis-3的rules文件，学习PGXS与debhelper的配合方式
• Apache-Age官方Makefile：仔细阅读其接受的参数（如PG_CONFIG、DESTDIR），确保rules中传递的参数完全匹配官方要求

常见避坑点 #

• 遗漏USE_PGXS=1：导致编译路径偏离PostgreSQL标准，产物无法被识别
• DESTDIR路径错误：make install直接写入系统目录，导致deb包为空或文件位置错误
• 开发依赖缺失：即便control文件声明了依赖，编译时仍需确保安装postgresql-server-dev-all等开发包，否则会编译失败

内容的提问来源于stack exchange，提问作者Sarthak