Introduction

OpSource Cloud API is a RESTful web service interface that allows users to control their OpSource Cloud environment over HTTPS.

Goomgum is a .NET library that can be used to simplify access to Opsource Cloud API from .NET applications.

Goomgum wraps REST-style API operations in an OOP-style class library that can be used as a base for creating your own Opsource Cloud automation tools in .NET.

Goomgum currently features a small but growing subset of the parent API, a set of unit-tests that does not require access to the live API, and a sample command line utility that consumes the library.

Usage

With OpSourceCloudAPI.dll you can use LINQ and other .NET niceties to manage swarms of VMs with ease:

using OpSource;
using System.Linq;

var c = new Cloud("login", "password");
Account a = c.Authenticate();
var servers = a.GetServers().Where(s => s.Name.StartsWith("test"));
foreach(var s in servers)
   s.Start();

goomgum.exe allows you to start/stop multiple servers at once using * and ? wildcards:

>goomgum.exe -c start -n test* -l zvolkov -p [PASSWORD]
Connecting to OpSource Cloud as zvolkov...
Enumerating the servers...

Name                            IP Address        IsStarted
-------------------------       ---------------   ---------
test                            10.162.124.37               <-- Sending start request...

Feel free to download the binaries and try for yourself. Compiled for .NET Framework 4.0 Client Profile.

Development

Goomgum is currently developed in C# using VS 2010. The client library itself does not have any third-party dependencies, but the Unit Tests and the Command Line App depend on a few free libraries & tools such as Rhino Mocks, Command Line Parser Library and ILMerge.

If you want to participate I will be glad to give you write access to the repository.