Saturday, 26 January 2013

Step 1:  Install Eclipse

Point your browser at the eclipse download page and select the installation package for your needs.  For this blog post, I will be using the Eclipse IDE for Java Developers package.

After downloading eclipse, extract the archive and you will have an eclipse directory.  Inside of this directory, you will have an Eclipse executable that will start the IDE.

Step 2: Install JBoss Tools

Once you have Eclipse up and running, the next step is to install the JBoss Tools package that provides the OpenShift integration.  You can install JBoss Tools from the Eclipse marketplace. Make sure that the version of JBoss Tools that you are using matches the version of Eclipse that you are using (Indigo, Juno, etc.).

Expand JBoss Tools and select JBoss OpenShift Tools.

Once the JBoss OpenShift tools have been installed, you will need to restart Eclipse.

Step 3:  Create an OpenShift Project

Now that we have the toolset installed, it’s time to create our cloud project and begin development.  Select File -> New -> Other -> Expand OpenShift -> OpenShift Application and click Next.

Before you can start creating and deploying your projects, you will need to authenticate with the OpenShift web services via the dialog provided.

If you do not already have an OpenShift account, click the signup button or head on over to the OpenShift web site and create a new account.

After creating your account, you will also need to specify a domain that you want to use for your applications.  The domain is used to create the unique URL for your running application with the following template:
The domain you select will be used for all of your deployed applications on the Red Hat Cloud.

Once you have successfully authenticated to the OpenShift web services, you will be presented with the Setup OpenShift Application Wizard.  The dialog provides the following functionality:
  • Use an existing application that is already deployed on your OpenShift account
  • View details for existing application
  • Create new application
  • Add cartridges to your application
  • Specify your gear size (Small / Medium / Large)
  • Enable scaling for your application

Note: We will be creating a new application, if you want to continue development on an existing application, select use an existing application and click browse.  This will create a new Eclipse project and perform a git clone on your existing git repository.

In order to create a new application, give your application a name and select which cartridge or application server that your deployment will target.  At the time of this writing, OpenShift provides support for JBoss AS 7, PHP, perl, ruby, python, node.js, and diy.

Step 4: Configure your ssh keys

In order to communicate via git to your repository, we need to configure our ssh keys.  If this is the first time you have used OpenShift, and go through the domain creation wizard, a key will be created and automatically uploaded for you.

If you are an existing OpenShift user, we will need to use your existing key or create a new one.  Fortunately, we provide a UI to accomplish this task as well. Click the SSH2 Preferences link provided in order to create your keys.

If you don’t have a ssh key created on your machine, select the Key Management tab -> Generate RSA Key.  Provide a passphrase if you desire and then click Save Private Key.  You will also want to copy your public key that is displayed so that we can add it to OpenShift.

Now that you have a key pair generated, we need to tell OpenShift what our public key is.  Login to OpenShift website, click Manage your Apps, click on My Account, and select to Add a new key.

Give your new key a name of JBossTools and paste the key into the textfield provided.

Step 5: Clone your repo

After creating and publishing your public ssh key to OpenShift, we are ready to clone our repo and begin development.  Switch back over to your Eclipse IDE and click the finish button.  This will create your project and clone the private git repository that lives on the OpenShift servers.

Step 6: Code
This is what you love to do.

Step 7: Update maven configuration
You may notice an error marker next your project after you have cloned your git repository.  This is easily fixed by updating your maven project configuration.  Right click on your project, select maven, and then update project configuration.

Step 8: Deploy your code to the cloud

Once you have modified some of your source files, click the server tab at the bottom of the screen.  You should see your OpenShift application listed.  In order to push your changes live, right click on your application and select publish.

Once the push process is complete, point your browser to
and you should see your brand new application deployed on the cloud.


Post a Comment

Find me on Facebook! Follow me on Twitter!