OpenCGA has published a docker image for quick testing and playing without going through hassle to learn, wait and install each and every OpenCGA components. The docker image is available at the public docker registry under the repository opencb/opencga-demo.
The OpenCGA demo docker image contains the following components:
To download OpenCGA demo image, use the command docker pull with the OpenCB enterprise, opencga-demo repository and tag. For example :
$ docker pull opencb/opencga-demo:1.4.1 |
To start the OpenCGA demo container, use the command docker run. For example: (This command will pull image as well if not present in local repository)
$ docker run --name demo -d opencb/opencga-demo:1.4.1 |
The first time you run the OpenCGA demo container, it installs the OpenCGA catalog in mongoDB, starts the OpenCGA REST server and finally, it starts the OpenCGA daemon. In this case, no data is loaded. If you want to load some demo data, set the option load to true that instructs OpenCGA demo container to download data from Corpasome project and then, to run an ETL pipeline that loads, annotates, computes statistics and indexes data into the Solr search engine. This process roughly takes 35-40 minutes depending on the internet speed and the machine specifications. Following command starts the OpenCGA container loading demo data:
$ docker run --name demo -e load=true -d opencb/opencga-demo:1.4.1 |
User can also mount customise directories to store MongoDB and Solr data for ease. The following command will mount the ~/data/mongodb and ~/data/solr directories from host machine to inside container at "/data/opencga/mongodb", "/data/opencga/mongodb" respectively.
$ docker run --name demo -e load=true -v ~/data/mongodb:/data/opencga/mongodb -v ~/data/solr:/data/opencga/solr -d opencb/opencga-demo:1.4.1 |
You can connect to the OpenCGA demo container using the following command:
$ docker exec -it demo bash |
To fetch the logs of the OpenCGA demo container, use the following command:
$ docker logs demo -f |
In order to access to the Solr dashboard, use the following URL on your internet browser:
http://OpenCGA-Demo-Container-IP:8983/solr |
And to access to the OpenCGA REST webservices, use the following URL:
http://OpenCGA-Demo-Container-IP:9090/opencga/webservices/rest/v1 |
Distributed systems with multiple dependencies require a lot of work to setup, install, configure system and developers would like to have a quick way to test their changes locally and quickly with a system mimicking as close as possible to production systems. Following are the steps to create your own opencga demo image from modified oepncga source code :
~/appl/opencga[develop*]$ mvn clean install -DskipTests -Dopencga.war.name=opencga |
Build OpenCGA Next image :
~/appl/opencga[develop*]$ docker build -t opencga-next -f opencga-app/app/scripts/docker/opencga-next/Dockerfile . |
Next Build OpenCGA Demo Image :
~/appl/opencga[develop*]$ docker build -t opencga-demo -f opencga-app/app/scripts/docker/opencga-demo/Dockerfile . |
Catalog installation and steps to create project, study etc are in listed in "opencga-app/app/scripts/docker/opencga-demo/init.sh" script. User can modify as per own needs for example, change the variant file etc.