dockerhub-webhook

Automatic docker deployment with webhooks.

dockerhub-webhook listens to incoming HTTP POST-requests from hub.docker.com and triggers your specified script(s).

Features

• Lightweight
• Pretty simple setup process
• Can be runned in a docker container
• Supports updating multiple docker images
• Scripts can trigger docker or docker-compose
• Used in production
• Good logging

Create a token

Create a secret token with openssl, uuidgen or something else. Don't use any slashes since token is going to be used in the URL.

export TOKEN=$(openssl rand -base64 30 | sed 's=/=\\/=g')
echo $TOKEN

Installation alternatives

1. Run on host

Install

Nodejs and npm must be installed.

git clone http://github.com/maccyber/dockerhub-webhook
cd dockerhub-webhook
npm i

Edit config

See config/index.js

vim config/index.js

Configure repos and scripts

See scripts/index.js

vim scripts/index.js

Start dockerhub-webhook

npm start

2. Run with docker-compose

Git clone

git clone http://github.com/maccyber/dockerhub-webhook

Add secret token in dockerhub.env with

vim dockerhub.env

Start with

docker-compose up -d

3. Run from docker hub

Git clone

git clone http://github.com/maccyber/dockerhub-webhook

Start with

docker run -d \
  -p 3000:3000 \
  -e SERVER_PORT=3000 \
  -e TOKEN=${token} \
  -e ROUTE=/api \
  -v ${PWD}/scripts:/src/scripts \
  -v /var/run/docker.sock:/var/run/docker.sock \
  --name dockerhub-webhook \
  maccyber/dockerhub-webhook 

Configuration on docker hub

Go to https://hub.docker.com/ -> your repo -> Webhooks

Add a webhook like on the following image.

Replace example.com with the domain of your server or it's ip address.

Replace abc123 with your secret token.

docker-hook listens to port 3000 by default.