如何编写一个生产级 Systemd 服务配置文件?

在大多数 Linux 发行版中,systemd 已成为默认的初始化系统和服务管理器,负责启动、监控和管理系统服务。如果将自己写的应用程序通过systemd进行管理,这就需要编写相应的服务配置文件。接下来,将讲解如何编写一个生产级的服务配置文件。

步骤1:基本了解 Service 配置文件的结构

systemd 服务配置文件通常位于 /etc/systemd/system/ 目录下,并且以 .service 结尾。一个 systemd 服务文件包含多个部分,每个部分以方括号 [Section] 开头,并包含具体的配置项。

常见部分:

  • [Unit]:定义服务的基本信息和元数据。
  • [Service]:定义服务的执行方式、环境等。
  • [Install]:定义如何将服务安装到系统中。

步骤2:编写 Service 配置文件

我们将以一个典型的 Web 服务为例,假设你有一个名为 myapp 的 Web 应用,已经准备好一个启动脚本,位于 /opt/myapp/start.sh。

[Unit]
Description=MyApp Web Service
After=network.target


[Service]
ExecStart=/bin/bash /opt/myapp/start.sh
ExecStop=/bin/bash /opt/myapp/stop.sh
WorkingDirectory=/opt/myapp
Restart=always
User=myuser
Group=mygroup
Environment=ENV_VAR=value
LimitNOFILE=65536
TimeoutStartSec=30
TimeoutStopSec=20
StandardOutput=journal
StandardError=journal
SyslogIdentifier=myapp


[Install]
WantedBy=multi-user.target

[Unit] 部分

  • Description:简要描述该服务的功能,通常是服务的名字和作用。
  • After:定义服务的启动顺序。network.target 表示服务应该在网络服务启动后启动。

[Service] 部分

  • ExecStart:定义启动服务的命令。在这里,我们使用 /bin/bash 来执行启动脚本 /opt/myapp/start.sh。
  • ExecStop:定义停止服务时需要执行的命令。你可以指定一个停止脚本或命令来关闭服务。
  • WorkingDirectory:指定服务的工作目录。这个目录是服务启动时的当前工作目录。
  • Restart:定义服务崩溃后的重启策略。always 表示如果服务崩溃或停止,systemd 将会自动重新启动它。
  • User 和 Group:指定运行该服务的用户和用户组。运行服务时以指定的用户身份执行,确保服务的权限控制。
  • Environment:设置环境变量供服务使用。在此示例中,ENV_VAR=value 是一个示例环境变量,实际使用时根据需求配置。
  • LimitNOFILE:限制服务可以打开的最大文件描述符数。对于高并发的服务,这个值可能需要增加。
  • TimeoutStartSec 和 TimeoutStopSec:指定启动和停止服务时的超时设置。这里分别设置了启动超时为 30 秒,停止超时为 20 秒。
  • StandardOutput 和 StandardError:定义服务的标准输出和标准错误输出的位置。journal 表示将输出发送到 systemd 的日志管理系统中(journalctl 查看)。
  • SyslogIdentifier:服务的日志标识符,方便在 syslog 或 journalctl 中区分不同服务的日志。

[Install] 部分

  • WantedBy:定义服务的目标。multi-user.target 表示服务将在系统进入多用户模式时启动。你可以选择不同的目标,控制服务在系统不同阶段的启动。

步骤3:将服务文件放入正确的目录

将上述服务配置文件保存到 /etc/systemd/system/ 目录下,文件名为 myapp.service(可以根据实际需求修改文件名)。

vi /etc/systemd/system/myapp.service

步骤4:重新加载 systemd 配置

每次修改或添加新的服务配置文件时,需要重新加载 systemd 配置,确保新服务文件生效。

systemctl daemon-reload

步骤5:启动服务并设置开机自启

启动服务systemctl start myapp
查看服务状态systemctl status myapp
设置开机自启systemctl enable myapp
步骤6:管理服务

停止服务

systemctl stop myapp

重新启动服务

systemctl restart myapp

查看服务日志

journalctl -u myapp

总结

  • systemd 服务配置文件具有多个部分(如 [Unit]、[Service]、[Install]),每个部分负责不同的配置任务。
  • 一个生产级的服务配置文件需要考虑到服务的启动顺序、用户权限、重启策略、资源限制、日志输出等。
  • 配置完成后,使用 systemctl 命令启动、管理服务并设置开机自启。
↑