3. Setup Singularity¶

The Singularity image may be downloaded from Singularity Hub by users without sudoer rights by running the following:

singularity pull --name rserver-launcher-centos7.simg shub://OSC/centos7-launcher


Alternatively, Build The Singularity Image¶

Running a build is trivial but does require sudoer access to the build host.

Where Singularity is the file that defines the image. The image is basic, installing only the command which over the base CentOS 7 packages. This simplicity is because most of the actual executables and libraries must be bound and mounted into the container/guest at runtime from the host. By bind-mounting executables and libaries from the host system we are able to swap RStudio versions at launch time without having to update the Singuarlity image.

Likewise the runscript defined in the image uses the host $PATH which is propagated into the guest’s environment as $USER_PATH.

An example Singularity file for running RStudio:

Bootstrap: yum
OSVersion: 7
MirrorURL: http://mirror.centos.org/centos-%{OSVERSION}/%{OSVERSION}/os/$basearch/ Include: yum %labels Maintainer OSC Gateways %help This will run RStudio Server which must be mounted with dependencies into the container %apprun rserver if ! [[ "$USER_PATH" = "" ]]; then
export PATH="$USER_PATH" fi exec rserver "${@}"

%runscript
if ! [[ "$USER_PATH" = "" ]]; then export PATH="$USER_PATH"
fi

exec rserver "\${@}"

%post
yum install -y which