Merge pull request #159 from bolinfest/nicks/circleci

add instructions on how to build plovr in a docker container

.dockerignore

@@ -0,0 +1,3 @@
+.git
+.buckd
+buck-out

Dockerfile

@@ -0,0 +1,9 @@
+FROM nicks/plovr-deps
+
+ADD . /plovr
+
+WORKDIR /plovr
+
+RUN buck fetch //third-party/...
+
+RUN buck test :test

Dockerfile.base

@@ -0,0 +1,16 @@
+# Builds the image nicks/plovr-base
+FROM java:8
+
+# Install deps
+RUN apt update && apt install -y \
+  git \
+  ant \
+  gcc \
+  python \
+  python-dev
+
+# Build BUCK
+RUN git clone https://github.com/facebook/buck.git /buck/
+WORKDIR /buck
+RUN ant
+RUN ln -sf /buck/bin/buck /usr/bin/

README.md

@@ -39,6 +39,30 @@ buck build plovr
 
 The output of the build will be in `buck-out/gen/plovr.jar`.
 
+### Building Plovr inside a Docker container
+
+If you want to build plovr without installing Buck on your local machine,
+we have a Docker container with Buck installed.
+
+The Plovr build is split into two Dockerfiles:
+
+- [Dockerfile](Dockerfile) builds and tests Plovr
+- [Dockerfile.base](Dockerfile.base) builds Buck and Plovr's dependencies
+
+To test:
+
+```
+docker build .
+```
+
+downloads the plovr-deps container from docker, adds Plovr source, and runs all the Plovr tests.
+
+If you want to build `plovr-deps` yourself:
+
+```
+docker build -t nicks/plovr-deps -f Dockerfile.base .
+```
+
 ### To Upgrade Closure Library
 
 To upgrade one of Closure Library, go to the official repo and find the SHA digest

tools/imports/BUCK

@@ -2,7 +2,7 @@ genrule(
   name = 'rev-plovr',
   srcs = [],
   out = 'rev-plovr.txt',
-  cmd = 'git rev-parse HEAD > $OUT')
+  cmd = 'git rev-parse HEAD > $OUT || echo "head" > $OUT')
 
 java_library(
   name = 'revs',