https://www.freedesktop.org/software/systemd/man/systemd.service.html

https://blog.csdn.net/yuesichiu/article/details/51485147

服务路径

systemd有系统和用户区分：

  • 系统：/etc/systemd/system/
  • 用户：/usr/lib/systemd/system/

开机时，systemd只执行/etc/systemd/system/路径下的配置文件，建议在用户路径下创建，然后执行systemctl enabel mysqld，这个命令会在系统路径下创建一个链接，并且这个链接指向用户路径

服务文件

完整文件举例如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
[Unit]
Description=MySQL Server
Documentation=man:mysqld(8)
Documentation=http://dev.mysql.com/doc/refman/en/using-systemd.html
After=network.target
After=syslog.target
[Install]
WantedBy=multi-user.target
[Service]
User=mysql
Group=mysql
Type=forking
PIDFile=/var/run/mysql/mysqld.pid
TimeoutSec=0
ExecStart=/usr/local/mysql/bin/mysqld --daemonize --pid-file=/var/run/mysql/mysqld.pid $MYSQLD_OPTS
EnvironmentFile=-/etc/sysconfig/mysql
LimitNOFILE = 10000
Restart=on-failure
RestartPreventExitStatus=1
Environment=MYSQLD_PARENT_PID=1
PrivateTmp=false

所有的启动设置之前，都可以加上一个连词号（-），表示”抑制错误”，即发生错误的时候，不影响其他命令的执行。比如，EnvironmentFile=-/etc/sysconfig/mysql（注意等号后面的那个连词号），就表示即使/etc/sysconfig/mysql文件不存在，也不会抛出错误。

文件分为三个部分：

[Unit]

启动顺序与依赖关系

Description

字段给出当前服务的简单描述

Documentation

给出文档位置

Before

定义在哪些服务之前运行，Before=xxx.service，代表本服务在xxx.service启动之前启动。

After

定义在哪些服务之后运行

Requires

表示”强依赖”关系，即如果指定服务启动失败或异常退出，该服务也必须退出

Wants

“弱依赖”关系，即如果指定服务启动失败或异常退出，该服务不受影响继续运行

[Service]

定义如何启动当前服务

Type

定义启动类型。可以设置的值如下

  • simple（默认值）：ExecStart字段启动的进程为主进程

  • forking：ExecStart字段将以fork()方式启动，此时父进程将会退出，子进程将成为主进程；对于常规的守护进程（daemon），除非你确定此启动方式无法满足需求，使用此类型启动即可。使用此启动类型应同时指定 PIDFile=，以便systemd能够跟踪服务的主进程。

  • oneshot：类似于simple，但只执行一次，Systemd 会等它执行完，才启动其他服务

    下面是一个oneshot的例子，笔记本电脑启动时，要把触摸板关掉，配置文件可以这样写。

    1
    2
    3
    4
    5
    6
    7
    [Unit]
    Description=Switch-off Touchpad
    [Service]
    Type=oneshot
    ExecStart=/usr/bin/touchpad-off
    [Install]
    WantedBy=multi-user.target

    如果关闭以后，将来某个时候还想打开，配置文件修改如下。

    1
    2
    3
    4
    5
    6
    7
    8
    9
    [Unit]
    Description=Switch-off Touchpad
    [Service]
    Type=oneshot
    ExecStart=/usr/bin/touchpad-off start
    ExecStop=/usr/bin/touchpad-off stop
    RemainAfterExit=yes
    [Install]
    WantedBy=multi-user.target

  • dbus：类似于simple，但会等待 D-Bus 信号后启动

  • notify：类似于simple，启动结束后会发出通知信号，然后 Systemd 再启动其他服务

  • idle：类似于simple，但是要等到其他任务都执行完，才会启动该服务。一种使用场合是为让该服务的输出，不与其他服务的输出相混合

PIDFile

pid文件路径，一般路径都在/var/run/

ExecStart

启动进程时执行的命令

ExecReload

重启服务时执行的命令

ExecStop

停止服务时执行的命令

ExecStartPre

启动服务之前执行的命令

ExecStartPost

启动服务之后执行的命令

ExecStopPost

停止服务之后执行的命令

EnvironmentFile

指定当前服务的环境参数文件。该文件内部的key=value键值对，可以用$key的形式，在当前配置文件中获取。

1
2
3
4
[Service]
EnvironmentFile=/etc/sysconfig/sshd
ExecStart=/usr/sbin/sshd -D $OPTIONS
ExecReload=/bin/kill -HUP $MAINPID

Environment

TimeoutSec

LimitNOFILE

Restart

定义了 服务退出后，Systemd 的重启方式。Restart字段可以设置的值如下。

  • no（默认值）：退出后不会重启
  • on-success：只有正常退出时（退出状态码为0），才会重启
  • on-failure：非正常退出时（退出状态码非0），包括被信号终止和超时，才会重启
  • on-abnormal：只有被信号终止和超时，才会重启
  • on-abort：只有在收到没有捕捉到的信号终止时，才会重启
  • on-watchdog：超时退出，才会重启
  • always：不管是什么退出原因，总是重启

对于守护进程，推荐设为on-failure。对于那些允许发生错误退出的服务，可以设为on-abnormal。

RestartSec

表示 Systemd 重启服务之前，需要等待的秒数

RestartPreventExitStatus

PrivateTmp

True表示给服务分配独立的临时空间

RemainAfterExit

可设为”yes”或”no”(默认值)，表示当该服务的所有进程全部退出之后，是否依然将此服务视为活动(active)状态。这个选项只有在Type=oneshot时需要被配置

KillMode

定义 Systemd 如何停止 sshd 服务。

KillMode字段可以设置的值如下。

  • control-group（默认值）：当前控制组里面的所有子进程，都会被杀掉
  • process：只杀主进程
  • mixed：主进程将收到 SIGTERM 信号，子进程收到 SIGKILL 信号
  • none：没有进程会被杀掉，只是执行服务的 stop 命令。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
[Unit]
Description=OpenSSH server daemon
Documentation=man:sshd(8) man:sshd_config(5)
After=network.target sshd-keygen.service
Wants=sshd-keygen.service

[Service]
EnvironmentFile=/etc/sysconfig/sshd
ExecStart=/usr/sbin/sshd -D $OPTIONS
ExecReload=/bin/kill -HUP $MAINPID
Type=simple
KillMode=process
Restart=on-failure
RestartSec=42s

上面这个例子中，将KillMode设为process，表示只停止主进程，不停止任何sshd 子进程，即子进程打开的 SSH session 仍然保持连接。这个设置不太常见，但对 sshd 很重要，否则你停止服务的时候，会连自己打开的 SSH session 一起杀掉。

[Install]

定义如何安装这个配置文件，即怎样做到开机启动

WantBy

表示该服务所在的target，target的含义是服务组，表示一组服务。WantedBy=multi-user.target指的是，当前服务所在的target是multi-user.target。这个设置非常重要，因为执行systemctl enable mysqld.service命令时，mysqld.service的一个符号链接，就会放在/etc/systemd/system目录下面的multi-user.target.wants子目录之中。

  • systemd 有默认的启动 target
1
2
[root@zhang ~]# systemctl get-default
multi-user.target

上面的结果表示，默认的启动target是multi-user.target。在这个组里的所有服务，都将开机启动。这就是为什么systemctl enable命令能设置开机启动的原因。

  • 查看 multi-user.target 包含的所有服务
1
systemctl list-dependencies multi-user.target
  • 切换到另一个 target
1
2
# shutdown.target 就是关机状态
sudo systemctl isolate shutdown.target

一般来说，常用的 Target 有两个：一个是multi-user.target，表示多用户命令行状态；另一个是graphical.target，表示图形用户状态，它依赖于multi-user.target。官方文档有一张非常清晰的 Target 依赖关系图。

重新加载

修改配置文件之后，需要重新加载配置文件

1
systemctl daemon-reload

操作服务

重载服务

1
2
3
4
5
# 就会在/etc/systemd/system/multi-user.target.wants/目录下新建一个/usr/lib/systemd/system/mysql.service 文件的链接
systemctl enable mysql.service
# 相对应，可以用 disable 把它从 wants 目录给删除。
systemctl disable mysql.service
systemctl reload mysql.service

启动停止重启

1
2
3
4
5
6
7
systemctl start mysql.service

systemctl stop mysql.service

systemctl restart mysql.service

systemctl kill mysql.service

查看状态日志

1
2
3
systemctl status mysql.service

journalctl -f -u mysql.service