Either build the Docker image locally
docker build -t datascience-r .
or download the image from DockerHub
docker pull civisanalytics/datascience-r:latest
latest tag (Docker's default if you don't specify a tag)
will give you the most recently-built version of the
image. You can replace the tag
latest with a version number such as
to retrieve a reproducible environment.
To start a Docker container from the
datascience-r image and
interact with it from a bash prompt, use
docker run -i -t civisanalytics/datascience-r:latest /bin/bash
You can run commands via
docker run civisanalytics/datascience-r:latest Rscript -e "print('Hello World!')"
The image contains environment variables which allow you to find the current version. There are four environment variables defined:
VERSION VERSION_MAJOR VERSION_MINOR VERSION_MICRO
VERSION contains the full version string, e.g. "1.0.3". VERSION_MAJOR, VERSION_MINOR, and VERSION_MICRO each contain a single integer.
See CONTRIBUTING for information about contributing to this project.
If you make any changes, be sure to build a container to verify that it successfully completes:
docker build -t datascience-r:test .
and describe any changes in the change log.
Tag a Release
To integrate with Civis Platform, the following format for releases must be followed:
- Tag: vX.X.X (major.minor.micro).
- Title: vX.X.X
The 'Description' field is not used in Civis Platform integration, but by convention it should have the following format:
Description: [YYYY-MM-DD] followed by summary of changes.
This repo has autobuild enabled. Any PR that is merged to master will be built
latest tag on Dockerhub. Once the release is tagged, DockerHub will
automatically build three identical containers, with labels "major", "major.minor", and "major.minor.micro".
See LICENSE.md for details.