Merge pull request #33 from smashwilson/compose

Run a full deconst system with docker-compose

Author: smashwilson

README.md

@@ -11,3 +11,39 @@ To build this documentation standalone, run:
 ```bash
 make html
 ```
+
+## Running
+
+This repository also includes a configuration file for *docker-compose*, to let you run the full system on a single host. To get started, you'll need to install:
+
+ * [Docker](https://docs.docker.com/installation/#installation) to build and launch the containers.
+ * [docker-compose](https://docs.docker.com/compose/install/) to manage the containers' configurations.
+
+Then, you can build and run the service with:
+
+```bash
+export RACKSPACE_USERNAME=...
+export RACKSPACE_APIKEY=...
+
+docker-compose build && docker-compose up -d
+```
+
+To push content into your local system, you'll need to install the *preparer* with `pip`:
+
+```bash
+# If you're using virtualenv and virtualwrapper
+mkvirtualenv deconst-preparer-rst --python=$(which python3)
+
+# Install the preparer
+pip install -e git+https://github.com/deconst/preparer-rst.git#egg=deconstrst
+
+# Configure the preparer to submit to the locally running content service
+export CONTENT_STORE_URL=http://$(boot2docker ip):9000/
+export CONTENT_ID_BASE=https://github.com/deconst/deconst-docs/
+```
+
+Then build and publish content and assets with:
+
+```bash
+deconst-prepare-rst
+```

docker-compose.yml

@@ -0,0 +1,31 @@
+---
+content:
+  image: quay.io/deconst/content-service
+  environment:
+    RACKSPACE_USERNAME:
+    RACKSPACE_APIKEY:
+    RACKSPACE_REGION: DFW
+    CONTENT_CONTAINER: deconst-presenter-dev-content
+    ASSET_CONTAINER: deconst-presenter-dev-assets
+    CONTENT_LOG_LEVEL: DEBUG
+  ports:
+  - "9000:8080"
+mapping:
+  image: quay.io/deconst/mapping-service
+  environment:
+    CONTROL_REPO_URL: https://github.com/deconst/map-example.git
+    MAP_LOG_LEVEL: DEBUG
+  ports:
+  - "9001:8080"
+presenter:
+  image: quay.io/deconst/presenter
+  links:
+  - content
+  - mapping
+  environment:
+    CONTENT_SERVICE_URL: http://content:8080/
+    MAPPING_SERVICE_URL: http://mapping:8080/
+    PRESENTED_URL_DOMAIN: mysite.com
+    PRESENTER_LOG_LEVEL: DEBUG
+  ports:
+  - "80:8080"