Friday, March 9, 2012

Getting started with the OpenShift Express Web Management Console

This week the newest release of OpenShift brought two really great features to an already awesome PaaS Cloud provider. First, JBoss AS has been upgraded from 7.0 to 7.1 and the all new Express Web Management Console has been released as a preview. In this article we examine how to use this new console and will help you create and then destroy an application.

Overview
Figure 1: follow link to launch
the Express Console
In this section we assume you have already registered as an OpenShift user and are logged into the OpenShift Express start page. In figure 1 the Express landing page is shown and if you follow the Express Console link you will be brought to a page that currently shows the old administration console and includes a link to Preview the new OpenShift Management Console. Follow this link to the preview as shown for my user in figure 2.

Figure 2: preview Express
management console
It provides an overview of the users existing application, with a Details button for each application. My user has two application already created, one a jBPM web editor project based on JBoss and a second PHP twitter project that makes use of mongodb as a backend, see figure 2. At the top of the applications list, you have a button to Create a New Application. We will be using this button to create an existing project called kitchensinkhtml5, a mobile application from the JBoss project Aerogear. The nice thing about this demo project is that you can view it both in your desktop browsers and in your mobile devices.
Figure 3: choose a type
of application

Create application
Since this user already has created a domain and has existing applications setup, we just need to start by using the Create a New Application button. This takes us to the first of three steps where we will choose a type of application, which will be the JBoss Application Server 7.1 chosen by the Select button shown in figure 3.

Figure 4: create application
The next step is to configure and deploy the application, done by filling in an application name in the provided text box and clicking on the Create Application button. We will be calling this application kitchensinkhtml5, so we fill in that name in the text box and submit to create our new application as shown in figure 4.

Figure 5: next steps
Once we submit our creation request, the OpenShift Express magic is started to setup our new instance with JBoss AS 7.1 started. We are presented with a final screen that is labeled Next Steps which provides information on accessing your application, making code changes, how to manage your application and how to start adding capabilities. As shown in figure 5, we will be pulling in a git clone of our Express application repository so that we can setup our kitchensink application code. As stated in the section making code changes we will clone the repository locally from a shell command line:

git clone ssh://8df3de8e983c4b058db372e51bfe5254@kitchensinkhtml5-inthe.rhcloud.com/~/git/kitchensinkhtml5.git/
cd kitchensinkhtml5/
Once that is done we need to pull in our existing kitchensink code base:

cd kitchensinkhtml5
git remote add upstream -m master git://github.com/eschabell/kitchensink-html5-mobile-example.git
git pull -s recursive -X theirs upstream master
 Finally, we push this back upstream to our Express instance as follows: 
git push  
We can now view the application at the URL assigned to our Express instance: 
http://kitchensinkhtml5-{$domainname}.rhcloud.com

You should see the mobile member registration application as shown here in figure 6.
Figure 6: mobile application

Destroy application
A final action that you can do with the new OpenShift Express Web Management Console is to destroy your application. As we only get five instances at a time, you will soon find yourself creating and destroying Express instances with ease.

Figure 7: delete application
After logging in as described above and starting the preview of the web management console, you will see your list of existing applications. By selecting an applications Details button you will be shown an overview of the application, see figure 7 for our example editor application we will be destroying.

Figure 8: application deleted
You will notice a Delete button in the right top corner of the application overview screen, see figure 7. When selected, you will be asked to confirm that you really want to destroy this application. If you confirm this decision by clicking on the Delete button, your application and Express instance will be cleaned up. You will be returned to the application overview screen, see figure 8, and are ready for your next interaction with the Express Web Administration Console.

Summary
In this article we have covered the very basics of the newly released OpenShift Express Web Administration Console. We have shown you how to view your applications, create a new application and how to free up an Express instance by destroying one of your applications.