Merge pull request #419 from blackxored/better-docker-support

Better docker support

.dockerignore

+.git
+source

Dockerfile

-FROM ruby:2.2.3-onbuild
+FROM ruby:onbuild
+MAINTAINER Adrian Perez <adrian@adrianperez.org>
+VOLUME /usr/src/app/source
+EXPOSE 4567
 
-RUN ln -s /usr/src/app /app # Deprecated
+RUN apt-get update && apt-get install -y nodejs \
+&& apt-get clean && rm -rf /var/lib/apt/lists/*
 
-EXPOSE 4567
 CMD ["bundle", "exec", "middleman", "server", "--force-polling"]

README.md

@@ -54,16 +54,21 @@ You're going to need:
 bundle install
 bundle exec middleman server
 ```
-#### Via Docker (must install Docker first)
+
+#### Via Docker (must install it first)
 
 ```shell
-docker build -t slate .
-docker run -d -p 4567:4567 --name slate -v $(pwd)/source:/app/source slate
+docker-compose up
 ```
 
+will spin an environment for you, with the `source` directory mapped to the
+container, so you can see your edits instantly after refreshing your browser.
+
 You can now see the docs at http://localhost:4567. Whoa! That was fast!
 
-*Note: if you're using the Docker setup on OSX, the docs will be availalable at the output of `boot2docker ip` instead of `localhost:4567`.*
++*Note: if you're not using Docker natively (i.e. on Linux), the docs will be
++available at the IP of your docker host. If you're using docker-machine you can
++retrieve it with `docker-machine ip <your_machine_name>`*
 
 #### Via Vagrant
 ```shell

docker-compose.yml

+app:
+  build: .
+  ports:
+    - 4567:4567
+  volumes:
+    - ./source:/usr/src/app/source