diff --git a/docs/sources/docker-hub/builds.md b/docs/sources/docker-hub/builds.md index e4d64eb28e..1323f6ff9a 100644 --- a/docs/sources/docker-hub/builds.md +++ b/docs/sources/docker-hub/builds.md @@ -28,7 +28,8 @@ Automated Builds are supported for both public and private repositories on both To use Automated Builds, you must have an [account on Docker Hub](http://docs.docker.com/userguide/dockerhub/#creating-a-docker-hub-account) -and on GitHub and/or Bitbucket. +and on GitHub and/or Bitbucket. The account needs to be properly validated and activated +before you can link to it. ## Setting up Automated Builds with GitHub @@ -48,7 +49,8 @@ at the upper right of the screen. Then select Select the [GitHub service](https://registry.hub.docker.com/associate/github/). -Then follow the onscreen instructions to authorize and link your GitHub account to Docker Hub. +Then follow the onscreen instructions to authorize and link your GitHub account to Docker Hub. Once it is linked, you'll be able to choose a repo from which to create the +Automatic Build. ### Creating an Automated Build @@ -85,7 +87,8 @@ Automated Build: 2. Webhooks & Services Click on "Webhooks & Services" on the left side of the page. - 3.Find the service labeled DockerFind the service labeled "Docker" and click on it. + 3. + Find the service labeled DockerFind the service labeled "Docker" and click on it. 4.Activate Service Hooks Make sure the "Active" checkbox is selected and click the "Update service" button to save your changes. @@ -102,10 +105,11 @@ To get started, log into your Docker Hub account and click the "+ Add Repository the upper right of the screen. Then select [Automated Build](https://registry.hub.docker.com/builds/add/). Select the [Bitbucket -service](https://registry.hub.docker.com/associate/bitbucket/). +source](https://registry.hub.docker.com/associate/bitbucket/). Then follow the onscreen instructions to authorize and link your Bitbucket account -to Docker Hub. +to Docker Hub. Once it is linked, you'll be able to choose a repo from which to create +the Automatic Build. ### Creating an Automated Build @@ -113,6 +117,42 @@ You can [create an Automated Build]( https://registry.hub.docker.com/builds/bitbucket/select/) from any of your public or private Bitbucket repositories with a `Dockerfile`. +### Adding a Hook + +When you link your Docker Hub account, a `POST` hook should get automatically added to +your Bitbucket repo. +Follow the steps below to confirm or modify the Bitbucket hooks for your +Automated Build: + + + + + + + + + + + + + + + + + + + + + + + + +
StepScreenshotDescription
1.SettingsLog in to Bitbucket.org and go to your Repository page. Click on "Settings" on + the far left side of the page, under "Navigation". You must have admin privileges + to the repository in order to do this.
2.HooksClick on "Hooks" on the near left side of the page, under "Settings".
3.Docker Post HookYou should now see a list of hooks associated with the repo, including a POST hook that points at + registry.hub.docker.com/hooks/bitbucket.
+ + ## The Dockerfile and Automated Builds During the build process, Docker will copy the contents of your `Dockerfile`. It will diff --git a/docs/sources/docker-hub/hub-images/bb_hooks.png b/docs/sources/docker-hub/hub-images/bb_hooks.png new file mode 100644 index 0000000000..d51cd03ac4 Binary files /dev/null and b/docs/sources/docker-hub/hub-images/bb_hooks.png differ diff --git a/docs/sources/docker-hub/hub-images/bb_menu.png b/docs/sources/docker-hub/hub-images/bb_menu.png new file mode 100644 index 0000000000..6f4a6813ef Binary files /dev/null and b/docs/sources/docker-hub/hub-images/bb_menu.png differ diff --git a/docs/sources/docker-hub/hub-images/bb_post-hook.png b/docs/sources/docker-hub/hub-images/bb_post-hook.png new file mode 100644 index 0000000000..78c4730665 Binary files /dev/null and b/docs/sources/docker-hub/hub-images/bb_post-hook.png differ