Cloud Workstations: an overview

General notes on the feature, with links to different implementations

Shahar Zaks avatar
Written by Shahar Zaks
Updated over a week ago

By default, when you click Reproducible Run on Code Ocean, we execute the master script, which runs all the code from beginning to end without user input. This run happens headlessly, that is, without a user interface to control it.

The alternative is running your code in a Cloud Workstation, where you can execute your code interactively: line-by-line, chunk-by-chunk, via point-and-click interfaces.

Another key aspect of reproducible runs is that when the run completes, we shut down the remote server to save resources. On Cloud Workstation, however, we keep it on so you can work continuously on that machine via your browser.

On the top right-hand side of your capsule, you'll see a 'Launch Cloud Workstation' icon. Click on the icon to launch the workstation you want to use.

They are Jupyter Lab, RStuido, Jupyter Notebook, terminal, Shiny apps, VS Code, and Streamlit respectively.

You need to have streamlit_app.py to launch a Streamlit cloud workstation

Which will then become whichever session you selected (in this example, Terminal):

General notes:

  1. Leaving a Cloud Workstation running will continuously use quota; click the Shut Down button to close the session.

  2. Changes to files in the /code  and /data folders in a Cloud Workstation session will be synced back to your capsule. Any changes to /results  or the environment will not be. Please record changes you made to either, and re-implement them in a non-cloud-workstation session, if you wish to save them.

Did this answer your question?