We use a postgres image, for the database, and 2 separate images for the Beacon and the Beacon UI.
If you instantiate directly the containers, the images will be automatically downloaded.
If you prefer to (re-)create the images for the Beacon and Beacon UI locally, run the following command in the current directory:
docker-compose build beacon ui
At boot time, the database pre-loads some data from the 1000 genomes
project.
This takes only a few seconds. Instantiate a container with
docker-compose up -d db
You can look at what is happening in the container with docker-compose logs -f db
.
Once ready, you can now instanciate the other containers. We have already adjusted the settings for the network and the different connection parameters.
docker-compose up -d beacon
The beacon is now ready. You can query it on localhost
(port 5050). For example:
- localhost:5050/
- localhost:5050/query?referenceName=Y&start=2655179&referenceBases=G&alternateBases=A&assemblyId=GRCh37&datasetIds=1000genomes
- localhost:5050/query?referenceName=Y&start=2655179&referenceBases=G&alternateBases=A&assemblyId=GRCh37&datasetIds=1000genomes&includeDatasetResponses=HIT
Finally, you can new start the Beacon UI with:
docker-compose up -d ui
and point you browser to localhost:8000
The -d
flag runs the containers detached, ie we get the prompt back. You can check the logs with:
docker-compose logs -f
Tear down the system and remove the database volume, with:
docker-compose down -v