A convenient Docker build environment control script

control.sh

#!/usr/bin/env bash

# NOTE: make your dockerfile define the WITHIN_CONTAINER envvar:
# ENV WITHIN_CONTAINER yes

if [ ! -z ${WITHIN_CONTAINER+x} ]; then
    printf "$0: Already within a container.\n" && exit 126
fi

DOCKER=$(which docker)
IMAGE_NAME="your_project_name"

function filter_clean {
    DELETE="$1"
    FILTER="$2"

    container=$(${DOCKER} ps -a ${FILTER}                        \
                          | grep "${IMAGE_NAME}:latest"          \
                          | awk '{print $1}')

    if [ ! -z ${container} ]; then
        if [ "${DELETE}" = true ]; then
            ${DOCKER} stop ${container} > /dev/null
        fi
        ${DOCKER} rm ${container} > /dev/null
    fi

    return 0
}

function command_create {
    GITROOT="$1"
    ENVROOT="$2"
    OPTIONS="${@:3}"

    # if it's not running, delete & rebuild it
    filter_clean false "--filter status=exited"

    if [ -z "$(${DOCKER} ps | grep "${IMAGE_NAME}:latest")" ]; then
        ${DOCKER} build -t ${IMAGE_NAME}:latest ${ENVROOT} &&
        ${DOCKER} run -dti --user=$(id -u):$(id -g)              \
            -v /etc/passwd:/etc/passwd:ro                        \
            -v /etc/localtime:/etc/localtime:ro                  \
            -v ${GITROOT}:/home/your_project_name/git            \
            --name="${IMAGE_NAME}" ${OPTIONS} ${IMAGE_NAME}
    fi
}

function command_delete {
    filter_clean true
}

function command_attach {
    ${DOCKER} exec -it ${IMAGE_NAME} bash

    return 0
}

function command_remote {
    ${DOCKER} exec ${IMAGE_NAME} $@

    return 0
}

function usage {
    printf "Usage:\n"
    printf "\t$0 create [git root] [env root] [docker run options ...]\n"
    printf "\t$0 delete\n"
    printf "\t$0 attach\n"
    printf "\t$0 remote [...]\n"

    return 127
}

COMMAND="$1" && shift

case ${COMMAND} in
    create)
        if [[ $# -gt 2 ]]; then
            command_create $@
        else
            usage
        fi
        ;;
    delete)
        if [[ $# -eq 0 ]]; then
            command_delete
        else
            usage
        fi
        ;;
    attach)
        if [[ $# -eq 0 ]]; then
            command_attach
        else
            usage
        fi
        ;;
    remote)
        if [[ $# -gt 0 ]]; then
            command_remote $@
        else
            usage
        fi
        ;;
    *)
        usage
        ;;
esac

Small revision: if the create command is invoked while the container exists but is stopped, the container is deleted and rebuilt (quickly since it's probably in cache). This is useful if the docker run failed for some reason, or after rebooting. The alternative is to skip building if it's there but not running and just start it directly, but better be safe than sorry since building from cache is so cheap.