History

Mura Li d77176912b Use Go1.11 module (#5743 ) * Migrate to go modules * make vendor * Update mvdan.cc/xurls * make vendor * Update code.gitea.io/git * make fmt-check * Update github.com/go-sql-driver/mysql * make vendor		2019-03-27 19:15:23 +08:00
..
.travis.yml	Use Go1.11 module (#5743 )	2019-03-27 19:15:23 +08:00
httpdown.go	Support http service graceful restart (#416 )	2016-12-31 09:00:33 +08:00
license	Support http service graceful restart (#416 )	2016-12-31 09:00:33 +08:00
patents	Support http service graceful restart (#416 )	2016-12-31 09:00:33 +08:00
readme.md	Use Go1.11 module (#5743 )	2019-03-27 19:15:23 +08:00

readme.md

httpdown

Documentation: https://godoc.org/github.com/facebookgo/httpdown

Package httpdown provides a library that makes it easy to build a HTTP server that can be shutdown gracefully (that is, without dropping any connections).

If you want graceful restart and not just graceful shutdown, look at the grace package which uses this package underneath but also provides graceful restart.

Usage

Demo HTTP Server with graceful termination: https://github.com/facebookgo/httpdown/blob/master/httpdown_example/main.go

Install the demo application

 go get github.com/facebookgo/httpdown/httpdown_example

Start it in the first terminal

 httpdown_example

This will output something like:

 2014/11/18 21:57:50 serving on http://127.0.0.1:8080/ with pid 17

In a second terminal start a slow HTTP request

 curl 'http://localhost:8080/?duration=20s'

In a third terminal trigger a graceful shutdown (using the pid from your output):
```
 kill -TERM 17
```

This will demonstrate that the slow request was served before the server was shutdown. You could also have used Ctrl-C instead of kill as the example application triggers graceful shutdown on TERM or INT signals.