octri/sparc-request-docker-talk

Containerizing SPARCRequest

This repository showcases a method of building and running SPARCRequest as a container. It was presented on Sept. 30th, 2020 at the SPARC Open Source Technical Call. See the presentation document for the points covered.

Building the images

To build the images first build the Dockerfile-base.

docker build --file Dockerfile-base --tag my_sparc_request_base .

You can optionally specify a release GitHub tag.

docker build --file Dockerfile-base --tag my_sparc_request_base --build-arg SPARC_VERSION=x.x.x .

At this point you have a basic SPARCRequest Docker image without customization. The Dockerfile provides basic customization which replaces the default configuration files with ones that pull details from environment variables. To build this image run the command:

docker build --tag my_sparc_request --rm .

You now have a image that can be run to set up SPARCRequest. As there are a number of environment variables required to get SPARCRequest running it is easiest to copy the env.sample to .env and adjust the values to match your environment.

cp env.sample .env

SPARCRequest provides a number of rake tasks to setup the database which need to do be done before you can run the application. The easiest approach is to run the container from the command line and execute these tasks by hand

docker run -i -t --env-file=.env --rm my_sparc_request /bin/bash
bundle install && rake db:create && rake db:migrate

Finally, we can run the container now the database has been initialized

docker run -i -t --env-file=.env --rm my_sparc_request /bin/bash

Alternatively, you can use Docker Compose and the provided [docker-compose.yml] to bootstrap much of the environment.

Reproducing the slides

The slides were created with reveal-md. To view the presentation run

npm install -g reveal-md
reveal-md PRESENTATION.md

The background picture, Plasma, was created by doomlordvekk, and used under the Creative Commons license.