RUN@cloud » Getting Started with RUN@cloud

Getting Started with RUN@cloud

Last modified by Spike Washburn on 2013/03/07 06:30

Get Started Fastest with a ClickStart

A great way to get a feel for the platform - and actually build something is to run some ClickStarts - go and do one now ! It will tell you what to do. This will setup the whole chain for you, including repository, build and more.

Contents

Creating your first applications

This tutorial will quickly guide you through the application creation, testing, and deployment cycle for your application.

IMPORTANT: read (or at least install) about the CloudBees SDK. 

The quickest way: 

1. Log in to the console (run.cloudbees.com) - then, on the left click "Add New Application" - and away you go !
You will get a URL that shows your app running.  This is just a placeholder application, so you'll next want to update the application by deploying your own application package to it.

2. If you have an existing WAR file you can upload it directly from your application's page in the RUN web console.  If you don't have a WAR file, then you can use the CloudBees SDK or your favorite tools to create one.

Using RUN@cloud with the CloudBees SDK

The CloudBees SDK provides a rich command line tool that you can use to manage your RUN@cloud environment.  After you have installed the CloudBees SDK, it's trivial to create new cloud-ready application projects from scratch using the bees commands.

1. Create an application

bees create APP_NAME

Note: This will create a new application project in the APP_NAME folder so you can use the bees project commands.

2. Test the application by running it locally

bees run

Note: This will automatically create and launch a application server for running your application.  By default, this app will run on port 8080. 

3. Deploy the application to CloudBees

bees deploy

Note: This will automatically create a scalable cloud-based container for running your application and assign your app a hostname based on APP_NAME.

Using RUN@cloud with Maven

The CloudBees Maven plugin makes it easy to run your application locally, and deploy your application to the cloud.  Read the Maven Guide to information about configuring your Maven projects to use the CloudBees plugin.

1. Register the CloudBees Maven plugin in your pom.xml - See the Maven Guide for information about configuring this plugin.

2. Run your application in the local RUN@cloud server

mvn bees:run

3. Deploy your application

mvn bees:deploy -Dbees.appid=myapp

Note: Refer to the CloudBees Maven Guide for a more detailed overview.

Using RUN@cloud with an existing app

If you have an existing application that is packaged as a WAR file, you can deploy the WAR file directly to RUN@cloud using the SDK.

1. Package your application as a WAR file

2. Deploy your application
bees app:deploy -a ACCOUNT/APPID ./path_to_/application.war

Choosing a runtime (stack)

You can deploy a wide range of application types (not just Java!) to CloudBees.  Read up on the stacks that we have available here. It can be as simple as bees app:deploy -t tomcat7

Deploying bare JVM apps

A plain JVM app has a main method (public static void main in java land - similar in Scala, Clojure etc) - this can run just fine on CloudBees (you can even choose your JVM via the -Rjava_version=1.6, 1.7 or 1.8 parameter on the CLI). See here for more info.

Need to get application IP address, hostname or port?

See here.

Tags:
Created by Spike Washburn on 2011/07/08 23:29