CloudBees Plugin

Description

CloudBees provides Platform as a Service for Java that offers a complete end-to-end environment, from development to production. As a Java (and hence, Groovy & Grails) developer, you can more easily create quality software by putting your code into the DEV@cloud build system, and from there instantly publishing your application to the cloud using RUN@cloud for Java.

This operation requires interaction with the CloudBees API through their SDK. This plugin exposes the CloudBees SDK API through a series of command line scripts. The CloudBees SDK does not need to be installed on your box for this to work. Simply install the plugin and start invoking commands to the cloud.

Installation

grails install-plugin cloud-bees

Application Configuration

Go to the CloudBees website and set up an account, then insert the following configuration in your ~/.grails/settings.groovy or BuildConfig.groovy:

cloudbees.account='CLOUD_BEES_ACCOUNT'
cloudbees.api.key='CLOUD_BEES_API_KEY'
cloudbees.api.secret='CLOUD_BEES_API_SECRET'

Provide the account name as well as the API key and secret as required.

It is also possible to set PermGen size for your deployed application by adding the following to ~/.grails/settings.groovy or BuildConfig.groovy

cloudbees.permgensize = 128

This will set the PermGen memory size to 128MB on subsequent deployment using bees-app-deploy.

Commands

All commands are issued prefixed by the grails command, or in the interactive shell. e.g

grails bees-app-list

The following commands are provided:

bees-app-checksums [appId]
bees-app-delete [appId]
bees-app-deploy [appId] [tag]
bees-app-info [appId]
bees-app-list
bees-app-restart [appId]
bees-app-start [appId]
bees-app-stop [appId]
bees-app-tail [LOGNAME] [appId]
bees-test-app
bees-db-create [dbId] [username] [password]
bees-db-drop [dbId]
bees-db-info [dbId]
bees-db-list

All commands have comprehensive help, which can be viewed as follows:

$ grails help bees-app-deploy
…
Environment set to development
    grails bees-app-deploy -- Deploy a new version of an application using a WAR archive file.
Usage (optionals in square brackets):
grails bees-app-deploy [appId] [tag]
    appId : application id (defaults to application name)
    tag   : release tag (defaults to application version)

Don't forget to run the war command before running bees-app-deploy. The bees-app-deploy command doesn't build the war itself.

Source Code

Source code can be found on GitHub at: https://github.com/marcoVermeulen/grails-cloud-bees

Issue Tracking

Issues and and feature requests can be added at Jira: http://jira.grails.org/browse/GPCLOUDBEES