Webhook Docker

A Keybase, Slack and WebEx integration to notify Docker Events via incoming webhook

Keybase webhook setup

• Add webhookbot from list of Bots
• Create a new webhook for sending messages into the current conversation. You must supply a name as well to identify the webhook. Example: !webhook create alerts
• Get the new URL to send webhooks

Slack webhook setup

• Setup Incoming Slack

WebEx webhook setup

• Connect Incoming Webhooks

Run

Capture docker events and send to Keybase:

$ docker run --rm -v /var/run/docker.sock:/var/run/docker.sock:ro \
logocomune/webhook-docker:v1.3.1 --keybase-endpoint=https://bots.keybase.io/webhookbot/....

Capture docker events and send to Slack:

$ docker run --rm -v /var/run/docker.sock:/var/run/docker.sock:ro \
logocomune/webhook-docker:v1.3.1 --slack-endpoint=https://hooks.slack.com/services/....

Capture docker events and send to WebEx:

$ docker run --rm -v /var/run/docker.sock:/var/run/docker.sock:ro \
logocomune/webhook-docker:v1.3.1 --webex-endpoint=https://api.ciscospark.com/v1/webhooks/incoming/....

Application options

flag	Environment	type	Default
--node-name	WD_NODE_NAME	String		Node name. If empty use the hostname
--hide-node-name	WD_HIDE_NODE_NAME	Boolean	false	Node name is omitted
--docker-external-instance-inspection	WD_DOCKER_EXTERNAL_INSTANCE_INSPECTION	String	Add an external inspection url. Eg: https://myhost.ext/inspection/#/containers/__ID__
--docker-show-running	WD_DOCKER_SHOW_RUNNING	Boolean	false	Send running container to webhook
--docker-listen-container-events	WD_DOCKER_LISTEN_CONTAINER_EVENTS	Boolean	true	Listen for container events
--docker-listen-network-events	WD_DOCKER_LISTEN_NETWORK_EVENTS	Boolean	true	Listen for network events
--docker-listen-volume-events	WD_DOCKER_LISTEN_VOLUME_EVENTS	Boolean	true	Listen for volume events
--docker-listen-container-actions	WD_DOCKER_LISTEN_CONTAINER_ACTIONS	Strings separated by ;	attach;create;destroy;detach;die;kill;oom;pause;rename;restart;start;stop;unpause;update	Docker container events
--docker-listen-network-actions	WD_DOCKER_LISTEN_NETWORK_ACTIONS	Strings separated by ;	create;connect;destroy;disconnect;remove	Docker network events
--docker-listen-volume-actions	WD_DOCKER_LISTEN_VOLUME_ACTIONS	Strings separated by ;	create;destroy;mount;unmount	Docker volume events
--docker-filter-container-name	WD_DOCKER_FILTER_CONTAINER_NAME	Regexp		Filter events by container name (default all)
--docker-filter-negate-container-name	WD_DOCKER_FILTER_NEGATE_CONTAINER_NAME	Boolean	false	Negate the filter of container name
--docker-filter-image-name	WD_DOCKER_FILTER_IMAGE_NAME	Regexp		Filter events by image name (default all)
--docker-filter-negate-image-name	WD_DOCKER_FILTER_NEGATE_IMAGE_NAME	Boolean	false	Negate the filter of image name
--keybase-endpoint	WD_KEYBASE_ENDPOINT	String		Keybase endpoint for webhook
--slack-endpoint	WD_SLACK_ENDPOINT	String		Slack endpoint for webhook
--webex-endpoint	WD_WEBEX_ENDPOINT	String		WebEx endpoint for webhook

Regexp Filters

Capture events of container with names with the following formats:

• exec-1234
• exec-abcd-12345

$ docker run --rm -v /var/run/docker.sock:/var/run/docker.sock:ro \
--docker-filter-container-name="^exec-.*$" \
logocomune/webhook-docker:latest --webex-endpoint=https://api.ciscospark.com/v1/webhooks/incoming/....

Exclude events of container with the following formats:

• exec-1234
• exec-abcd-12345

$ docker run --rm -v /var/run/docker.sock:/var/run/docker.sock:ro \
--docker-filter-container-name="^exec-.*$" \
--docker-filter-negate-container-name \
logocomune/webhook-docker:latest --webex-endpoint=https://api.ciscospark.com/v1/webhooks/incoming/....