【转载】使用 systemd 管理 Node.js 应用

转载自


systemd 是 Linux 下的一款系统和服务管理器,该软件的初衷是提供精确的服务间依赖,以此支持并行启动来提高性能。越来越多的 Linux 发行版都由 sysvinit 迁移到了 systemd(包括 Debian!)。在这些 Linux 系统中,用原生的 systemd 来托管 Node.js 进程足够满足一般开发者的要求,借由 systemd 可以很方便地处理依赖关系和监测日志。

systemctl

systemctl 是查询和控制 systemd 的主要命令,下面以 mongod 为例介绍常用参数:

MongoDBNode.js 下非常常见的 NoSQL 数据库,在 ArchLinux 下通过 pacman 安装:pacman install mongodb,安装成功后 mongod 即为可用的 systemd 服务。

1
2
3
4
5
6
7
8
9
10
11
12
# 查看服务状态
systemctl status mongod
# 启动服务
systemctl start mongod
# 停止服务
systemctl stop mongod
# 重启服务
systemctl restart mongod
# 设为自启动
systemctl enable mongod
# 取消自启动
systemctl disable mongod

更多信息可查阅 man page:man systemctl

单元文件

每个 systemd 服务均由一个 单元文件 来定义。这些单元文件位于 /usr/lib/systemd/system//etc/systemd/system/,分别存放安装软件包(比如 MongoDB)和系统管理员的单元文件。 systemd 启动时会扫描上述路径并载入相应的单元。

Systemd Unit Files Locations (provided by redhat):

Directory Description
/usr/lib/systemd/system/ Systemd unit files distributed with installed RPM packages.
/run/systemd/system/ Systemd unit files created at run time. This directory takes precedence over the directory with installed service unit files.
/etc/systemd/system/ Systemd unit files created by systemctl enable as well as unit files added for extending a service. This directory takes precedence over the directory with runtime unit files.

所以在修改或添加单元文件后,需要让 systemd 重新加载扫描并加载这些文件:

1
sudo systemctl daemon-reload

单元文件的语法非常简单,类似于 Windows 的 .ini 文件。例如:

1
2
3
4
5
6
7
8
9
10
[Unit]
Description=myapp

[Service]
WorkingDirectory=/home/harttle/myapp
ExecStart=/usr/bin/node bin/www
Restart=always
StandardOutput=syslog
StandardError=syslog
SyslogIdentifier=myapp

将上述文件保存为 /etc/systemd/system/myapp.service,运行 systemctl start myapp 即可启动它。通过 systemctl status myapp 来查看状态,通过 journalctl 来查看日志,见下文。

更多信息可查询 man page: man systemd.unit

监测日志

systemd 采用 cgroups 来监测进程,这意味着 fork 得到的子进程也不会脱离日志。systemd 单元默认的日志输出为 syslog,可通过 journalctl 来查看:

1
2
# 指定systemd单元(unit)
journalctl -u myapp

查看实时日志:

1
journalctl -f

依赖关系

Node.js 应用通常会依赖于其他的服务,比如 MongoDBRedis 等。这意味着 myapp 在开机启动时可能会因这些进程未启动而失败。可以在单元文件中指定依赖关系,systemd 便会先启动那些依赖:

1
2
3
4
[Unit]
Description=myapp
Requires=mongodb.service redis.service
After=mongodb.service redis.service

环境与用户组

systemd 支持为每个单元文件设置用户组,以及环境变量。 这在 Node.js 的 Web 应用部署和安全提供了方便。

1
2
3
4
[Service]
Environment=DEBUG='myapp:*'
User=www
Group=http

设置多个环境变量可以编写多条 Environment= 语句,例如:

1
2
Environment=PORT=3000
Environment=HOST=localhost

用户和组在生产环境下较为有用,用特定的用户来运行 Node.js 应用可以在很大程度上限制网络攻击造成的破坏。