6:28 p.m.
Author: irooskov(a)redhat.com
Date: 2011-12-01 19:28:04 -0500 (Thu, 01 Dec 2011)
New Revision: 36855
Added:
trunk/openshift/docs/reference/en-US/Creating_an_OpenShift_Express_Application.xml
trunk/openshift/docs/reference/en-US/images/Creating_an_OpenShift_Express_Application/
trunk/openshift/docs/reference/en-US/images/Creating_an_OpenShift_Express_Application/application_creation_01.png
trunk/openshift/docs/reference/en-US/images/Creating_an_OpenShift_Express_Application/application_creation_02.png
trunk/openshift/docs/reference/en-US/images/Creating_an_OpenShift_Express_Application/application_creation_03.png
trunk/openshift/docs/reference/en-US/images/Creating_an_OpenShift_Express_Application/application_creation_04.png
trunk/openshift/docs/reference/en-US/images/Creating_an_OpenShift_Express_Application/application_creation_05.png
trunk/openshift/docs/reference/en-US/images/Creating_an_OpenShift_Express_Application/application_creation_06.png
trunk/openshift/docs/reference/en-US/images/Creating_an_OpenShift_Express_Application/application_creation_07.png
trunk/openshift/docs/reference/en-US/images/Creating_an_OpenShift_Express_Application/application_creation_08.png
Log:
updated with new info for JBIDE-9793
Added: trunk/openshift/docs/reference/en-US/Creating_an_OpenShift_Express_Application.xml
===================================================================
--- trunk/openshift/docs/reference/en-US/Creating_an_OpenShift_Express_Application.xml
(rev 0)
+++
trunk/openshift/docs/reference/en-US/Creating_an_OpenShift_Express_Application.xml 2011-12-02
00:28:04 UTC (rev 36855)
@@ -0,0 +1,182 @@
+<?xml version='1.0' encoding='utf-8' ?>
+
+ <chapter
id="chap-OpenSift_Tools_Reference_Guide-Creating_an_OpenShift_Express_Application">
+ <title>Creating an OpenShift Express Application</title>
+ <para>
+ From the workbench go to
<menuchoice><guimenuitem>File</guimenuitem><guimenuitem>New</guimenuitem><guimenuitem>Other</guimenuitem></menuchoice>.
+ </para>
+ <figure id="application_creation_01">
+ <title>Selecting the OpenShift Express Application wizard</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/Creating_an_OpenShift_Express_Application/application_creation_01.png"
format="PNG" />
+ </imageobject>
+ <textobject>
+ <phrase>
+ Wizard selection screen with the OpenShift Express Application wizard selected.
+ </phrase>
+ </textobject>
+ </mediaobject>
+ </figure>
+ <para>
+ In the wizard, go to and select
<menuchoice><guimenuitem>OpenShift</guimenuitem><guimenuitem>OpenShift
Express Application</guimenuitem></menuchoice>. With the wizard choice
selected, click on the <guibutton>Next</guibutton> button.
+ </para>
+ <figure id="application_creation_02">
+ <title>Validating OpenShift credentials</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/Creating_an_OpenShift_Express_Application/application_creation_02.png"
format="PNG" />
+ </imageobject>
+ <textobject>
+ <phrase>
+ Sever connection screen where you will validate your username and password for
OpenShift or you can sign up for an account.
+ </phrase>
+ </textobject>
+ </mediaobject>
+ </figure>
+ <para>
+ If you have already signed up for an OpenShift Express account then you can input your
<guilabel>Username</guilabel> and <guilabel>Password</guilabel>
here and click <guilabel>Validate</guilabel>. If validation is successful you
will see the button is now unavailable and no error was presented.
+ </para>
+ <para>
+ If you do not have an OpenShift Express account, you can create one through the link at
the top of the wizard screen. This will open the OpenShift sign-up page within your
workbench. Once you have created an account you will need to relaunch the
<guilabel>OpenShift Express Application</guilabel> wizard and input your new
username and password.
+ </para>
+ <para>
+ Click the <guibutton>Next</guibutton> button to proceed.
+ </para>
+ <figure id="application_creation_03">
+ <title>Setting the domain name</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/Creating_an_OpenShift_Express_Application/application_creation_03.png"
format="PNG" />
+ </imageobject>
+ <textobject>
+ <phrase>
+ Creating a domain name or inserting one that already exists for your OpenShift
account.
+ </phrase>
+ </textobject>
+ </mediaobject>
+ </figure>
+ <para>
+ If you already have a domain name then you can type this into the
<guilabel>Domain name</guilabel> field.
+ </para>
+ <para>
+ If you need to create a domain, type the name you wish to have into the
<guilabel>Domain name</guilabel> field and click the
<guibutton>Create</guibutton> button. After clicking
<guibutton>Create</guibutton>, you will need to provide your public SSH key.
You will need to ensure that the paired private key is listed within the SSH2 Preferences.
If you are unsure, click the <guilabel>SSH2 Preferences</guilabel> link in the
window. Click <guibutton>Finish</guibutton> to complete domain creation.
+ </para>
+ <figure id="application_creation_04">
+ <title>Creating a domain name</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/Creating_an_OpenShift_Express_Application/application_creation_04.png"
format="PNG" />
+ </imageobject>
+ <textobject>
+ <phrase>
+ Going through the process of creating a domain name.
+ </phrase>
+ </textobject>
+ </mediaobject>
+ </figure>
+ <note>
+ <para>
+ If you ever wish to rename your domain, you can do so by changing the name as it
appears in the <guilabel>Domain name</guilabel> field and then click
<guibutton>Rename</guibutton>.
+ </para>
+ </note>
+ <para>
+ Click the <guibutton>New</guibutton> in the <guilabel>Available
Applications</guilabel> section of the wizard to begin creating your first OpenShift
application for the specified domain.
+ </para>
+ <figure id="application_creation_05">
+ <title>Creating a new OpenShift Express application</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/Creating_an_OpenShift_Express_Application/application_creation_05.png"
format="PNG" />
+ </imageobject>
+ <textobject>
+ <phrase>
+ Specifying the name and cartridge for the new OpenShift Express application.
+ </phrase>
+ </textobject>
+ </mediaobject>
+ </figure>
+ <para>
+ You will need to specify a name for the application and the platform to deploy for,
from the <guilabel>Cartdige</guilabel> drop-down list. Click
<guibutton>Finish</guibutton> to create the application.
+ </para>
+ <note>
+ <para>
+ No underscores or special characters are allowed in the application name.
+ </para>
+ </note>
+ <figure id="application_creation_06">
+ <title>Created application availability</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/Creating_an_OpenShift_Express_Application/application_creation_06.png"
format="PNG" />
+ </imageobject>
+ <textobject>
+ <phrase>
+ The created application is now available in the Available Applications section.
+ </phrase>
+ </textobject>
+ </mediaobject>
+ </figure>
+ <para>
+ You can select an available application by clicking on it in the
<guilabel>Available Applications</guilabel> section of the window. Having
selected an application, you can now <guibutton>Delete</guibutton> or view the
details of the application by clicking the <guibutton>Details</guibutton>; try
that now.
+ </para>
+ <figure id="application_creation_07">
+ <title>Application details</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/Creating_an_OpenShift_Express_Application/application_creation_07.png"
format="PNG" />
+ </imageobject>
+ <textobject>
+ <phrase>
+ The details screen for the application.
+ </phrase>
+ </textobject>
+ </mediaobject>
+ </figure>
+ <para>
+ The <guilabel>Application Details</guilabel> will provide you with all the
information available concenring the application. To close this window and return to the
previous window, click <guibutton>OK</guibutton>.
+ </para>
+ <figure id="application_creation_06b">
+ <title>Application availability</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/Creating_an_OpenShift_Express_Application/application_creation_06.png"
format="PNG" />
+ </imageobject>
+ <textobject>
+ <phrase>
+ Having returned to the previous screen, we can see that the application is still
available.
+ </phrase>
+ </textobject>
+ </mediaobject>
+ </figure>
+ <para>
+ Click the <guibutton>Next</guibutton> to proceed to the next screen.
+ </para>
+ <figure id="application_creation_08">
+ <title>Importing the project</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/Creating_an_OpenShift_Express_Application/application_creation_08.png"
format="PNG" />
+ </imageobject>
+ <textobject>
+ <phrase>
+ Cloning the project from the Git repository and creating the JBoss Server adapter.
+ </phrase>
+ </textobject>
+ </mediaobject>
+ </figure>
+ <para>
+ The final screen of the <guilabel>OpenShift application wizard</guilabel>
specifies <guilabel>Git clone</guilabel> settings and <guilabel>JBoss
Server adapter</guilabel> options.
+ </para>
+ <para>
+ In the <guilabel>Git clone</guilabel> section of the window sets the
properties for creating a local copy of your application for you to work with. The
location of your application in the Git repository of your domain is present in the
<guilabel>Cloning From</guilabel> field. The
<guilabel>Destination</guilabel> and <guilabel>Remote
name</guilabel> options will be set to default automatically, however you are able
to change these by deselecting the <property>default</property> option and
specifying custom settings in the fields provided.
+ </para>
+ <para>
+ The <guilabel>JBoss Server adapter</guilabel> section of the window will
have the option to <property>Create a JBoss server adapter</property> selected
automatically. Creating a JBoss server adapter will allow you to publish changes you make
to your application, back to your OpenShift Express domain.
+ </para>
+ <para>
+ Click the <guibutton>Finish</guibutton> to begin the cloning of the Git
repository.
+ </para>
+ <!--Figure-->
+</chapter>
+
Added:
trunk/openshift/docs/reference/en-US/images/Creating_an_OpenShift_Express_Application/application_creation_01.png
===================================================================
(Binary files differ)
Property changes on:
trunk/openshift/docs/reference/en-US/images/Creating_an_OpenShift_Express_Application/application_creation_01.png
___________________________________________________________________
Added: svn:mime-type
+ application/octet-stream
Added:
trunk/openshift/docs/reference/en-US/images/Creating_an_OpenShift_Express_Application/application_creation_02.png
===================================================================
(Binary files differ)
Property changes on:
trunk/openshift/docs/reference/en-US/images/Creating_an_OpenShift_Express_Application/application_creation_02.png
___________________________________________________________________
Added: svn:mime-type
+ application/octet-stream
Added:
trunk/openshift/docs/reference/en-US/images/Creating_an_OpenShift_Express_Application/application_creation_03.png
===================================================================
(Binary files differ)
Property changes on:
trunk/openshift/docs/reference/en-US/images/Creating_an_OpenShift_Express_Application/application_creation_03.png
___________________________________________________________________
Added: svn:mime-type
+ application/octet-stream
Added:
trunk/openshift/docs/reference/en-US/images/Creating_an_OpenShift_Express_Application/application_creation_04.png
===================================================================
(Binary files differ)
Property changes on:
trunk/openshift/docs/reference/en-US/images/Creating_an_OpenShift_Express_Application/application_creation_04.png
___________________________________________________________________
Added: svn:mime-type
+ application/octet-stream
Added:
trunk/openshift/docs/reference/en-US/images/Creating_an_OpenShift_Express_Application/application_creation_05.png
===================================================================
(Binary files differ)
Property changes on:
trunk/openshift/docs/reference/en-US/images/Creating_an_OpenShift_Express_Application/application_creation_05.png
___________________________________________________________________
Added: svn:mime-type
+ application/octet-stream
Added:
trunk/openshift/docs/reference/en-US/images/Creating_an_OpenShift_Express_Application/application_creation_06.png
===================================================================
(Binary files differ)
Property changes on:
trunk/openshift/docs/reference/en-US/images/Creating_an_OpenShift_Express_Application/application_creation_06.png
___________________________________________________________________
Added: svn:mime-type
+ application/octet-stream
Added:
trunk/openshift/docs/reference/en-US/images/Creating_an_OpenShift_Express_Application/application_creation_07.png
===================================================================
(Binary files differ)
Property changes on:
trunk/openshift/docs/reference/en-US/images/Creating_an_OpenShift_Express_Application/application_creation_07.png
___________________________________________________________________
Added: svn:mime-type
+ application/octet-stream
Added:
trunk/openshift/docs/reference/en-US/images/Creating_an_OpenShift_Express_Application/application_creation_08.png
===================================================================
(Binary files differ)
Property changes on:
trunk/openshift/docs/reference/en-US/images/Creating_an_OpenShift_Express_Application/application_creation_08.png
___________________________________________________________________
Added: svn:mime-type
+ application/octet-stream