Updated: Jun 14, 2016
Files needed to deploy (install) Quindar; the complete Quindar platform has three components:
- The front end (gui) > quindar-ux
- The backend (server) > quindar-svr
- The simulator (data source) > quindar-src
Step 1 - prepare the hosts
Install the pre-requisites on the host server(s). You can deploy all three components (source, server, ux) on one host running docker or run individual machines for each. If you want to remove old images first use docker rm $(docker ps -a -q).
- Install Git, e.g.
yum install -y git - Install Docker (see https://docs.docker.com/engine/installation/)
Step 2 - Clone this repository
git clone https://github.com/AudacySpace/quindar-deploy
The nginx servers are deployed with self-signed certificates which will throw security warnings in your browser. In a production environment, SSH into the servers and (1) update server name, (2) install your own certs.
server certificate /etc/ssl/server.crt
server key /etc/ssl/server.key
restart nginx nginx -s reload
cd quindar-deploy/qux-frontend
docker build -t "quindar-qux" .
docker run -d -t --name qux --cap-add SYS_PTRACE -v /proc:/host/proc:ro -v /sys:/host/sys:ro -p 80:80 -p 443:443 quindar-qux
The quindar gui will be running on http://hostname
You can update the node application after the docker container is deployed (running) from the host by running the following command (on the host); the last parameter is the name of the repo branch you want to use for the update; either "master" for production, or "develop" for the development branch. This is useful for either scheduled updates or build automation via Jenkins, etc.
docker exec qux node-update.sh <branch>
To test the application by executing automated tests before deploying the new code, you can run a script with branch name as the argument
cd quindar-deploy/qux-frontend
./deploy.sh <branch>
cd quindar-deploy/qsvr-backend
docker build -t "quindar-qsvr" .
docker run -d -t --name qsvr --cap-add SYS_PTRACE -v /proc:/host/proc:ro -v /sys:/host/sys:ro -p 80:80 -p 443:443 -p 27017:27017 quindar-qsvr
To update the quindar proxy node app inside the container after deployment, use the following command (on the host).
docker exec qsvr proxy-update.sh <branch>
To test the application by executing automated tests before deploying the new code, you can run a script with branch name as the argument
cd quindar-deploy/qsvr-backend
./deploy.sh <branch>
cd quindar-deploy/qsrc-simulator
docker build -t "quindar-qsrc" .
docker run -d -t --name qsrc --cap-add SYS_PTRACE -v /proc:/host/proc:ro -p 80:80 -p 443:443 -p 5901:5901 quindar-qsrc
Connect to the server at http://hostname or you can access the VNC server directly with a VNC client at hostname:5901 using password "vncpassword".
You can update GMAT inside the docker container while running from the host with the following command (on the host); the last parameter is the name of the repo branch you want to use for the update; either "master" for production, or "develop" for the development branch. This is useful for either scheduled updates or build automation via Jenkins, etc.
sudo docker exec qsrc gmat-update.sh <branch>