gfinak / containerit

Package an R workspace and all dependencies as a Docker container

containerit

containerit packages R script/session/workspace and all dependencies as a Docker container by automagically generating a suitable Dockerfile. The packages’s website at https://o2r.info/containerit/. A good summary of what the package does can be found in this o2r project blog post.

Quick start

Install

Development version from GitHub.

devtools::install_github("o2r-project/containerit")

Use

See the vignettes at vignettes/containerit.Rmd for usage from the R command line, and vignettes/container.Rmd for the usage from a regular command line interface based on containers from Docker Hub.

Containers

Images are available starting from different base images. All images are also available with version tags.

verse

Base image: rocker/verse:3.4.4

geospatial

Base image: rocker/geospatial:3.4.4

Contribute

All help is welcome: asking questions, providing documentation, testing, or even programming.

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

Development

r-hub builder is great for running checks, e.g. before submitting to CRAN and on other operating systems.

library(rhub)
rhub::check_for_cran()
rhub::check_on_windows()

You can build the pkgdown site with

pkgdown::build_site()

You can build the Docker images locally with the current development version using the following commands.

docker build --tag containerit:dev --file inst/docker/Dockerfile.local .
docker build --tag containerit:geospatial-dev --file inst/docker/geospatial/Dockerfile.local .

License

containerit is licensed under GNU General Public License, version 3, see file LICENSE.

Copyright (C) 2018 - o2r project.