mirror of
https://github.com/adnanh/webhook.git
synced 2025-05-10 15:44:43 +00:00
eddeb82032
* feat: add ability to listen on unix socket/named pipe Add a -socket option that configures the server to listen on a Unix-domain socket or Windows named pipe instead of a TCP port. This allows webhook to be used behind a reverse proxy on multi-tenant shared hosting without the need to choose (and the permission to bind to) a free port number. On Windows, -socket is expected to be a named pipe such as \\.\pipe\webhook, and the code uses https://github.com/microsoft/go-winio to bind the listening socket. On other platforms, -socket is the path to a Unix domain socket such as /tmp/webhook.sock, or an abstract socket name starting with @, bound using the regular net.Listen function with the "network" parameter set to "unix". Note: this pushes our minimum Go version up to 1.21 as that is what go-winio requires, but that is already the minimum version against which we are testing in the CI matrix. * tests: add test for the -socket option Refactored webhook_test so that the test HTTP requests are made using an explicitly-provided http.Client, so we can run at least one test with the server bound to a socket instead of a port number, using an http.Client whose transport has been configured with a suitable Unix-domain or Windows named pipe dialer function. * tests: use GOROOT to find go command This should ensure that, even if a developer or CI server has multiple versions of go installed, the version used to build the tools under test will be the same version that is running the test harness. * fix: clean up Unix socket file before exit If webhook is restarted with the same settings but the socket file has not been deleted, webhook will be unable to bind and will exit with an error. * docs: add -socket option to documentation * docs: add a note about reverse proxies - README mentions the idea of using webhook behind a reverse proxy, including with the -socket flag - added a note in Hook-Rules that the ip-whitelist rule type does not work as expected behind a reverse proxy, and you should configure IP restrictions at the proxy level instead
66 lines
2.6 KiB
Markdown
66 lines
2.6 KiB
Markdown
# Webhook parameters
|
|
```
|
|
Usage of webhook:
|
|
-cert string
|
|
path to the HTTPS certificate pem file (default "cert.pem")
|
|
-cipher-suites string
|
|
comma-separated list of supported TLS cipher suites
|
|
-debug
|
|
show debug output
|
|
-header value
|
|
response header to return, specified in format name=value, use multiple times to set multiple headers
|
|
-hooks value
|
|
path to the json file containing defined hooks the webhook should serve, use multiple times to load from different files
|
|
-hotreload
|
|
watch hooks file for changes and reload them automatically
|
|
-http-methods string
|
|
set default allowed HTTP methods (ie. "POST"); separate methods with comma
|
|
-ip string
|
|
ip the webhook should serve hooks on (default "0.0.0.0")
|
|
-key string
|
|
path to the HTTPS certificate private key pem file (default "key.pem")
|
|
-list-cipher-suites
|
|
list available TLS cipher suites
|
|
-logfile string
|
|
send log output to a file; implicitly enables verbose logging
|
|
-max-multipart-mem int
|
|
maximum memory in bytes for parsing multipart form data before disk caching (default 1048576)
|
|
-nopanic
|
|
do not panic if hooks cannot be loaded when webhook is not running in verbose mode
|
|
-pidfile string
|
|
create PID file at the given path
|
|
-port int
|
|
port the webhook should serve hooks on (default 9000)
|
|
-secure
|
|
use HTTPS instead of HTTP
|
|
-setgid int
|
|
set group ID after opening listening port; must be used with setuid
|
|
-setuid int
|
|
set user ID after opening listening port; must be used with setgid
|
|
-socket string
|
|
path to a Unix socket (e.g. /tmp/webhook.sock) or Windows named pipe (e.g. \\.\pipe\webhook) to use instead of listening on an ip and port; if specified, the ip and port options are ignored
|
|
-template
|
|
parse hooks file as a Go template
|
|
-tls-min-version string
|
|
minimum TLS version (1.0, 1.1, 1.2, 1.3) (default "1.2")
|
|
-urlprefix string
|
|
url prefix to use for served hooks (protocol://yourserver:port/PREFIX/:hook-id) (default "hooks")
|
|
-verbose
|
|
show verbose output
|
|
-version
|
|
display webhook version and quit
|
|
-x-request-id
|
|
use X-Request-Id header, if present, as request ID
|
|
-x-request-id-limit int
|
|
truncate X-Request-Id header to limit; default no limit
|
|
```
|
|
|
|
Use any of the above specified flags to override their default behavior.
|
|
|
|
# Live reloading hooks
|
|
If you are running an OS that supports the HUP or USR1 signal, you can use it to trigger hooks reload from hooks file, without restarting the webhook instance.
|
|
```bash
|
|
kill -USR1 webhookpid
|
|
|
|
kill -HUP webhookpid
|
|
```
|