github.com/mgood/deis@v1.0.2-0.20141120022609-9a185b756e7d/publisher/README.md (about)

     1  publisher
     2  =========
     3  
     4  Publisher listens directly to a docker socket bind-mounted into the container and listens to the
     5  docker events API for running containers on the host. Deis applications are published to etcd for
     6  service discovery.
     7  
     8  ## Running this Container
     9  
    10  Set $ETCD_HOST to be the IP address/hostname of the etcd endpoint you wish to target, and
    11  $HOST to be the IP address of the host running this container:
    12  
    13      $ docker run -d -v /var/run/docker.sock:/tmp/docker.sock -e ETCD_HOST=192.168.0.1 -e HOST=192.168.0.1 deis/publisher
    14  
    15  ## Building from Source
    16  
    17  To build the image, run `make build`.
    18  
    19  The build/runtime environment is split into two parts:
    20  
    21  ### The build environment
    22  
    23  Based on deis/go, this image installs Go and compiles publisher into a binary.
    24  
    25  ### The runtime environment
    26  
    27  Leveraging the build environment, this image pulls in the standalone binary compiled in
    28  the build environment and injects it into a minimal standalone container, minimizing the
    29  disk space footprint that this image takes up. In fact, this image is < 5MB:
    30  
    31      $ docker images | grep publisher
    32      deis/publisher                           master              7974d140b07d        11 minutes ago      4.678 MB
    33      deis/publisher-build                     master              75983660e714        11 minutes ago      1.091 GB