Recommended Project Structure for Docker

I’m working on a Go project that has the following structure (schematic):



  • How to change dockers default network?
  • Building a Dockerfile with Vagrant and the Docker provider: multi-line command chaining returns error
  • Building WAR
  • Disk management (cleanup) in a stopped docker container
  • django docker-compose --> memcached not working
  • How to run Docker container and watch the logs in one single command
    • lib1 is a library
    • prog1 and prog2 are executables (both depend on lib1)

    In a nutshell: How do I create Dockerfiles for prog1 and prog2?

    I tried several approaches, all to no avail:

    Creating a Dockerfile in prog1/

    Failed because docker cannot ADD ../lib1 to the container since it is out of the context (see

    Creating a Dockerfile in the root directory

    Ignoring the fact that I actually need two Dockerfiles (for prog1, and for prog2), I tried placing the Dockerfile in the root directory of the project.

    However, the docker image I need to use (golang:1.4.1-onbuild) fails to find any Go files (since they are in ./prog1, and not in the root):

    + exec go install -v
    can't load package: package app: no buildable Go source files in /go/src/app

    What is the recommended project structure for the golang:1.4.1-onbuild image?

    Edit: Better asked here:

  • Sharing files between container and host
  • Difference between Resident Set Size (RSS) and Java total committed memory (NMT) for a JVM running in Docker container
  • Docker – fix service IP addresses [duplicate]
  • Docker registry:2 won't start
  • How to join the default bridge network with docker-compose?
  • How to find the name of intermediate Docker images?
  • One Solution collect form web for “Recommended Project Structure for Docker”

    Most pull the files in via their VCS or just go get instead of using ADD. You add the the source tree in the same way regardless of what tool your building, since you need the structure of $GOPATH to be the same for each.

    Note, you can also name your docker file via docker build -f, so if you want to use ADD, you can have multiple DOCKERFILEs in your root directory.

    Docker will be the best open platform for developers and sysadmins to build, ship, and run distributed applications.