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