利用systemd部署golang项目的实现方法
简介
- centos 7 继承了 rhel 7 的新的特性,例如强大的 systemd, 而 systemd 的使用也使得以往系统服务的 /etc/init.d 的启动脚本的方式就此改变, 也大幅提高了系统服务的运行效率。但服务的配置和以往也发生了极大的不同,同时变的简单而易用了许多。
- centos 7 的服务 systemctl 脚本存放在:/usr/lib/systemd/,有系统 system 和用户 user 之分, 即:/usr/lib/systemd/system 和 /usr/lib/systemd/user
配置文件
- 这里我们先要说明一下 unit 的文件位置,一般主要有三个目录:
/lib/systemd/system /run/systemd/system /etc/systemd/system
- 这三个目录的配置文件优先级依次从低到高,如果同一选项三个地方都配置了,优先级高的会覆盖优先级低的。 系统安装时,默认会将 unit 文件放在 /lib/systemd/system 目录。如果我们想要修改系统默认的配置,比如 nginx.service,一般有两种方法:
- 在 /etc/systemd/system 目录下创建 nginx.service 文件,里面写上我们自己的配置。
- 在 /etc/systemd/system 下面创建 nginx.service.d 目录,在这个目录里面新建任何以.conf 结尾的文件,然后写入我们自己的配置。推荐这种做法。
- /run/systemd/system 这个目录一般是进程在运行时动态创建 unit 文件的目录,一般很少修改,除非是修改程序运行时的一些参数时,即 session 级别的,才在这里做修改。
服务配置
- 每一个服务以.service 结尾,一般会分为 3 部分:[unit]、[service] 和 [install],就以 nginx 为例吧,具体内容如下:
[unit] description=nginx - high performance web server documentation=http://nginx.org/en/docs/ after=network.target remote-fs.target nss-lookup.target [service] type=forking pidfile=/usr/local/nginx/logs/nginx.pid execstartpre=/usr/local/nginx/sbin/nginx -t -c /usr/local/nginx/conf/nginx.conf execstart=/usr/local/nginx/sbin/nginx -c /usr/local/nginx/conf/nginx.conf execreload=/bin/kill -s hup $mainpid execstop=/bin/kill -s quit $mainpid privatetmp=true [install] wantedby=multi-user.target
配置项说明
- 下面分别解释下着三部分的含义
[unit]
- description : 服务的简单描述
- documentation : 服务文档
- after= : 依赖,仅当依赖的服务启动之后再启动自定义的服务单元
[service]
- type : 启动类型 simple、forking、oneshot、notify、dbus
- - type=simple(默认值):systemd 认为该服务将立即启动,服务进程不会 fork。如果该服务要启动其他服务,不要使用此类型启动,除非该服务是 socket 激活型
- - type=forking:systemd 认为当该服务进程 fork,且父进程退出后服务启动成功。对于常规的守护进程(daemon),除非你确定此启动方式无法满足需求, 使用此类型启动即可。使用此启动类型应同时指定 pidfile=,以便 systemd 能够跟踪服务的主进程。
- - type=oneshot:这一选项适用于只执行一项任务、随后立即退出的服务。可能需要同时设置 remainafterexit=yes 使得 systemd 在服务进程退出之后仍然认为服务处于激活状态。
- - type=notify:与 type=simple 相同,但约定服务会在就绪后向 systemd 发送一个信号,这一通知的实现由 libsystemd-daemon.so 提供
- - type=dbus:若以此方式启动,当指定的 busname 出现在 dbus 系统总线上时,systemd 认为服务就绪。
- pidfile : pid 文件路径
- environment : 环境变量(可以添加多个)eg :environment=repo_ref=dev
- execstartpre :启动前要做什么,上文中是测试配置文件 -t
- execstart:启动
- execreload:重载
- execstop:停止
- privatetmp:true 表示给服务分配独立的临时空间
[install]
- wantedby:服务安装的用户模式,从字面上看,就是想要使用这个服务的有是谁?上文中使用的是:multi-user.target ,就是指想要使用这个服务的目录是多用户。
操作示例
- 每一个.target 实际上是链接到我们单位文件的集合,当我们执行
systemctl enable nginx.service
- 就会在 /etc/systemd/system/multi-user.target.wants/ 目录下新建一个 /usr/lib/systemd/system/nginx.service 文件的链接。
常用的 service 操作
# 自启动 systemctl enable nginx.service # 禁止自启动 systemctl disable nginx.service # 启动服务 systemctl start nginx.service # 停止服务 systemctl stop nginx.service # 重启服务 systemctl restart nginx.service # 查看unit定义文件 systemctl cat nginx.service # 编辑unit定义文件 systemctl edit nginx.service # 重新加载unit定义文件 systemctl reload nginx.service # 列出已启动的所有unit,就是已经被加载到内存中 systemctl list-units # 列出系统已经安装的所有unit,包括那些没有被加载到内存中的unit systemctl list-unit-files # 查看服务的日志 journalctl -u nginx.service # 还可以配合`-b`一起使用,只查看自本次系统启动以来的日志 # 查看所有target下的unit systemctl list-unit-files --type=target # 查看默认target,即默认的运行级别。对应于旧的`runlevel`命令 systemctl get-default # 设置默认的target systemctl set-default multi-user.target # 查看某一target下的unit systemctl list-dependencies multi-user.target # 切换target,不属于新target的unit都会被停止 systemctl isolate multi-user.target systemctl poweroff # 关机 systemctl reboot # 重启 systemctl rescue # 进入rescue模式
systemd + golang demo
- 下面例子通过 systemd 部署一个最简单的 golang web server
package main import ( "flag" "fmt" "log" "net/http" ) func main() { var address string flag.stringvar(&address, "address", "5353", "listen address") flag.parse() http.handlefunc("/", func(w http.responsewriter, r *http.request) { fmt.fprintf(w, "hello, this is a test for systemd !\n") }) // 设置访问路由 log.printf("starting server on %s\n", address) log.fatal(http.listenandserve(fmt.sprintf(":%s", address), nil)) }
- 编译代码,并将可执行文件同步到远程服务器上
cgo_enabled=0 goos=linux goarch=amd64 go build -o systemd-test main.go rsync -zp ./systemd-test root@gp-aliyun:/usr/local/bin/
- 在远程服务器上编写服务配置,放在 /etc/systemd/system/ 中
[unit] description=systemd test after=network.target [service] user=nobody # execute `systemctl daemon-reload` after execstart= is changed. execstart=/usr/local/bin/systemd-test -address "6060" [install] wantedby=multi-user.target
- 通过 systemctl 启动服务
# 每一次修改execstart都需执行 systemctl daemon-reload # 启动 systemctl start systemd-test.service # 查看状态 systemctl status systemd-test.service
- 状态如下
- 可以通过 curl 进行测试:
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。