Added instructions to run docker compose
Project: http://git-wip-us.apache.org/repos/asf/incubator-senssoft-distill/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-senssoft-distill/commit/e5581674 Tree: http://git-wip-us.apache.org/repos/asf/incubator-senssoft-distill/tree/e5581674 Diff: http://git-wip-us.apache.org/repos/asf/incubator-senssoft-distill/diff/e5581674 Branch: refs/heads/master Commit: e55816742001c4f6096fda0936d83abaf73cf3f8 Parents: b6c98d1 Author: mooshu1x2 <mbe...@draper.com> Authored: Mon Sep 19 17:20:49 2016 -0400 Committer: mooshu1x2 <mbe...@draper.com> Committed: Mon Sep 19 17:20:49 2016 -0400 ---------------------------------------------------------------------- .gitignore | 4 ++++ docs/source/installation.rst | 30 ++++++++++++++++++++++++++++-- 2 files changed, 32 insertions(+), 2 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/incubator-senssoft-distill/blob/e5581674/.gitignore ---------------------------------------------------------------------- diff --git a/.gitignore b/.gitignore index ce414ba..a597142 100644 --- a/.gitignore +++ b/.gitignore @@ -26,6 +26,10 @@ setup_tools # Flask instance folder instance/ +# Docker stuff +es/ +userale/ + # Scrapy stuff: .scrapy http://git-wip-us.apache.org/repos/asf/incubator-senssoft-distill/blob/e5581674/docs/source/installation.rst ---------------------------------------------------------------------- diff --git a/docs/source/installation.rst b/docs/source/installation.rst index 9947fde..e0bf00c 100644 --- a/docs/source/installation.rst +++ b/docs/source/installation.rst @@ -96,8 +96,34 @@ Deactivate environment $ deactivate -Deployment ----------- +Running Apache Distill on Docker Compose +---------------------------------------- + +From the project directory, start up Apache Distill in the background. + +:: + + $ docker-compose up -d + Starting elastic + Starting logstash + Starting kibana + Starting distill + $ docker-compose ps + Name Command State Ports + -------------------------------------------------------------------------------------------------- + distill /bin/sh -c python distill/ ... Up 0.0.0.0:8090->8090/tcp + elastic elasticsearch Up 0.0.0.0:9200->9200/tcp, 0.0.0.0:9300->9300/tcp + kibana /tmp/entrypoint.sh Up 0.0.0.0:5601->5601/tcp + logstash logstash -f /etc/logstash/ ... Up + +To stop services once you've finished with them: + +:: + + $ docker-compose stop + +Deployment with Nginx and Gunicorn +---------------------------------- I will describe a setup with nginx as a web server on Ubuntu. A web server cannot communicate directly with a Flask application such as Apache Distill. Thus gunicorn will be used to act as a medium between the web server and Apache Distill. Gunicorn is like an application web server that will be running behind nginx, and it is WSGI compatible. It can communicate with applications that support WSGI â Flask, Django, etc.