{"id":19402720,"url":"https://github.com/cscfi/rstudio-openshift","last_synced_at":"2025-11-08T05:03:17.958Z","repository":{"id":44468772,"uuid":"173299244","full_name":"CSCfi/rstudio-openshift","owner":"CSCfi","description":null,"archived":false,"fork":false,"pushed_at":"2024-05-07T08:44:22.000Z","size":73,"stargazers_count":7,"open_issues_count":1,"forks_count":15,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-01-07T12:24:45.191Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CSCfi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-03-01T12:35:51.000Z","updated_at":"2023-08-28T08:54:52.000Z","dependencies_parsed_at":"2024-11-10T11:37:20.462Z","dependency_job_id":null,"html_url":"https://github.com/CSCfi/rstudio-openshift","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CSCfi%2Frstudio-openshift","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CSCfi%2Frstudio-openshift/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CSCfi%2Frstudio-openshift/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CSCfi%2Frstudio-openshift/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CSCfi","download_url":"https://codeload.github.com/CSCfi/rstudio-openshift/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240577769,"owners_count":19823510,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-10T11:25:26.747Z","updated_at":"2025-11-08T05:03:17.910Z","avatar_url":"https://github.com/CSCfi.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# RStudio Openshift\n\nRun [RStudio](https://www.rstudio.com/) integrated development environment and\n [Shiny](https://www.rstudio.com/products/shiny/shiny-server/) application server\n on the Red Hat OpenShift platform. This package is based on the Kubernetes solution from\n \u003chttps://github.com/Uninett/helm-charts\u003e\n\nTemplate for notebooks.csc.fi can be found from [template_imageready -branch](https://github.com/CSCfi/rstudio-openshift/tree/template_imageready)\n\n## How to use this template\n\nInstall the template by downloading the rstudio-template.yaml file and import it to\nyour OpenShift project via a web console. CLI instructions are below.\n\nRStudio default working directory is located on persistent storage. Save all your\nwork under the default working directory to avoid data loss. Files saved under\nother locations will be lost when the pod serving application restarts or changes after\nredeployment.\n\n### Variables\n\nAll variables are mandatory for the application to be created. When using CSC Rahti\nservice, consult [Rahti Documentation](https://rahtiapp.fi/) for the details of\ncomputing environment and project quotas.\n\n- **Application Name**: (NAME) Unique identifier for your application. Recommended\n value - your username\n- **Username**: (USER) Create a new username for logging into RStudio\n- **Password**: (PASSWORD) Create a new password for logging into RStudio\n- **Storage Size for Shiny**: (STORAGE_SIZE) Persistent Storage Size (Default 1G)\n- **Storage Size for Rstudio work folder**: (STORAGE_SIZE_TMP) Persistent Storage Size for the working directory in (Default 1G)\n- **Application Hostname Suffix**: (APPLICATION_DOMAIN_SUFFIX) The exposed hostname\n  suffix that will be used to create routes for app (Default when using CSC Rahti\n  service: rahtiapp.fi)\n\nThe initial quota of 50G is shared by both `STORAGE_SIZE` and `STORAGE_SIZE_TMP`. So the sum of both values cannot be bigger than 50G.\n\n## If running through the Command line\n\nDownload the oc client for Openshift and rstudio-template.yaml from GitHub.\n\n- `oc login \"openshift-address\" --token=\"token\"`\n- `oc new-project \"project-name\"`\n\nProcess and apply template using default values from the template and passing your  application specific parameters.\n\n- `oc process -f rstudio-template.yaml -p NAME=\"application-name\" -p USER=\"your-username\" -p PASSWORD=\"your-password\" | oc apply -f -`\n\n### Deleting application and project\n\n- `oc delete all -l app=rstudio`\n- `oc delete secret -l app=rstudio`\n- `oc delete cm -l app=rstudio`\n\nYou might also want to delete the persistent volume created by the setup by\n\n- `oc delete pvc -l app=rstudio`\n- `oc delete project \"project-name\"`\n\n### Using Allas object storage\n\n[How to use Allas from RStudio using AWS credentials and aws.s3 package](https://github.com/CSCfi/rstudio-openshift/blob/master/Allas.md)\n\n## Publish an application to Shiny\n\nShiny is an application server for R. This template runs it by default, but if you develop an application and want to deploy it to Shiny, you will need to do a manual copy of the files. The procedure is:\n\n1. Login in the rstudio terminal. You need to find a **running** `rstudio-...` Pod. You can do this from the webinterface or from the command line. Follow [How to open a terminal to a Pod?](https://docs.csc.fi/support/faq/terminal-rahti-pod/).\n\n1. Once in the terminal, you will find the application you developed in Rstudio located in `/home/rstudio-server/`. Shiny, on the other hand, will serve any application located in the folder `/srv/shiny-server`. Shiny will look for a file called `app.R`. You can copy the application by:\n\n\t```sh\n\tcp -r /home/rstudio-server/* /srv/shiny-server/\n\t```\n\n\tFor every change in your application that you want to be published, you need to make this copy again.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcscfi%2Frstudio-openshift","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcscfi%2Frstudio-openshift","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcscfi%2Frstudio-openshift/lists"}