Skip to content

This repo provides instructions on how to build an R docker image that can serve as the basis for interactive or automated reproducible processing

License

Notifications You must be signed in to change notification settings

AEADataEditor/docker-r-starter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Docker image basic R image

Purpose

Many R replication packages have dependencies, which sometimes include the specific version of R (in particular before/after release of v4). This Docker image is meant to isolate and stabilize that environment, and should be portable across multiple operating system, as long as Docker is available.

Build

Adjust the needed packages

See the setup.R file, and update accordingly.

WARNING: not all packages might build, depending on whether the R base image has the relevant libraries. You might want to change R base image, or switch to another image from rocker.

Setup info

Set the TAG and IMAGEID accordingly.

TAG=v$(date +%F)
MYIMG=aer-9999-8888
MYHUBID=aeadataeditor

Build the image

docker build  . -t $MYIMG:$TAG

or if using the newer build system

DOCKER_BUILDKIT=1 docker build . -t $MYIMG:$TAG

Publish the image

The resulting docker image can be uploaded to Docker Hub, if desired.

docker push $MYHUBID/${MYIMG}:$TAG

Using the image

If using a pre-built image on Docker Hub:

docker run -it --rm $MYHUBID/${MYIMG}:$TAG

If using the image you just created:

docker run -it --rm $MYHUBID/${MYIMG}:$TAG

Somewhat more sophisticated, if you are in a project directory (for instance, the replication package you just downloaded), you can access it directly within the image as follows:

docker run -it --rm -v $(pwd)/subdir:/code -w /code $MYHUBID/${MYIMG}:$TAG

You can now start to run code.

NOTE

This entire process could be automated, using Travis-CI or Github Actions. Not done yet.

About

This repo provides instructions on how to build an R docker image that can serve as the basis for interactive or automated reproducible processing

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published