sysmaster使用说明

本章主要通过一些实例来带领用户初步使用 sysmaster，例如:

• 如何创建 service服务单元配置文件。
• 如何管理单元服务，例如启动、停止、查看服务。

创建单元配置文件

用户可以在 /usr/lib/sysmaster/system/目录下创建单元配置文件。

单元配置文件的类型

当前 sysmaster支持 target、socket、service类型的单元配置文件。

• target：封装了一个由 sysmaster管理的启动目标，用于将多个单元集中到一个同步点。sysmaster提供不同阶段的 target单元，例如 multi-user.target代表系统已完成启动，用户可以依赖此目标，启动自己的服务。
• socket：封装了一个用于进程间通信的套接字 socket， 以支持基于套接字的启动。例如用户可以配置 service单元依赖此 socket，当此 socket有数据写入时，sysmaster会拉起对应的 service单元。
• service：封装了一个被 sysmaster监视与控制的进程。

单元配置文件的构成

单元配置文件通常由3块组成：

• Unit：单元的公共配置说明，如服务名称、描述、依赖关系等。
• Install：描述如何安装和启动服务。
• Service、Socket：各个单元类型的配置。

创建service单元配置

sshd服务被用来远程登录到服务器，并在远程终端上执行命令和操作。 使用如下配置项来创建一个 sshd.service服务单元配置。

[Unit]
Description="OpenSSH server daemon"
Documentation="man:sshd(8) man:sshd_config(5)"
After="sshd-keygen.target"
Wants="sshd-keygen.target"

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

[Install]
WantedBy="multi-user.target"

以下是对单元配置文件中选项配置的说明，更多可以查阅官方手册。

• Description：说明该 unit的主要功能。
• Documentation：说明该 unit的文档链接。
• After：配置同时启动的单元的先后顺序，sshd.service服务将在 sshd-keygen.target之后启动。
• Wants：配置一个单元对另一个单元的依赖，启动 sshd.service服务，将会自动启动 sshd-keygen.target。
• Type：配置 sysmaster 如何启动此服务，notify表明需要主进程启动完成后发送通知消息。
• EnvironmentFile：设置环境变量的文件读取路径。
• ExecStart：配置服务启动时执行的命令，启动 sshd.service服务会执行 sshd命令。
• ExecReload：配置重新加载 sshd.service的配置时执行的命令。
• KillMode：配置当需要停止服务进程时，杀死服务进程的方法，process表示只杀死主进程。
• Restart：配置服务不同情况下退出或终止，是否重新启动服务，on-failure表示当服务非正常退出时重新启动服务。
• RestartSec：配置当服务退出时，重新拉起服务的间隔时间。
• WantedBy：配置依赖当前 sshd.service服务的单元。

管理单元服务

sctl是 sysmaster的命令行工具，用于检查和控制 sysmaster服务端行为和各个服务的状态，它可以启动、停止、重启、检查系统服务。

启动服务

使用以下命令可以启动 sshd服务和运行 ExecStart所配置的命令。

sctl start sshd.service

停止服务

使用以下命令可以停止 sshd服务，杀死 ExecStart所运行的进程。

sctl stop sshd.service

重启服务

使用以下命令可以重启 sshd服务，该命令会先停止后启动服务。

sctl restart sshd.service

查看服务状态

使用以下命令可以查看服务 sshd运行状态，用户可以查看服务的状态来获取服务是否正常运行。

sctl status sshd.service