Skip to content
Docker image with Docker Compose. Useful as a base image for integration tests in Concourse CI.
Branch: master
Clone or download
Pull request Compare This branch is 4 commits ahead of netresearch:master.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
example
setup/usr/local/bin Merge branch 'master' of github.com:netresearch/dcind Apr 17, 2019
Dockerfile add util-linux to fix error with concourse 5.x Apr 17, 2019
LICENSE Add LICENSE file Sep 28, 2016
README.md Add documentation for messages Dec 6, 2018
docker-lib.sh

README.md

dcind (Docker-Compose-in-Docker)

Use this Dockerfile to build a base image for your integration tests in Concourse CI. Alternatively, you can use a ready-to-use image from the Docker Hub: netresearch/dcind. The image is Alpine based.

Here is an example of a Concourse job that uses netresearch/dcind image to run a bunch of containers in a task, and then runs the integration test suite. You can find a full version of this example in the example directory.

  - name: integration
    plan:
      - aggregate:
        - get: code
          params: {depth: 1}
          passed: [unit-tests]
          trigger: true
        - get: redis
          params: {save: true}
        - get: busybox
          params: {save: true}
      - task: Run integration tests
        privileged: true
        config:
          platform: linux
          image_resource:
            type: docker-image
            source:
              repository: netresearch/dcind
          inputs:
            - name: code
            - name: redis
            - name: busybox
          run:
            path: sh
            args:
              - -exc
              - |
                source /docker-lib.sh
                start_docker

                # Strictly speaking, preloading of Docker images is not required.
                # However, you might want to do this for a couple of reasons:
                # - If the image comes from a private repository, it is much easier to let Concourse pull it,
                #   and then pass it through to the task.
                # - When the image is passed to the task, Concourse can often get the image from its cache.
                docker load -i redis/image
                docker tag "$(cat redis/image-id)" "$(cat redis/repository):$(cat redis/tag)"

                docker load -i busybox/image
                docker tag "$(cat busybox/image-id)" "$(cat busybox/repository):$(cat busybox/tag)"

                message info This is just to visually check in the log that images have been loaded successfully
                docker images

                message Run the container with tests and its dependencies.
                docker-compose -f code/example/integration.yml run tests

                message header Cleanup.
                message info Not sure if this is required. It's quite possible that Concourse is smart enough to clean up the Docker mess itself.
                docker-compose -f code/example/integration.yml down
                docker volume rm $(docker volume ls -q)

Included tools

Messages

For better organized log files, this image provides commands on the CLI for a colourful output:

message info "Short info message"

message header "Big headline with deviders"

message error 418 "Error message with exit code"

message warn "Use it when something goes wrong"

message ok "Use it for successful processes"

message code "<example>My exaple code</example>"
You can’t perform that action at this time.