![]() |
9 years ago | |
---|---|---|
.. | ||
httpdown.go | 9 years ago | |
license | 9 years ago | |
patents | 9 years ago | |
readme.md | 9 years ago |
readme.md
httpdown ![Build Status](https://secure.travis-ci.org/facebookgo/httpdown.png)
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.