平滑重启( 热重启)是指 WebServer 在重启的时候不会中断已有请求的执行。该特性在不同的项目版本发布的时候特别有用，例如，当需要先后发布两个版本： A、 B，那么在 A 执行的过程当中，我们可以将 B 的程序发布 直接覆盖 A 的程序， 并使用平滑重启特性(使用 Web 或者 命令行)无缝地将请求过渡到新版本的服务中。

GoFrame 框架支持非常方便的 Web管理功能，也就是说我们可以通过Web页面/接口直接进行 Server 的重启/关闭等管理操作。同时，框架也支持通过 命令行终端指令(仅限 *nix 系统)的形式进行 Server 的重启/关闭等管理操作。

特性开启

默认情况下平滑重启特性是关闭的，可以通过 graceful 配置选项打开，具体请查看 WebServer 的配置管理章节： 服务配置-配置文件模板

平滑重启特性 - 图1提示

目前平滑重启特性需要在本地随机打开一个端口的 tcp 监听服务用于新老进程通信交换状态信息。

注意事项

  • 该特性仅限于 *nix 系统( Linux/Unix/FreeBSD 等等)，在 Windows 下仅支持完整重启功能（请求无法平滑过渡）。
  • 测试平滑重启特性时请不要使用 IDE run(例如 Goland)或者 go run 命令来运行进程，因为这两种方式本身会创建父进程来管理运行的 Go 进程，会引起平滑重启时子父进程状态交换的失败。
  • 后续示例中的 SetGraceful 配置方法在 v2.7.4 版本后新增，低于 v2.7.4 版本请使用配置管理方式启用平滑重启特性。

管理方法

我们先来看一下WebServer中涉及到管理操作方法有哪些：

  2.           func (s *Server) Restart
  3.           (newExeFilePath...
  4.           string
  5.           ) error
  6. func (s *Server) Shutdown
  7.           (
  8.           ) error
  10. func (s *Server) EnableAdmin
  11.           (pattern ...
  12.           string
  13.           )

Restart 用于重启服务（ *nix 系统下为平滑重启， windows 下为完整重启）， Shutdown 用于关闭服务， EnableAdmin 用于将管理页面注册到指定的路由规则上，默认地址是 /debug/admin(我们可以指定一个私密的管理地址，也可以使用中间件来对该页面进行鉴权)。

以下对其中两个方法做详细说明。

Restart

Restart 的参数可指定自定义重启的可执行文件路径( newExeFilePath)，不传递时默认为原可执行文件路径。特别是在windows系统下，当可执行文件正在使用时，无法对其进行文件替换更新（新版本文件替换老版本文件）。当指定自定义的可执行文件路径后， Server 重启时将会执行新版本的可执行文件，不再使用老版本文件，这种特性简化了在某些系统上的版本更新流程。

EnableAdmin

  • 首先，该方法为用户管理 Server 提供了简便的页面和接口，在单 Server 下管理非常方便，直接访问管理页面点击对应链接即可。需要注意的是，由于带有管理功能，如果是在生产环境上，建议自定义该管理地址为一个私密地址。
  • 同时， EnableaAdmim 提供的 restart 接口也支持自定义可执行文件路径，直接通过GET参数往restart接口传递 newExeFilePath 变量即可，例如： http://127.0.0.1/debug/admin/restart?newExeFilePath=xxxxxxx
  • 此外，在大多数时候， Server 往往不只有1个节点，因此大多数服务管理运维中，例如：重启操作，当然不是直接访问每个 Server 的 admin 页面手动执行重启操作。而是充分利用 admin 页面提供的功能接口，通过接口控制来实现统一的 Server 管理控制。

示例1：基本使用

  1. package main
  3. import (
  4.     "time"
  6.     "github.com/gogf/gf/v2/frame/g"
  7.     "github.com/gogf/gf/v2/net/ghttp"
  8.     "github.com/gogf/gf/v2/os/gproc"
  9. )
  11. func main() {
  12.     s := g.Server()
  13.     s.BindHandler("/", func(r *ghttp.Request) {
  14.         r.Response.Writeln("哈喽！")
  15.     })
  16.     s.BindHandler("/pid", func(r *ghttp.Request) {
  17.         r.Response.Writeln(gproc.Pid())
  18.     })
  19.     s.BindHandler("/sleep", func(r *ghttp.Request) {
  20.         r.Response.Writeln(gproc.Pid())
  21.         time.Sleep(10 * time.Second)
  22.         r.Response.Writeln(gproc.Pid())
  23.     })
  24.     s.SetGraceful(true)
  25.     s.EnableAdmin()
  26.     s.SetPort(8199)
  27.     s.Run()
  28. }

我们通过以下几个步骤来测试平滑重启：

  1. 访问 http://127.0.0.1:8199/pid 查看当前进程的pid

平滑重启特性 - 图2

  1. 访问 http://127.0.0.1:8199/sleep，这个页面将会执行10秒，用于测试重启时该页面请求执行是否会断掉

平滑重启特性 - 图3

  1. 访问 http://127.0.0.1:8199/debug/admin，这是 s.EnableAdmin 后默认注册的一个WebServer管理页面

平滑重启特性 - 图4

  1. 随后我们点击 restart 管理链接，WebServer将会立即平滑重启( *nix 系统下)

平滑重启特性 - 图5

同时在终端也会输出以下信息:

  1.                 2018-05-18 11:02:04.812 11511: http server started listening on [:8199]
  2.     2018-05-18 11:02:09.172 11511: server reloading
  3.     2018-05-18 11:02:09.172 11511: all servers shutdown
  4.     2018-05-18 11:02:09.176 16358: http server restarted listening on [:8199]
  1. 我们可以发现在整个操作中， sleep 页面的执行并没有被中断，继续等待几秒，当 sleep 执行完成后，页面输出内容为：

平滑重启特性 - 图6

  1. 可以发现， sleep 页面输出的进程pid和之前的不一样了，代表请求的执行被新的进程平滑接管，旧的服务进程也随之销毁；

示例2：HTTPS支持

  1. package main
  3. import (
  4.     "github.com/gogf/gf/v2/frame/g"
  5.     "github.com/gogf/gf/v2/net/ghttp"
  6. )
  8. func main() {
  9.     s := g.Server()
  10.     s.BindHandler("/", func(r *ghttp.Request){
  11.         r.Response.Writeln("哈罗！")
  12.     })
  13.     s.SetGraceful(true)
  14.     s.EnableHTTPS("/home/john/temp/server.crt", "/home/john/temp/server.key")
  15.     s.EnableAdmin()
  16.     s.SetPort(8200)
  17.     s.Run()
  18. }

GoFrame 框架的平滑重启特性对于HTTPS的支持也是相当友好和简便，操作步骤如下：

  1. 访问 https://127.0.0.1:8200/debug/admin/restart 平滑重启HTTPS服务；
  2. 访问 https://127.0.0.1:8200/debug/admin/shutdown 平滑关闭WebServer服务；

在命令行终端可以看到以下输出信息：

  1.         2018-05-18 11:13:05.554 17278: https server started listening on [:8200]
  2. 2018-05-18 11:13:21.270 17278: server reloading
  3. 2018-05-18 11:13:21.270 17278: all servers shutdown
  4. 2018-05-18 11:13:21.278 17319: https server reloaded listening on [:8200]
  5. 2018-05-18 11:13:34.895 17319: server shutting down
  6. 2018-05-18 11:13:34.895 17269: all servers shutdown

示例3：多服务及多端口

GoFrame 框架的平滑重启特性相当强大及稳定，不仅仅支持单一服务单一端口监听管理，同时也支持多服务多端口等复杂场景的监听管理。

  1. package main
  3. import (
  4.     "github.com/gogf/gf/v2/frame/g"
  5. )
  7. func main() {
  8.     s1 := g.Server("s1")
  9.     s1.SetGraceful(true)
  10.     s1.EnableAdmin()
  11.     s1.SetPort(8100, 8200)
  12.     s1.Start()
  14.     s2 := g.Server("s2")
  15.     s2.SetGraceful(true)
  16.     s2.EnableAdmin()
  17.     s2.SetPort(8300, 8400)
  18.     s2.Start()
  20.     g.Wait()
  21. }

以上示例演示的是两个WebServer s1 及 s2，分别监听 8100， 8200 及 8300， 8400。我们随后访问 http://127.0.0.1:8100/debug/admin/reload 平滑重启服务，然后再通过 http://127.0.0.1:8100/debug/admin/shutdown 平滑关闭服务，最终在终端打印出的信息如下：

  1. 2018-05-18 11:26:54.729 18111: http server started listening on [:8400]
  2. 2018-05-18 11:26:54.729 18111: http server started listening on [:8100]
  3. 2018-05-18 11:26:54.729 18111: http server started listening on [:8300]
  4. 2018-05-18 11:26:54.729 18111: http server started listening on [:8200]
  5. 2018-05-18 11:27:08.203 18111: server reloading
  6. 2018-05-18 11:27:08.203 18111: all servers shutdown
  7. 2018-05-18 11:27:08.207 18124: http server reloaded listening on [:8300]
  8. 2018-05-18 11:27:08.207 18124: http server reloaded listening on [:8400]
  9. 2018-05-18 11:27:08.207 18124: http server reloaded listening on [:8200]
  10. 2018-05-18 11:27:08.207 18124: http server reloaded listening on [:8100]
  11. 2018-05-18 11:27:19.379 18124: server shutting down
  12. 2018-05-18 11:27:19.380 18102: all servers shutdown

命令行管理

GoFrame 框架除了提供 Web 方式的管理能力以外，也支持命令行方式来进行管理，由于命令行采用了 信号 进行管理。

重启服务

使用 SIGUSR1 信号量实现，使用方式：

  2.           kill -SIGUSR1 进程ID

关闭服务

使用 SIGINT/SIGQUIT/SIGKILL/SIGHUP/SIGTERM 其中任意一个信号量来实现，使用方式：

  2.           kill -SIGTERM 进程ID

其他管理方式

由于 GoFrame 框架的 WebServer 采用了单例设计，因此任何地方都可以通过 g.Server(名称) 来获得对应 Server 的单例对象，随后通过 Restart 和 Shutdown 方法可以实现对该 Server 的管理。