You can create and manage OpenShift applications in the Eclipse IDE thanks to JBoss Tools. The following step-by-step guide shows you how to install, configure, and use this integration to create an OpenShift application.
Point your browser at the Eclipse download page and select the installation package for your needs. This guide uses 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.
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 by dragging Install (See below) to an open Eclipse window. Make sure that the version of JBoss Tools that you are using matches the version of Eclipse that you are using (Luna, Kepler, etc.).
Expand JBoss Tools and select JBoss OpenShift Tools:
Once the JBoss OpenShift tools have been installed, you will need to restart Eclipse:
Now that you have the toolset installed, it’s time to create a cloud project and begin development. Select File > New > Other > 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 sign up link or go here and create a new account.
After creating your account, you will 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: applicationName-domainName.rhcloud.com. The domain you select will be used for all of your deployed applications on OpenShift Online.
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
Enable scaling for your application
|Although in this guide, you are creating a new application, if you want to continue development on an existing application, select Use my existing OpenShift 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.
In order to communicate via git to your repository, you’ll need to configure your SSH keys. If you are a new OpenShift user, you can install the client tools and run
rhc setup - SSH keys are created and uploaded as part of this process. See Remote Connection (SSH) for more information.
If you are an existing OpenShift user, you 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 already 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. Log in to your OpenShift account, click Settings, and select to Add a new key….
Give your new key a name of JBossTools and paste the key into the textfield provided.
Learn more about configuring SSH keys at docs.openshift.com.
After creating and publishing your public SSH key to OpenShift, you are ready to clone your 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.
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.
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 applicatonName-namespace.rhcloud.com and you should see your brand new application deployed on the cloud.
An important step in developing software is the ability to view your server log files. In order to view the server log files, select the server tab, right click on your application, select OpenShift and then Tail Files…
This will open up the console view tab and allow you to monitor your logs files on the system.
When developing database driven applications, it is essential that you have access to connect to your database in both your development and production environments. Doing this without opening yourself up to security concerns is often a place where developers that are not intimately familiar with system administration and firewall configuration may stumble.
With OpenShift port forwarding, developers are now able to connect to their remote services while using local client tools without having to worry about the details of configuring complicated firewall rules.
In order to use port forwarding from inside of Eclipse, select the server tab, right click on your application, select OpenShift and then Port Forwarding…