Service Unit
systemctl命令基于systemd,Linux规范中介绍,可将Service Unit文件存放于如下三个目录中,我们一般使用第一个目录,来存放对应的service文件;优先级最高的/etc/systemd/system/多存放系统的wants文件夹,当我们配置服务开机自启动时,软链接会自动创建到对应文件夹下,/run/systemd/system/文件仅存放服务自己产生的对应文件,所以下面两个目录不建议使用。
配置完对应Service Unit配置文件后,执行如下命令,重新加载daemon,系统将会加载到对应的.service配置文件,之后我们将可以使用systemctl命令管理对应组件
[root@hostname] # systemctl daemon-reload
systemctl支持start(启动服务),stop(停止服务),restart(重启服务),enable(设置开机自启),disable(关闭开机自启),status(查看服务状态),执行status命令样例如下:
[root@hostname] # systemctl status sshd.service
● sshd.service - OpenSSH server daemon
Loaded: loaded (/usr/lib/systemd/system/simplehttp.service; bad; vendor preset: disabled)
Active: active (running) since 四 2023-07-06 16:45:08 CST; 6s ago
Main PID: 24511 (python)
CGroup: /system.slice/system-hostos.slice/sshd.service
└─6342 /user/sbin/sshd -D
9月 09 16:45:08 localhost systemd[1]: Started SSHD Service.
注意:如配置完对应unit的service文件并daemon-reload后,该程序处于启动状态,systemctl status 该服务名,无法正常获取该服务状态,需要通过普通命令方式将该服务停止,并通过systemctl启动,后续systemctl命令与普通启停服务命令不要混用,配置正常的情况下,仅使用systemctl管理即可
常用Linux组件service文件配置:
Nginx
[root@hostname] # vi /usr/lib/systemd/system/nginx.service
[Unit]
Description=Nginx
After=network.target
[Service]
Type=forking
PIDFile=/usr/local/nginx/logs/nginx.pid
ExecStart=/usr/local/nginx/sbin/nginx -c /usr/local/nginx/conf/nginx.conf
ExecReload=/usr/local/nginx/sbin/nginx -s reload
ExecStop=/usr/local/nginx/sbin/nginx -s stop
PrivateTmp=true
[Install]
WantedBy=multi-user.target
Redis
redis启动会在/var/run/下生成pid文件,因此可以使用PIDFile参数获取对应的pid,重启和停止服务参数可配置kill对应pid,参数配置如下,类似会生成pid文件的组件,可按照该配置。
[root@hostname] # vi /usr/lib/systemd/system/redis.service
[Unit]
Description=Redis
After=network.target
[Service]
Type=forking
PIDFile=/var/run/redis_6379.pid
ExecStart=/usr/local/redis/redis-server /usr/local/redis/redis.conf
ExecReload=/bin/kill -s HUP $MAINPID
ExecStop=/bin/kill -s QUIT $MAINPID
PrivateTmp=true
[Install]
WantedBy=multi-user.target
nacos
nacos在日常普通命令启动中,通过配置/etc/profile中java环境变量的形式,可以正常启动,但使用systemctl这种systemd形式,需要重新指定Environment环境参数,可通过which java,查看具体java目录,配置到对应的value中,Environment中参数配置如下;如果已经在nacos启动文件头部加入JAVA_HOME参数 ,可不加该配置,两种方法皆可,以下如zookeeper,kafka等需要javac的组件,皆与之相同
[root@hostname] # vi /usr/lib/systemd/system/nacos.service
[Unit]
Description=nacos
After=network.target
[Service]
Type=forking
Environment='JAVA_HOME=/usr/local/src/java'
ExecStart=/usr/local/nacos/bin/startup.sh -m standalone
ExecStop=/usr/local/nacos/bin/shutdown.sh
PrivateTmp=true
[Install]
WantedBy=multi-user.target
kafka与zookeeper
环境变量配置问题见nacos中介绍,kafka启动需要依赖zookeepr,所以要先配置zookeeper.service自启动,并且kafka配置中配置After zookeeper.servie,即在zookeeper启动后,启动kafka,详情配置如下:
[root@hostname] # vi /usr/lib/systemd/system/zookeeper.service
[Unit]
Description=Zookeeper
After=network.target
[Service]
Type=forking
Environment='JAVA_HOME=/usr/local/src/java'
ExecStart=/usr/local/src/zookeeper-3.4.13/bin/zkServer.sh start
ExecReload=/usr/local/src/zookeeper-3.4.13/bin/zkServer.sh restart
ExecStop=/usr/local/src/zookeeper-3.4.13/bin/zkServer.sh stop
PrivateTmp=true
[Install]
WantedBy=multi-user.target
[root@hostname] # vi /usr/lib/systemd/system/kafka.service
[Unit]
Description=Kafka
After=network.target zookeeper.service
[Service]
Type=forking
Environment='JAVA_HOME=/usr/local/src/java'
ExecStart=/usr/local/src/kafka_2.12-2.2.0/bin/kafka-server-start.sh -daemon /usr/local/src/kafka_2.12-2.2.0/config/server.properties
ExecStop=/usr/local/src/kafka_2.12-2.2.0/bin/kafka-server-stop.sh
PrivateTmp=true
[Install]
WantedBy=multi-user.target
minio
[root@hostname] # vi /usr/lib/systemd/system/minio.service
[Unit]
Description=minio
After=network.target
[Service]
Type=simple
ExecStart=/data1/miouser/disk1/minio server --address 0.0.0.0:9000 --console-address 0.0.0.0:9005 /data1/miouser/disk1
ExecStop=pkill minio
PrivateTmp=true
[Install]
WantedBy=multi-user.target
logstash
类似logstash与minio等组件,没有特定的stop方式,可不进行配置,依然可以实现通过 systemctl stop &服务名 方式停止,没有配置ExecStop,Systemd 默认将发送SIGTERM信号到主进程,linux介绍中提到 ExecStop=除非您有其他关闭服务的方法,否则您无需指示。
[root@hostname] # vi /usr/lib/systemd/system/logstash.service
[Unit]
Description=logstash
After=network.target
[Service]
Type=simple
Environment='JAVA_HOME=/usr/local/jdk'
ExecStart=/usr/local/logstash/bin/logstash -daemon /usr/local/logstash/filter.conf
Restart=always
[Install]
WantedBy=multi-user.target
elasticsearch
[root@hostname] # vi /usr/lib/systemd/system/logstash.service
[Unit]
Description=elasticsearch
[Service]
Type=forking
User=elk
Group=elk
ExecStart=/usr/local/elk/elasticsearch/bin/elasticsearch -d
Restart=always
[Install]
WantedBy=multi-user.target
mysql
[root@hostname] # vi /usr/lib/systemd/system/mysql.service
[Unit]
Description=MySQL Server
After=network.target
[Service]
Type=forking
User=mysql
Group=mysql
ExecStart=/usr/local/mysql/bin/mysqld_safe --defaults-file=/etc/my.cnf --datadir=/var/lib/mysql --pid-file=/var/run/mysqld/mysqld.pid --socket=/var/run/mysqld/mysqld.sock
ExecStop=/usr/local/mysql/bin/mysqladmin -u root -p shutdown
Restart=always
[Install]
WantedBy=multi-user.target
持续更新其他组件
Service Unit配置文件参数详解
[Unit]
所有 Unit 文件通用, 该部分主要是对这个服务的说明,以及配置与其他服务的关系。 参数详解如下:
Description : 一段描述这个 Unit 文件的文字,通常只是简短的一句话。
Documentation:指定服务的文档,可以是一个或多个文档的URL路径。
Requires:依赖的其他 Unit 列表,列在其中的 Unit 模块会在这个服务启动的同时被启动,并且如果其中有任意一个服务启动失败,这个服务也会被终止
After:与 Requires 相似,但会在后面列出的所有模块全部启动完成以后,才会启动当前的服务。 Before:与 After 相反,在启动指定的任一个模块之前,都会首先确保当前服务已经运行。 注意:Before=, After= 是配置服务间的启动顺序,比如一个 foo.service 包含了一行 Before=bar.service,那么当他们同时启动时,bar.service 会等待 foo.service 启动完成后才启动。注意这个设置和 Requires= 的相互独立的,同时包含 After= 和 Requires= 也是常见的。此选项可以指定多次,然后按顺序全部启动
Wants:与 Requires 相似,但只是在被配置的这个 Unit 启- 动时,触发启动列出的每个 Unit 模块,而不去考虑这些模块启动是否成功。
Conflicts:与这个模块有冲突的模块,如果列出模块中有已经在运行的,这个服务就不能启动,反之亦然。 注意:如果这里列出的服务启动,那么本服务就会停止,反之亦然 ,即后启动的才起作用。注意,此设置和 After= 和 Before= 是互相独立的。
OnFailure:当这个模块启动失败时,就自动启动列出的每个模块。
PartOf :该参数仅作用于单元的停止或重启。其含义是,当停止或重启这里列出的某个单元时, 也会同时停止或重启该单元自身。 注意,这个依赖是单向的, 该单元自身的停止或重启并不影响这里列出的单元。如果 a.service 中包含了 PartOf=b.service ,那么这个依赖关系将在 b.service 的属性列表中显示为 ConsistsOf=a.service 。 也就是说,不能直接设置 ConsistsOf= 依赖。
[Service]
Service 段是服务(Service)类型的 Unit 文件(后缀为 .service)特有的,用于定义服务的具体管理和执行动作,参数详解如下:
Type: 设置进程的启动类型。必须设为 simple, exec, forking, oneshot, dbus, notify, idle 之一,默认的 simple 类型可以适应于绝大多数的场景,因此一般可以忽略这个参数的配置。而如果服务程序启动后会通过 fork 系统调用创建子进程,然后关闭应用程序本身进程的情况,则应该将 Type 的值设置为 forking,否则 systemd 将不会跟踪子进程的行为,而认为服务已经退出。其他类型说明见文章附录 Environment: 为服务添加环境变量
EnvironmentFile:指定加载一个包含服务所需的环境参数的文件,文件中的每一行都是一个环境变量的定义。
ExecStart:这个参数是几乎每个 .service 文件都会有的,指定服务启动的主要命令,在每个配置文件中只能使用一次。需要使用绝对路径
ExecStartPre:指定在启动执行 ExecStart 的命令前的准备工作,可以有多个,所有命令会按照文件中书写的顺序依次被执行。
ExecStartPost: 指定在启动执行 ExecStart 的命令后的收尾工作,也可以有多个。
ExecStop: 停止服务所需要执行的主要命令。需要使用绝对路径 ExecStopPost:指定在 ExecStop 命令执行后的收尾工作,也可以有多个。
ExecReload:重新加载服务文件所需执行的主要命令。需要使用绝对路径
Restart:这个值用于指定在什么情况下需要重启服务进程,这些不同的值分别表示了在哪些情况下,服务会被重新启动,如下: no(默认值):退出后不会重启 always:除了用systemctl stop 或等价的服务停止操作命令,其他情况都可以重启 on-success:只有正常退出时(退出状态码为0),才会重启
on-failure:非正常退出时(退出状态码非0),包括被信号终止和超时,才会重启(守护进程,推荐值) on-abnormal:只有被信号终止和超时,才会重启(对于允许发生错误退出的服务,推荐值)
on-abort:只有在收到没有捕捉到的信号终止时,才会重启
on-watchdog:超时退出,才会重启
RestartSec: 如果服务需要被重启,这个参数的值为服务被重启前的等待秒数。注意,该重启等待时间只针对上面Restart的参数值起作用时的重启才有效,比如说:因Unit段配置的关系或者人为使用systemctl restart命令导致该服务重启时,该参数无效,会马上重启
Nice:服务的进程优先级,值越小优先级越高,默认为0。-20为最高优先级,19为最低优先级。 WorkingDirectory:指定服务的工作目录。
RootDirectory:指定服务进程的根目录( / 目录),如果配置了这个参数后,服务将无法访问指定目录以外的任何文件。
User:指定运行服务的用户,会影响服务对本地文件系统的访问权限。可使用root
Group:指定运行服务的用户组,会影响服务对本地文件系统的访问权限。
PrivateTmp:是否给服务分配独立的临时空间(true/false)
[Install]
Install段是服务的安装信息,它不在 systemd 的运行期间使用,只在使用 systemctl enable 和 systemctl disable 命令启用/禁用服务时有用,所有 Unit 文件通用,用来定义如何启动,以及是否开机启动,参数详解如下:
WantedBy:它的值是一个或多个 target,执行enable命令时,符号链接会放入/etc/systemd/system目录下以 target 名 + .wants后缀构成的子目录中。“WantedBy=multi-user.target” 表明当系统以多用户方式(默认的运行级别)启动时,这个服务需要被自动运行。当然还需要 systemctl enable 激活这个服务以后自动运行才会生效 RequiredBy:依赖当前服务的模块。它的值是一个或多个 target,执行enable命令时,符号链接会放入/etc/systemd/system目录下以 target 名 + .required后缀构成的子目录中
Alias:当前 Unit 可用于启动的别名
Also:当前 Unit 被 enable/disable 时,会被同时操作的其他 Unit
systemctl命令详解
#当新增或修改service单元文件时,需要系统重新加载所有修改过的配置文件
systemctl daemon-reload
#设置为开机自启动
systemctl enable 服务名.service
#关掉开机启用
systemctl disable 服务名.service
#启动服务
systemctl start 服务名.service
#重启服务,相当于先stop,再start
systemctl restart 服务名.service
#关闭服务,关闭服务后,进程会全部被kill掉
systemctl stop 服务名.service
#查看服务的状态
systemctl status 服务名.service
#查看服务是否开机启动
systemctl is-enabled 服务名.service
#查看已启动的服务列表
systemctl list-unit-files|grep enabled
#
显示所有已启动的服务
systemctl list-units --type=service
#查看启动失败的服务列表
systemctl --failed
# 杀死一个服务的所有子进程
systemctl kill 服务名.service
# 重新加载一个服务的配置文件
systemctl reload 服务名.service
#移除标记为丢失的 Unit 文件。在删除 Unit 文件后,由于缓存的关系,
#即使通过 daemon-reload 更新了缓存,在 list-units 中依然会显示标记为 not-found 的 Unit
systemctl reset-failed 服务名.service