first update

Author: GuidoMaggio

version-stable-r-development.Rmd

@@ -22,27 +22,30 @@ environments or projects.
 ## Version-stable deployments
 
 When deploying R applications (e.g. a Shiny app) using Docker containers, it is
-important to control versioning of R and packages for the sake of reproducibilty
+important to control versioning of R and packages for the sake of reproducibility
 and stability of the deployments. For this reason,
-[version-stable](https://github.com/rocker-org/rocker-versioned) images are
+[version-stable](https://github.com/rocker-org/rocker-versioned2) images are
 provided as part of the [Rocker project](https://www.rocker-project.org/) and
 used as a basis for deploying productive applications.
 
 Each version-stable Rocker image has an associated _tag_ for all non-latest R
-versions (e.g. `rocker/r-ver:3.6.1`). Besides being specific to the
+versions (e.g. `rocker/r-ver:4.3.2`). Besides being specific to the
 corresponding version of R, each tag fixes the version of contributed packages
-(by using as package repository the MRAN snapshot of the last day CRAN
+(by using as package repository the CRAN snapshot of the last day CRAN
 distributed that R version as latest release). See
-[VERSIONS.md](https://github.com/rocker-org/rocker-versioned/blob/master/VERSIONS.md)
+[wiki/Versions](https://github.com/rocker-org/rocker-versioned2/wiki/Versions).
+If that R version is the latest, the CRAN date will not be set and the latest packages will always be installed.
+
 
 The `Dockerfile` of a deployed application then defines a given version-stable
 image tag to start `FROM`, e.g.
 ```dockerfile
-FROM rocker/r-ver:3.6.1
+FROM rocker/r-ver:4.3.2
 ```
 See
 [SmaRP/Dockerfile](https://github.com/miraisolutions/SmaRP/blob/master/Dockerfile)
 for an example.
+<!-- NOTE: Not yet merged into master -->
 
 
 ## Align local development and deployment environments
@@ -57,7 +60,7 @@ The idea is then to rely on the same version-stable rocker containers used for
 the deployments, using a containerized versioned RStudio instance for the local
 development. This is available through Rocker's [versioned
 stack](https://www.rocker-project.org/images/#the-versioned-stack), so we could
-use e.g. `rocker/rstudio:3.6.1`.
+use e.g. `rocker/rstudio:4.3.2`.
 
 Note that the same version-stable instance of RStudio can be used across all
 different projects for which such version is relevant. For this reason, a
@@ -69,12 +72,12 @@ install. See the specific section below about 'TinyTeX considerations'.
 
 ### Running versioned RStudio instances
 
-Assume we want to run a containerized versioned instance of RStudio for R 3.6.1,
+Assume we want to run a containerized versioned instance of RStudio for R 4.3.2,
 possibly alongside instances for other versions of R.
 
 First of all, we need to get the image from docker-hub
 ```{bash pull}
-docker pull rocker/verse:3.6.1
+docker pull rocker/verse:4.3.2
 ```
 
 We then want to have a running instance on `localhost` (`127.0.0.1`), with the
@@ -83,7 +86,7 @@ following setup:
 - No authentication required (local setup).
 - Enable root by setting the environment variable `ROOT` to `TRUE`, so that e.g.
 `sudo apt-get` can be used in RStudio.
-- Use a version-specific port, e.g. `3500` for R 3.5.0, `3610` for R 3.6.1 and
+- Use a version-specific port, e.g. `4000` for R 4.0.0, `4320` for R 4.3.2 and
 so on, so that we can use `localhost` for concurrent R version instances.
 - The development code of all relevant projects should live outside the
 container and be shared with it (and possibly many of them), e.g. under
@@ -94,19 +97,19 @@ the container.
     the container user (`rstudio`) must match the UID of the host user (`$UID`).
 - In order for the RStudio setting to persist if the container is recreated
 (e.g. after pulling a new `rocker` image), we also use a shared volume (like
-`~/.rstudio-docker/3.6.1`) for the `home/rstudio/.rstudio` directory, which is
+`~/.rstudio-docker/4.2.3`) for the `home/rstudio/.rstudio` directory, which is
 version-specific in case of multiple R versions
 - If we want to use Meld via the [compareWith](https://github.com/miraisolutions/compareWith/) addins, we need to
     - map the `DISPLAY` environment variable and volume `/tmp/.X11-unix`
     - add `DISPLAY` to `Renviron`
     - install Meld
     - install `dbus-x11`
 - Use a version-specific name for the container running the RStudio instance,
-e.g. `rstudio_3.6.1`.
+e.g. `rstudio_4.2.3`.
 
 
 ```{bash run}
-R_VER=3.6.1
+R_VER=4.3.2
 SHARED_DIR=RStudioProjects
 docker run -d --restart=always \
   -p 127.0.0.1:$(echo $R_VER | sed 's/[.]//g')0:8787 \
@@ -166,19 +169,19 @@ run_rstudio_ver() {
 
 which you can re-use as compact command for any R version as follows
 ```{bash run_rstudio_ver-use}
-run_rstudio_ver 3.6.1 RStudioProjects
+run_rstudio_ver 4.3.2 RStudioProjects
 ```
 
 Note that `--restart=always` specifies that the container should stay up and restart
 itself after stopping, e.g. upon machine reboot or docker upgrade, so that it is
 always available. Still, you can explicitly stop the running container with
 ```{bash stop}
-docker stop rstudio_3.6.1
+docker stop rstudio_4.3.2
 ```
 Alternatively, you can omit `--restart=always` and explicitly start the
 container whenever needed with
 ```{bash start}
-docker start rstudio_3.6.1
+docker start rstudio_4.3.2
 ```
 
 Note that `start`/`stop` operations do not affect the persistence of files
@@ -213,21 +216,21 @@ If you are using LaTeX and start seeing errors like
 Remote repository is newer than local (2018 < 2019)
 ```
 it means that you have to re-install TinyTeX. This happens e.g. with
-`rocker/verse:3.6.1`, since it was build at the end of 2018 but the current
+`rocker/verse:4.3.2`, since it was build at the end of 2018 but the current
 Tex Live repo is 2019. You can fix this via a **user-specific** re-installation of
 TinyTeX for R. **NOTE** however that this will uninstall the system-level
 TinyTeX pre-installed in `rocker/verse`.
 
 First, make sure `/home/rstudio/bin` is part of the `PATH` environment variable.
 Check this by running
 ```{bash check-path}
-docker exec --user rstudio rstudio_3.6.1 R --slave -e 'Sys.getenv("PATH")'
+docker exec --user rstudio rstudio_4.3.2 R --slave -e 'Sys.getenv("PATH")'
 ```
 If you don't see `/home/rstudio/bin`, you can make sure it is part of the `PATH` for R via
 ```{bash set-path}
-docker exec --user rstudio rstudio_3.6.1 sh -c 'echo "PATH=$HOME/bin:\${PATH}" >> $HOME/.Renviron'
+docker exec --user rstudio rstudio_4.3.2 sh -c 'echo "PATH=$HOME/bin:\${PATH}" >> $HOME/.Renviron'
 # check again
-docker exec --user rstudio rstudio_3.6.1 R --slave -e 'Sys.getenv("PATH")'
+docker exec --user rstudio rstudio_4.3.2 R --slave -e 'Sys.getenv("PATH")'
 ```
 
 Then, from the running RStudio, run
@@ -239,7 +242,7 @@ tinytex::reinstall_tinytex()
 ### Cleanup
 
 ```{bash cleanup}
-docker rm $(docker stop rstudio_3.6.1)
+docker rm $(docker stop rstudio_4.3.2)
 ```