From caa5d3c20b3ef399f70845b7a8703093c40436f2 Mon Sep 17 00:00:00 2001 From: Guillaume Pellerin Date: Thu, 6 Nov 2014 21:24:45 +0100 Subject: [PATCH] update doc --- README.rst | 84 +++++++++++++++++++++++++++++++----------------------- 1 file changed, 49 insertions(+), 35 deletions(-) diff --git a/README.rst b/README.rst index 570bf2e..25d8430 100644 --- a/README.rst +++ b/README.rst @@ -91,6 +91,12 @@ For more extensive examples, please see the `full documentation > ~/.bashrc - source ~/.bashrc - tests/run_all_tests +Docker is a great tool for developping and deploying processing environments! Our docker container includes all the necessary packages and environments for development and production with TimeSide. + +First, install Docker: https://docs.docker.com/installation/ + +Then, simply pull our dev image and run:: + + sudo docker pull parisson/timeside + sudo docker run parisson/timeside + +To get a shell:: + + sudo docker run -ti parisson/timeside bash + +More infos: https://registry.hub.docker.com/u/parisson/timeside/ + +To start the web server through the container:: + + sudo docker run -p 9000:80 parisson/timeside + +Finally browse http://localhost:9000/api/ + +To start a new development, it is advised to checkout the dev branch and build your own container:: + + sudo docker run -ti parisson/timeside bash + cd /opt/TimeSide + git checkout dev -VirtualBox and Vagrant ------------------------ + +VirtualBox and Vagrant (deprecated) +----------------------------------- We also provide a vagrant box to install a virtual Debian system including TimeSide and all other dependencies. First, install Vagrant and VirtualVox:: @@ -381,32 +405,22 @@ To stop the virtual box:: vagrant halt -Docker +Native ------- -Docker is a great tool for developping and deploying processing environments! Our docker container includes all the necessary packages and environments for development and production with TimeSide. - -First, install Docker: https://docs.docker.com/installation/ - -Then, simply pull our dev image and run:: - - sudo docker pull parisson/timeside - sudo docker run -i -t parisson/timeside bash - -More infos: https://registry.hub.docker.com/u/parisson/timeside/ - -To start the web server through the container:: - - sudo docker run -p 9000:80 parisson/timeside supervisord -n - -Finally browse http://localhost:9000/api/ - -To start a new development, it is advised to checkout the dev branch and build your own container:: +First, install TimeSide (see Install). - cd TimeSide - git checkout dev - sudo docker build . +Then:: + sudo apt-get build-dep python-timeside + sudo apt-get install git + git clone https://github.com/Parisson/TimeSide.git + cd TimeSide + git checkout dev + sudo pip install -e . + echo "export PYTHONPATH=$PYTHONPATH:`pwd`" >> ~/.bashrc + source ~/.bashrc + tests/run_all_tests Sponsors and Partners ===================== -- 2.39.5