PolarDB for PostgreSQL 中 systemd 服务配置的最佳实践

问题背景

在使用 PolarDB for PostgreSQL 时，很多用户会遇到通过 systemd 启动服务失败的情况。典型表现为服务启动后立即退出，并显示"background worker 'logical replication launcher' exited with exit code 1"的错误信息。这通常是由于 systemd 服务配置文件中的参数设置不当导致的。

问题分析

在最初的配置中，用户使用了 Type=simple 的服务类型，这是 systemd 的默认服务类型。然而对于 PostgreSQL/PolarDB 这类数据库服务，这种配置并不合适，原因在于：

1. PostgreSQL 的启动过程是通过 pg_ctl 派生(fork)子进程来完成的
2. simple 类型期望主进程持续运行，而实际上 pg_ctl 在启动后会退出
3. 这导致 systemd 误认为服务启动失败，进而发送终止信号

正确配置方案

经过实践验证，正确的 systemd 服务配置应包含以下关键点：

[Unit]
Description=polardb postgres 15
After=network.target

[Service]
Type=forking
User=polardb
Group=polardb
ExecStart=/u01/polardb_pg/bin/pg_ctl -D /data/polardb-postgres-15 -l /data/polardb-postgres-15/polar-run.log start -s -w
ExecStop=/u01/polardb_pg/bin/pg_ctl -D /data/polardb-postgres-15 -l /data/polardb-postgres-15/polar-run.log stop -s -m fast
ExecReload=/u01/polardb_pg/bin/pg_ctl -D /data/polardb-postgres-15 -l /data/polardb-postgres-15/polar-run.log reload -s
TimeoutStartSec=5
RestartSec=5
Restart=on-failure

[Install]
WantedBy=multi-user.target

配置要点解析

1. Type=forking：这是最关键的一环，指明服务将通过派生(fork)子进程的方式运行，主进程会在启动完成后退出。

2. -s -w 参数：在 pg_ctl 命令中添加这些参数可以：

   • -s：只显示错误信息，减少日志噪音
   • -w：等待操作完成，确保服务稳定启动

3. 用户权限：确保使用专门的数据库用户(如polardb)运行服务，提高安全性。

4. 超时设置：TimeoutStartSec=5 为启动过程设置合理的超时时间。

5. 故障恢复：Restart=on-failure 确保服务在意外退出时自动重启。

服务管理命令

配置完成后，执行以下命令使配置生效：

systemctl daemon-reload
systemctl enable polarpg.service
systemctl start polarpg.service
systemctl status polarpg.service

总结

正确配置 systemd 服务对于 PolarDB for PostgreSQL 的稳定运行至关重要。通过使用 forking 类型服务，并配合适当的 pg_ctl 参数，可以确保数据库服务能够正常启动和运行。这一配置方案不仅适用于 PolarDB，也同样适用于标准 PostgreSQL 数据库的 systemd 服务管理。

对于生产环境，建议进一步考虑日志轮转、资源限制等高级配置，以确保数据库服务的稳定性和可靠性。