Commit 79fa516b authored by Bryan  BRANCOTTE's avatar Bryan BRANCOTTE
Browse files

update doc about docker-compose and kubernetes

parent cff18bc3
......@@ -107,7 +107,20 @@ Then, you can install RabbitMQ with the "choco install" command:
Run JASS as a web application (optional)
----------------------------------------
To run locally JASS as a web application, you need to launch two servers in two different processes, the `celery` task management server and the web server. The web server handles the HTTP requests, and sends all computation requests to the task management server.
To run locally JASS as a web application, it is recommended to use the docker-compose as it handles all dependencies in one command. If using docker-compose is not an option, you need to launch two servers in two different processes, the `celery` task management server and the web server. The web server handles the HTTP requests, and sends all computation requests to the task management server.
Launching with docker compose (recommended)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Once docker and docker-compose installed, just run
.. code-block:: shell
# build the application
docker-compose build
# launch the whole application
docker-compose up
# then visit http://0.0.0.0:3000/
launching the two servers on Linux
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
......@@ -148,6 +161,6 @@ The web server is launched in another terminal (the same as on Linux):
Public server deployment (optional)
-----------------------------------
Ansible playbooks are available in the `ansible folder of the source repository <https://gitlab.pasteur.fr/statistical-genetics/jass/tree/master/ansible>`_. These playbooks automate the initial configuration of the system (for a server using CentOS), and the initial installation or the update of the code from the repository.
Helm charts are available in the `chart folder of the source repository <https://gitlab.pasteur.fr/statistical-genetics/jass/tree/master/charts>`_. These charts automate the installation and update of the application in a kubernetes cluster.
In this specific deployment, the JASS web application is hosted by an NGINX server, connected through the uWSGI library. It communicates with a celery service that handles the user-launched tasks. Many other deployment options are of course possible, use whichever suits your infrastructure!
In this specific deployment, the JASS web application is hosted by an NGINX server, served by the uvicorn library. It communicates with a celery container that handles the user-launched tasks. Many other deployment options are of course possible, use whichever suits your infrastructure!
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment