rorocloud

rorocloud is a service to run user’s code in pre-configured compute environments in the cloud.

The primary interface to interact with the rorocloud service is via a command-line tool called rorocloud.

Installation

The rorocloud client can be installed using pip.

$ pip install -U rorocloud

You can check the version of the rorocloud client you can using:

$ rorocloud version
rorocloud, version 0.1.3

Getting Started

Login

Login to rorocloud service to get started.

$ rorocloud login
email: anand@rorodata.com
password: ********
Login successful.

After login, your credentials will be saved permanently on your local computer. You can use the rorocloud whoami command to find the email address of logged in user.

$ rorocloud whoami
anand@rorodata.com

You need to have a valid login to use this service. Please write to us at rorodata.team@gmail.com if you don’t already have one.

Running Hello world

Once you are logged in, you can run commands in the cloud. Let us try with a simple one.

$ rorocloud run echo hello world
created new job ff4a0620

The rorocloud client submitted a new job to run the command echo hello world and the job id is ff4a0620. Let us look at the logs of the job.

$ rorocloud logs ff4a0620
starting the job
executing command
hello world
job finished with exit status 0

We can also run a command in foregrond by passing --foreground option.

$ rorocloud run --foreground echo helloworld
created new job cd5c7c7c
starting the job
executing command
helloworld
job finished with exit status 0

Running Jupyter Notebook

Jupyter notebooks are natively supported in rorodata. To start a jupyter notebook, run:

$ rorocloud run:notebook
created new job 60984179
starting the job
executing command
Jupyter notebook is available at:
http://60984179.apps.rorocloud.io/?token=rorocloud

The jupyter notebook server can be stopped using:
    rorocloud stop 60984179

That would start a jupyter notebook and the URL to access the notebook will be printed. The notebook server is protected using a token.

The jupyter notebook server will continue to run even after closing the browser window and it must be stoped using rorocloud stop command.

The notebooks will be stored in /data/notebooks directory.

Copying files

The put command copies a local file into the cloud.

For example, to copy a file hello.py from current directory to /data:

$ rorocloud put hello.py /data/hello.py

Status of Jobs

The status of currently running jobs be seen using:

$ rorocloud status
JOBID     STATUS    WHEN            TIME     CMD
--------  --------  --------------  -------  ------------------------------
60984179  running   14 minutes ago  0:14:18  /opt/rorodata/jupyter-notebook
74ee24a1  running   24 minutes ago  0:24:47  python train.py