Skip to content

helxplatform/rstudio-server

Repository files navigation

Introduction

This project creates a docker image that contains rstudio-server. It is built from source and meant to run as a single user and also within our HeLx platform. It has also been made to run on an OpenShift cluster using an arbitrary user ID.

Configuring

Some configuration variables can be set in the "config.env" file. RSTUDIO_SOURCE_TAG can be used to set the version of the rstudio source code tarball to download. There are others to set the image tag and registry. Also some to use when running the container locally. "run.env" can be used to set variables within the container when running.

Building

To build the image you can use the basic docker command or use the included Makefile.

  make build

To build the image without using the docker cache you can use the 'build-nc' argument.

If you have already built an image for rstudio-server and you don't need to rebuild the jenkins-rstudio-builder you can use the 'build-only-r-s' to bypass the recreation of the builder image.

Updating

If you have already built an image for rstudio-server and need to update the rstudio source tag that is used to pull down the source tarball then you should use the 'clean' make argument to remove the 'rstudio-src' directory.

make clean
make build

Running Locally

  make run

Then connect to localhost:8787 in your web browser.

Publishing Image to Registry

To push the image to the configured registry (in config.env) use the 'publish' argument.

  make publish

To build the image without the docker cache and publish you can use the 'release' argument.

Container Environment Variables

USER | NB_USER : Used to change the username of the process running within the container.

RSTUDIO_PREFIX | NB_PREFIX : Used to set the URL path prefix to access rstudio.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors