Yocto Kirkstone中nginx包安装后脚本未在目标机运行的原因排查

核心原因：Yocto中pkg_postinst与pkg_postinst_ontarget的执行阶段差异 #

在Yocto Kirkstone版本中，这两个函数的定位有明确区分：

• pkg_postinst:${PN}：仅在构建主机的打包阶段执行，用于对安装到构建根目录$D下的文件做预处理（比如修改权限、生成临时配置），不会被打包到目标系统的软件包中。
• pkg_postinst_ontarget:${PN}：专门用于目标机安装时执行，脚本会被嵌入到软件包的postinst段，当目标系统通过包管理工具（如rpm/ipk）安装该包时自动运行。

你遇到的问题，本质是误将构建阶段的脚本函数当成了目标机执行的脚本——原nginx.inc中的pkg_postinst:${PN}在构建时运行，此时$D指向构建目录（非空），所以不会进入if [ -z "$D" ]分支执行目标机的操作；换成pkg_postinst_ontarget:${PN}后，脚本被打包到目标包中，在目标机安装时运行，此时$D为空，才会执行systemd-tmpfile --create逻辑。

优化建议 #

1. 优先使用systemd tmpfiles.d配置替代postinst脚本 #

对于/run/nginx、/var/log/nginx这类临时目录，更符合systemd生态的做法是通过tmpfiles.d配置文件自动创建，无需依赖postinst脚本：

• 在nginx配方中添加一个nginx-tmpfiles.conf文件，内容如下：

  d /run/nginx 0755 root root -
  d /var/log/nginx 0755 root root -
  

• 在配方的do_install阶段将该文件安装到目标系统的对应目录：

  install -d ${D}${sysconfdir}/tmpfiles.d
  install -m 0644 ${WORKDIR}/nginx-tmpfiles.conf ${D}${sysconfdir}/tmpfiles.d/nginx.conf
  

这样systemd会在系统启动或systemd-tmpfiles --create触发时自动创建目录，避免了postinst脚本的依赖。

2. 正确使用目标机postinst脚本 #

如果必须保留postinst逻辑，需注意：

• 用pkg_postinst_ontarget:${PN}替代pkg_postinst:${PN}，无需再判断$D（目标机执行时$D必然为空）
• 脚本中仅保留目标机需要执行的操作，比如：

  pkg_postinst_ontarget:${PN} () {
      systemd-tmpfiles --create
      systemctl enable nginx.service || true
  }
  

3. 理解Yocto包脚本的执行逻辑 #

Kirkstone版本对包脚本的执行阶段做了更严格的区分，务必牢记：

• 构建阶段操作（修改$D下的文件）：用pkg_preinst/pkg_postinst
• 目标机操作（安装后配置、服务启动）：用pkg_preinst_ontarget/pkg_postinst_ontarget

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