Run Bioconductor on Compute Engine¶
The properly rendered version of this document can be found at Read The Docs. If you are reading this on github, you should instead click here. |
Bioconductor maintains Docker containers with R, Bioconductor packages, and RStudio Server all ready to go! Its a great way to set up your R environment quickly and start working. The instructions to deploy it to Google Compute Engine are below but if you want to learn more about these containers, see http://www.bioconductor.org/help/docker/.
- Click on click-to-deploy Bioconductor to navigate to the launcher page on the Cloud Platform Console.
- Optional: change the Machine type if you would like to deploy a machine with more CPU cores or RAM.
- Optional: change the Data disk size (GB) if you would like to use a larger persistent disk for your own files.
- Optional: change Docker image if you would like to run a container with additional Bioconductor packages preinstalled.
- Click on the Deploy Bioconductor button.
- Follow the post-deployment instructions to log into RStudioServer via your browser!
If you want to deploy a different docker container, such as the one from BioC 2015: Where Software and Biology Connect or from https://github.com/isb-cgc/examples-R:
- In field Docker Image choose item
custom
. - Click on More to display the additional form fields.
- In field Custom docker image paste in the docker image path, such as
gcr.io/bioc_2015/devel_sequencing
orb.gcr.io/isb-cgc-public-docker-images/r-examples
.
Change your virtual machine type (number of cores, amount of memory)¶
- First, make sure results from your current R session are saved to the data disk (underneath
/home/rstudio/data
) or another location outside of the container. - Follow these instructions to stop, resize, and start your VM: https://cloud.google.com/compute/docs/instances/changing-machine-type-of-stopped-instance
“Stop” or “Delete” your virtual machine¶
If you would like to pause your VM when not using it:
- Go to the Google Cloud Platform Console and select your project: https://console.cloud.google.com/project/_/compute/instances
- Click on the checkbox next to your VM.
- Click on Stop to pause your VM.
- When you are ready to use it again, Start your VM. For more detail, see: https://cloud.google.com/compute/docs/instances/stopping-or-deleting-an-instance
If you want to delete your deployment:
- First copy any data off of the data disk that you wish to keep. The data disk will be deleted when the deployment is deleted.
- Click on Deployments to navigate to your deployment and delete it.