snapkitchen/concourse-docker-compose repository overview

⁠concourse-docker-compose

⁠overview

this docker image⁠ and helper library allows running docker-in-docker⁠ with docker-compose⁠ on concourse ci⁠

the image also has bash to support the helper library

⁠docker hub build hooks

included in the hooks dir, these scripts are executed by docker hub to automatically build and push images for the docker engine versions in docker-engine-versions

each image will be tagged with the docker engine version used during the build, e.g. 18.06

labels docker.engine.version and docker.compose.version also contain the docker engine and docker compose versions in the image

⁠bash helper lib

included in the lib dir is docker-v1.bash which is based on the common script⁠ from the concourse-docker-resource⁠

⁠usage

to use the helper script, run /bin/bash as your entrypoint and then source the script file (installed to /usr/local/lib/concourse-docker-compose/${LIB_FILE}):

- task: run-hello-world
  image: concourse-docker-compose
  privileged: true
  config:
    platform: linux
    run:
      path: /bin/bash
      args:
      - -c
      - |
        set -e
        source /usr/local/lib/concourse-docker-compose/docker-v1.bash
        start_docker
        docker run hello-world
        stop_docker

⁠v1 lib api

start_docker

• starts the docker engine
  • sanitizes control groups (cgroups) to prevent cruft from previous runs
  • times out after 120 seconds
• registers a trap handler to run stop_docker when the process exits

stop_docker

• stops the docker engine

save_image NAME TAG DIR [FILENAME (default: image)] [ID_FILENAME (default: image-id)]

• checks if image was already saved under {DIR}/{FILENAME} with a {DIR}/{ID_FILENAME}

• if current image-id matches {DIR}/{ID_FILENAME}, and {DIR}/{FILENAME} exists, does not save (no-op)

• if mismatch, or {DIR}/{FILENAME} is missing, saves to {DIR}/{FILENAME} and updates {DIR}/{ID_FILENAME}

  example for docker-image:

  save_image "foo/bar" "latest" "image-output"
  

  Copy

  example for registry-image:

  save_image "foo/bar" "latest" "image-output" "image.tar" "digest"
  

  Copy

load_image NAME TAG DIR [FILENAME (default: image)] [ID_FILENAME (default: image-id)]

• checks if {DIR}/{FILENAME} exists

  • if found, performs a docker load on {DIR}/{FILENAME}

• checks if {DIR}/{ID_FILENAME} exists

  • if found, tags {DIR}/{ID_FILENAME} as {NAME}:{TAG}

  example for docker-image:

  load_image "foo/bar" "build" "image-cache"
  

  Copy

  example for registry-image:

  load_image "foo/bar" "build" "image-cache" "image.tar" "digest"
  

  Copy

⁠build scripts

the script build in the scripts dir will build the image for the specified docker engine version

this can be used for building the image locally, for development or testing

e.g.:

./scripts/build 18.06

⁠license

see LICENSE⁠

some parts from docker-image-resource⁠ licensed under Apache 2.0⁠