roadie

README

roadie

A easy way to run your programs on Google Cloud Platform. See documents for more information.

Description

Roadie helps you to upload your source codes to the cloud, create and delete instances, and manage outputs.

For example,

$ roadie run --local . --name analyze-wowah script.yml

uploads your source codes in current directory, and run them in such a manner that script.yml specifies. The script.yml is a simple YAML file like

apt:
- unrar
data:
- http://mmnet.iis.sinica.edu.tw/dl/wowah/wowah.rar
run:
- unrar x -r wowah.rar
- analyze WoWAH

The above script.yml asks roadie to install apt package unrar and download a data file from such URL as the preparation. Then, it directs to run those two commands: unrar the downloaded file, analyze the obtained data files.

Roadie uploads results of such commands to a cloud storage after they finish. You can access those results by

$ roadie result get analyze-wowah "*" -o ./res

Then, Roadie downloads all result files into ./res directory.

Installation

Compiled binary files for some platforms are uploaded in release page.

If you're a Homebrew or Linuxbrew user, you can install Roadie by the following commands:

$ brew tap jkawamoto/roadie
$ brew install roadie

Initialization

After installing Roadie, the following initialization is required in order to authorize Roadie to access cloud services.

$ roadie init

License

This software except files in docker folder is released under The GNU General Public License Version 3, see COPYING for more detail.