jjqquu / docker-build

Build docker images in Circle CI.

docker-build is a small script for building, tagging, pushing and pulling docker images within circle CI. We use this as a way of pre-building Docker images for Tugboat to deploy to Empire.

It makes the following assumptions:

1. Either your docker registry repo and GitHub repo are the same (e.g. remind101/acme-inc on GitHub, remind101/acme-inc on Docker registry), or you provide $DOCKER_REGISTRY_USERNAME and $DOCKER_REGISTRY_REPONAME.
2. You want to tag the docker image with the value of the $CIRLE_SHA1 (git commit sha) and $CIRCLE_BRANCH (git branch).
3. You're docker credentials are provided as $DOCKER_EMAIL, $DOCKER_USER, $DOCKER_PASS
4. If you're using a different registry than DockerHub then $DOCKER_REGISTRY is set. Please see this blog post on the format of the registry url.

Usage

Build the image

$ docker-build build

Equivalent to:

$ docker build --no-cache -t "$CIRCLE_PROJECT_USERNAME/$CIRCLE_PROJECT_REPONAME" .
$ docker tag "$CIRCLE_PROJECT_USERNAME/$CIRCLE_PROJECT_REPONAME" \
  "$CIRCLE_PROJECT_USERNAME/$CIRCLE_PROJECT_REPONAME:$CIRCLE_SHA1"
$ docker tag "$CIRCLE_PROJECT_USERNAME/$CIRCLE_PROJECT_REPONAME" \
  "$CIRCLE_PROJECT_USERNAME/$CIRCLE_PROJECT_REPONAME:$CIRCLE_BRANCH"

You can add additional arguments to the docker-build build:

$ docker-build build --build-arg AWS_ACCESS_KEY_ID=ACDCABBA

Equivalent to:

$ docker build --no-cache --build-arg AWS_ACCESS_KEY_ID=ACDCABBA -t "$CIRCLE_PROJECT_USERNAME/$CIRCLE_PROJECT_REPONAME" .
...

Push the resulting image to docker registry

$ docker-build push

Equivalent to:

$ docker login -e $DOCKER_EMAIL -u $DOCKER_USER -p $DOCKER_PASS
$ docker push "$CIRCLE_PROJECT_USERNAME/$CIRCLE_PROJECT_REPONAME"

Pulling the latest image for the branch from the docker registry

$ docker-build pull

Equivalent to:

$ docker login -e $DOCKER_EMAIL -u $DOCKER_USER -p $DOCKER_PASS
$ docker pull "$CIRCLE_PROJECT_USERNAME/$CIRCLE_PROJECT_REPONAME:$CIRCLE_BRANCH"

Circle CI

To use this script, merge the following in to your circle.yml:

machine:
  services:
    - docker

dependencies:
  pre:
    - curl https://raw.githubusercontent.com/remind101/docker-build/master/docker-build > /home/ubuntu/bin/docker-build
    - chmod +x /home/ubuntu/bin/docker-build
  override:
    - docker-build pull || true
    - docker-build build

deployment:
  hub:
    branch: /.*/
    commands:
      - docker-build push
      - docker images