Webhook Docker

A Keybase, Slack, WebEx and Google Chat 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

Google Chat webhook setup

• Set up Incoming Webhooks for your Google Chat space

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.4.0 --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.4.0 --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.4.0 --webex-endpoint=https://api.ciscospark.com/v1/webhooks/incoming/....

Capture docker events and send to Google Chat:

$ docker run --rm -v /var/run/docker.sock:/var/run/docker.sock:ro \
logocomune/webhook-docker:v1.4.0 --google-chat-endpoint=https://chat.googleapis.com/v1/spaces/....

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 | | --google-chat-endpoint | WD_GOOGLE_CHAT_ENDPOINT | String | | Google Chat 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/....