Getting Started with RUN@cloud

The best way to get started with RUN@cloud is to get simple application deployed to the cloud so that you can get a feel for the way everything works.

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.

2. Download the app and modify it as you wish
bees getapp -a yourAccount/yourApp
.. change into downloaded project directory ...

3. RUN the application locally
bees run

4. Deploy the changes to your application
bees deploy

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

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

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

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.

1. Register the CloudBees Maven plugin in your pom.xml
<pluginRepositories>
  <pluginRepository>
    <id>bees-plugins-snapshots</id>
    <url>http://repository-cloudbees.forge.cloudbees.com/public-snapshot/</url>
    <releases>
      <enabled>false</enabled>
    </releases>
    <snapshots>
      <enabled>true</enabled>
    </snapshots>
   </pluginRepository>
</pluginRepositories>

<build>
  <plugins>
    <plugin>
      <groupId>com.cloudbees</groupId>
      <artifactId>bees-maven-plugin</artifactId>
    </plugin>
  </plugins>
</build>

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

3. Deploy your application

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