DockerHub in dev-test Workflow

When DockerHub was announced there was a really handy feature added that you may have missed: Webhooks.

With DockerHub you can setup a webhook to call out to an external service once a successful push of a particular image is made (this includes completion of automated builds).

This makes for a nice addition to an existing CI/CD workflow.

The basic idea is this:

1. Setup DockerHub automated build
2. Push code changes to github
3. DockerHub sees changes and pulls/builds the image
4. DockerHub calls webhooks for image

The payload DockerHub sends to webhook services is a POST request with some JSON about the image

{
   "push_data":{
      "pushed_at":1385141110,
      "images":[
         "imagehash1",
         "imagehash2",
         "imagehash3"
      ],
      "pusher":"username"
   },
   "repository":{
      "status":"Active",
      "description":"my docker repo that does cool things",
      "is_trusted":false,
      "full_description":"This is my full description",
      "repo_url":"https://registry.hub.docker.com/u/username/reponame/",
      "owner":"username",
      "is_official":false,
      "is_private":false,
      "name":"reponame",
      "namespace":"username",
      "star_count":1,
      "comment_count":1,
      "date_created":1370174400,
      "dockerfile":"my full dockerfile is listed here",
      "repo_name":"username/reponame"
   }
}

This can already be integrated with Jenkins using the "DockerHub" plugin.

I have a demo Rails app here: https://github.com/cpuguy83/docker-rails-dev-demo

This is setup as an automated build with DockerHub: https://registry.hub.docker.com/u/cpuguy83/docker-rails-dev-demo/

It doesn't need to be an automated build for webhooks to work, but with an automated build I can push to GitHub and trigger the build to happen

In Jenkins I'm going to setup the trigger to do something on a successful build from DockerHub:

]

Then tell it to pull down my new image and run my tests by invoking docker run cpuguy83/docker-rails-dev-demo test:

*_{You'll notice in my github repo the Dockerfile is using bin/start.rb to start this container, which itself maps the test argument to rake test}

On DockerHub we need to setup the webhook. You can find the webhooks link on the main repo page, on the right-hand column under "Settings"

Add the hook for our Jenkins instance:

_{Change JENKINS to your Jenkins host. The path /dockerhub-webhook/ must stay as per the Jenkins plugin.}

Away we go, full CI workflow with tests running in the actual real image, tied in with DockerHub as an automated build.

What's really aweomse is this works with your private repos as well!