编写 systemctl 入门

刺骨的言语ヽ痛彻心扉 2024-03-30 13:03 47阅读 0赞

> 下文是使用教程记录。

#### 文章目录 ####

*  说明
 *   *   *  \[Unit\]部分详解
         *  \[Service\]部分详解
         *  \[Install\]部分详解
     *  启动服务
 *  实操案例

## 说明 ##

sshd 服务的 unit 配置文件如下所示，主要分为三部分：\[Unit\]、\[Service\] 和 \[Install\]

`/root/systemd/system/myserver@.service`

[root@vm03 ~]# cat /usr/lib/systemd/system/sshd.service
    [Unit]
    Description=OpenSSH server daemon
    Documentation=man:sshd(8) man:sshd_config(5)
    After=network.target sshd-keygen.service
    Wants=sshd-keygen.service
    
    [Service]
    Type=notify
    EnvironmentFile=/etc/sysconfig/sshd
    ExecStart=/usr/sbin/sshd -D $OPTIONS
    ExecReload=/bin/kill -HUP $MAINPID
    KillMode=process
    Restart=on-failure
    RestartSec=42s
    
    [Install]
    WantedBy=multi-user.target

--------------------

#### \[Unit\]部分详解 ####

此部分中使用的参数不仅限于 service 类型的 unit，对其它类型 unit 也是通用的，有关这些参数及其说明的完整列表，可运行命令 man systemd.unit 或访问 systemd.unit 中文手册

注意：在 \[unit\] 块中的每个参数后都可以指定一个以空格分隔的列表

Description：当前 unit 的描述  
Documentation：文档地址，仅接受类型为：http://、https://、file:、info:、man: 的URI  
Requires：表示本 unit 与其它 unit 之间存在强依赖关系，如果本 unit 被激活，此处列出的 unit 也会被激活，如果其中一个依赖的 unit 无法激活，systemd 都不会启动本 unit  
Wants：与 Requires 类似，区别在于如果依赖的 unit 启动失败，不影响本 unit 的继续运行  
After：表示本 unit 应该在某服务之后启动，选项可参考 systemd.special 中文手册  
Before：表示本 unit 应该在某服务之前启动，After和Before 字段只涉及启动顺序，不涉及依赖关系  
BindsTo：与 Requires 类似，当指定的 unit 停止时，也会导致本 unit 停止  
PartOf：与 Requires 类似，当指定的 unit 停止或重启时，也会导致本 unit 停止或重启  
Conflicts：如果指定的 unit 正在运行，将导致本 unit 无法运行  
OnFailure：当本 unit 进入故障状态时，激活指定的 unit

--------------------

#### \[Service\]部分详解 ####

service专有参数  
只有 service 类型的 unit 才有这些参数，参数完整列表请访问 systemd.service 中文手册 或 systemd.service

simple（默认值）：服务为主进程启动，systemd 认为该服务将立即启动，服务进程不会 fork ，如果该服务要启动其他服务，则不要使用此类型启动，除非该服务是 socket 激活型。  
forking：服务将以fork分叉的方式启动，此时父进程将会退出，子进程将成为主进程。systemd 认为当该服务进程 fork，且父进程退出后服务启动成功。对于常规的守护进程（daemon）除非你确定此启动方式无法满足需求，否则使用此类型启动即可。使用此启动类型应同时指定 PIDFile= 以便 systemd 能够跟踪服务的主进程  
oneshot：类似于simple，但只执行一次，Systemd会等它执行完，才启动其它服务。这一选项适用于只执行一项任务，随后立即退出的服务。可能需要同时设置 RemainAfterExit=yes 使得 systemd 在服务进程退出之后仍然认为服务处于激活状态  
dbus：类似于simple，但会等待D-Bus信号后启动。当指定的 BusName 出现在DBus系统总线上时，systemd 认为服务就绪。  
notify：类似于simple，启动完毕后会通知 Systemd ，然后继续往下执行  
idle：类似于simple，但是要等到其它所有任务都执行完，才会启动该服务  
RemainAfterExit：一个布尔值，它指定即使服务的所有进程都已退出，也应将服务视为活动的，默认为 no

GuessMainPID：一个布尔值，指定systemd在无法可靠确定服务的主 PID 时是否应该猜测它。除非设置了 Type=forking 并且未设置 PIDFile，否则此选项将被忽略，默认为 yes

PIDFile：指向此守护进程的 PID 文件的绝对文件名。对于 Type=forking 的服务，建议使用此选项。Systemd 在服务启动后读取守护进程的主进程的 PID。Systemd 不会写入此处配置的文件，但它会在服务关闭后删除该文件

BusName：到达此服务的 D-Bus 总线名称。对于 Type=dbus 的服务，此选项是必需的

ExecStart：服务启动时执行的命令和参数

ExecStartPre: 服务启动之前执行的命令

ExecStartPost: 服务启动之后执行的命令

ExecReload：重启服务时执行的命令

ExecStop：服务停止时执行的命令和参数

ExecStopPost：服务停止之后执行的命令

RestartSec：重新启动服务前的睡眠时间（以秒为单位）

TimeoutStartSec：等待服务启动的时间（以秒为单位）

TimeoutStopSec：等待服务停止的时间（以秒为单位）

TimeoutSec：同时配置TimeoutStartSec和TimeOutshopSec的缩写

Restart：配置当服务的进程退出、被杀死或达到超时时是否重新启动服务，可以设置的值如下：

no 服务将不会重新启动，这是默认设置  
on-success 仅当服务进程完全退出时重新启动（退出代码0）  
on-failure 仅在服务进程异常退出时重启，所谓“异常退出”是指：退出码不为"0"  
on-abnormal 如果进程因信号或超时而终止时重新启动  
on-watchdog 当看门狗超时而重新启动  
on-abort 如果进程由于未指定为干净退出状态的未捕获信号而退出，则重新启动  
always 总是重新启动  
Environment：指定环境变量

KillMode：定义systemd如何停止服务，可以设置的值如下:

control-group（默认值）：当前控制组里面的所有子进程，都会被杀掉  
process：只杀主进程  
mixed：主进程将收到SIGTERM信号，子进程收到SIGKILL信号  
none：没有进程会被杀掉，只是执行服务的stop命令

--------------------

#### \[Install\]部分详解 ####

\[install\] 定义了 unit 的安装信息，此部分配置仅在 systemctl enable 或 systemctl disable 时使用，在 unit 运行时不解释此部分，相当于是配置如何开机启动

此部分中使用的参数不仅限于service类型的unit，对其它类型的 unit也是通用的，有关这些参数及其说明的完整列表，可运行命令 man systemd.unit 或访问 systemd.unit 中文手册

Alias：当前 unit 可用于启动的别名，此处列出的名称必须与服务文件名具有相同的后缀（即类型），在执行 systemctl enable 时将创建从这些名称到 unit 文件名的符号链接  
RequiredBy：表示该服务所在的Target，它的值是一个或多个Target，当 systemctl enable 时 unit 符号链接会放入 /etc/systemd/system 目录下面以 Target名 + .required 后缀构成的子目录中  
WantedBy：表示该服务所在的Target，它的值是一个或多个Target，当前 systemctl enable 时 unit符号链接会放入 /etc/systemd/system 目录下面以 Target名 + .wants 后缀构成的子目录中  
Also：当 systemctl enable 或 systemctl disable 时会同时 enable 和 disable 的其它 unit 列表

### 启动服务 ###

> systemctl status (服务名)

> systemctl restart (服务名)

## 实操案例 ##

> 指定启动参数的方式，比如：

systemctl restart helloapp@web
    
    systemctl  status   helloapp@web

文件存放目录: `/etc/systemd/system`

文件名: `helloapp@.service`

[Unit]
    Description=helloapp %i
    After=network.target
    
    [Service]
    Type=simple
    User=root
    Group=root
    WorkingDirectory=/home/s/apps
    ExecStart=/home/s/apps/helloapp %i -c config.hcl
    Restart=always
    
    [Install]
    WantedBy=multi-user.target

如果你还有其他疑问，评论区留言讨论

--------------------

王哥的学习路线：[http://luxian.javapub.net.cn/][http_luxian.javapub.net.cn]

[http_luxian.javapub.net.cn]: http://luxian.javapub.net.cn/