如何从Node.js程序向Heroku上的PostgREST发送SIGHUP信号？

要在node-pg-migrate完成迁移后自动刷新PostgREST的schema缓存，你可以通过Node.js的child_process模块执行系统命令发送SIGHUP信号。具体实现分两种常见场景：

场景1：PostgREST与迁移脚本在同一个Heroku Dyno中 #

如果你的PostgREST服务和Node.js迁移程序运行在同一个dyno里，直接在迁移完成后执行信号发送命令即可：

实现步骤： #

1. 创建一个自定义Node.js脚本（比如migrate-and-reload.js），整合迁移和重载逻辑：

const { exec } = require('child_process');
const util = require('util');
// 把回调式的exec转为Promise风格，方便异步流程控制
const execPromise = util.promisify(exec);

async function migrateAndReload() {
  try {
    // 执行数据库迁移
    console.log('Starting database migrations...');
    const { stdout: migrateStdout } = await execPromise('npm run migrate:up');
    console.log('Migrations finished:\n', migrateStdout);

    // 发送SIGHUP信号刷新PostgREST缓存
    console.log('Refreshing PostgREST schema cache...');
    // 加入容错逻辑：如果PostgREST进程不存在，命令不会抛出错误中断流程
    await execPromise('killall -HUP postgrest 2>/dev/null || true');
    console.log('PostgREST schema cache reloaded successfully!');
  } catch (err) {
    console.error('Migration or reload failed:', err.message);
    process.exit(1);
  }
}

migrateAndReload();

2. 在package.json中添加一个新的脚本命令，方便执行：

{
  "scripts": {
    "migrate:up": "node-pg-migrate up",
    "migrate:up:reload": "node migrate-and-reload.js"
  }
}

3. 部署后，通过以下命令完成迁移+缓存重载：

heroku run npm run migrate:up:reload

场景2：PostgREST与迁移脚本在不同的Heroku Dyno中 #

如果PostgREST运行在单独的web dyno，迁移脚本在worker dyno，需要通过Heroku CLI远程在目标dyno中执行信号发送命令：

实现步骤： #

1. 先确保你的Heroku应用已启用heroku-exec插件（用于远程执行命令）：

heroku plugins:install heroku-exec
heroku ps:exec:enable -a your-app-name

2. 修改自定义脚本，使用heroku ps:exec远程发送信号：

const { exec } = require('child_process');
const util = require('util');
const execPromise = util.promisify(exec);

// 推荐从Heroku环境变量获取应用名（可在控制台配置）
const HEROKU_APP_NAME = process.env.HEROKU_APP_NAME;
// 指定PostgREST所在的dyno类型（比如web）
const TARGET_DYNO = 'web';

async function migrateAndReload() {
  try {
    // 执行本地迁移
    console.log('Running migrations...');
    const { stdout: migrateStdout } = await execPromise('npm run migrate:up');
    console.log('Migrations completed:\n', migrateStdout);

    // 远程在目标dyno发送SIGHUP信号
    console.log('Reloading PostgREST on remote dyno...');
    const reloadCmd = `heroku ps:exec -a ${HEROKU_APP_NAME} -d ${TARGET_DYNO} -- killall -HUP postgrest 2>/dev/null || true`;
    await execPromise(reloadCmd);
    console.log('Remote PostgREST schema cache reloaded!');
  } catch (err) {
    console.error('Process failed:', err.message);
    process.exit(1);
  }
}

migrateAndReload();

3. 在Heroku控制台为应用设置HEROKU_APP_NAME环境变量，或者直接在脚本中替换为你的应用名称。

4. 执行脚本完成迁移和远程重载：

heroku run npm run migrate:up:reload

注意事项 #

• 确认PostgREST进程在dyno中的名称确实是postgrest，如果启动命令有自定义调整，可改用pgrep查找PID：kill -HUP $(pgrep postgrest) 2>/dev/null || true。
• 在Heroku上执行远程命令时，注意dyno的资源限制，避免频繁操作导致超时。
• 可根据业务需求调整错误处理逻辑，比如决定PostgREST重载失败时是否终止脚本。

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