Skip to content

Latest commit

 

History

History
77 lines (51 loc) · 3.62 KB

README.md

File metadata and controls

77 lines (51 loc) · 3.62 KB

Overview

This repository contains Dockerfiles for different Docker containers of interest to R users.

What is R?

R is a system for statistical computation and graphics. It consists of a language plus a run-time environment with graphics, a debugger, access to certain system functions, and the ability to run programs stored in script files.

The R language is widely used among statisticians and data miners for developing statistical software and data analysis. Polls and surveys of data miners are showing R's popularity has increased substantially in recent years.

R is an implementation of the S programming language combined with lexical scoping semantics inspired by Scheme. S was created by John Chambers while at Bell Labs. R was created by Ross Ihaka and Robert Gentleman at the University of Auckland, New Zealand, and is currently developed by the R Development Core Team, of which Chambers is a member. R is named partly after the first names of the first two R authors and partly as a play on the name of S.

R is a GNU project. The source code for the R software environment is written primarily in C, Fortran, and R. R is freely available under the GNU General Public License, and pre-compiled binary versions are provided for various operating systems. R uses a command line interface; however, several graphical user interfaces are available for use with R.

Image Variants

Descripiton Tag Dockerfile
The latest release 4, 4.0.2, release, latest Dockerfile
The latest old release 3, 3.6.3, oldrel Dockerfile
The latest patched release patched Dockerfile
The latest development release devel Dockerfile
R base image + tidyverse + RSQLite, RMySQL, RPostgreSQL, odbc packages tidyverse Dockerfile

How to use this image

Interactive R

Launch R directly for interactive work:

$ docker run -ti --rm artemklevtsov/r-alpine:latest

Batch mode

$ docker run -ti --rm -v "$PWD":/tmp/rpkgs -w /tmp/rpkgs -u guest artemklevtsov/r-alpine:latest R CMD check .

Alternatively, just run a bash session on the container first. This allows a user to run batch commands and also edit and run scripts:

$ docker run -ti --rm artemklevtsov/r-alpine:latest /bin/ash
$ vi myscript.R

Write the script in the container, exit vim and run Rscript:

$ Rscript myscript.R

Dockerfiles

Use r-alpine as a base for your own Dockerfiles. For instance, something along the lines of the following will compile and run your project:

FROM registry.gitlab.com/artemklevtsov/r-alpine:latest
RUN apk --no-cache add sqlite-dev
RUN Rscript -e 'install.packages("RSQLite")'
COPY . /usr/local/src/myscripts
WORKDIR /usr/local/src/myscripts
CMD ["Rscript", "myscript.R"]

Build your image with the command:

$ docker build -t myscript /path/to/Dockerfile

Running this container with no command will execute the script. Alternatively, a user could run this container in interactive or batch mode as described above, instead of linking volumes.

License

The Dockerfiles in this repository are licensed under the GPL 2 or later. View R-project license information for the software contained in this image.