Chapter 5. OpenShift basics in CodeReady Studio

CodeReady Studio includes OpenShift Application Explorer view, which provides a different and simplified user experience allowing easy and rapid feedback through the inner loop and debugging.

The following section describes how to:

  • Set up OpenShift Application Explorer.
  • Connect to the OpenShift cluster using OpenShift Application Explorer.
  • Create a new launcher project using OpenShift Application Explorer.
  • Create a new project using OpenShift Application Explorer.
  • Create a new component using OpenShift Application Explorer.
  • Deploy a component on cluster using OpenShift Application Explorer.
  • Define a URL to externally access the component.
  • Debug an application on the cluster using OpenShift Application Explorer.

5.1. Setting up OpenShift Application Explorer view

The following section describes how to open OpenShift Application Explorer in CodeReady Studio.

Procedure

  1. Start CodeReady Studio.
  2. Click WindowShow ViewOther.

    The Show View window appears.

  3. Enter OpenShift in the search field.
  4. Select OpenShift Application Explorer.
  5. Click the Open button.

    The OpenShift Application Explorer view appears.

5.2. Connecting to the OpenShift cluster using OpenShift Application Explorer

The following section describes how to login to the OpenShift cluster in CodeReady Studio using OpenShift Application Explorer.

Procedure

  1. Start CodeReady Studio.
  2. Open OpenShift Application Explorer.
  3. Click the Can’t connect to cluster. Click to login button.

    login to openshift cluster

    The Login window appears.

  4. Enter your login credentials.
  5. Click the Finish button.

    Your projects appear in the OpenShift Application Explorer view.

5.3. Creating a new launcher project

The following section describes how to create a new launcher project in CodeReady Studio.

Procedure

  1. Start CodeReady Studio.
  2. Press Ctrl+N.

    The New window appears.

  3. Enter Launcher in the search field.
  4. Select Launcher project.
  5. Click the Next button.

    The New Launcher project window appears.

  6. Set Mission to rest-http.
  7. Set Runtime to vert.x community.
  8. Name your project.
  9. Select the location for your project.
  10. Click the Finish button.

    Note that the process of resolving dependencies might take some time to complete.

Your newly created launcher project is now listed in the OpenShift Application Explorer view.

Verification steps

  1. Click WindowShow ViewOther.

    The Show View window appears.

  2. Enter Project Explorer in the search field.
  3. Select Project Explorer.
  4. Click the Open button.

    The Project Explorer view appears.

Your newly created launcher project is now listed in the Project Explorer view.

5.4. Creating a new project using OpenShift Application Explorer

The following section describes how to create a new project using OpenShift Application Explorer in CodeReady Studio.

Procedure

  1. Start CodeReady Studio.
  2. Start OpenShift Application Explorer.
  3. Right-click any place in OpenShift Application ExplorerNewProject.

    The New project window appears.

  4. Name your project.
  5. Click the OK button.

Your newly created project is now listed in the OpenShift Application Explorer view.

5.5. Creating a new component using OpenShift Application Explorer

The following section describes how to create a new component using OpenShift Application Explorer in CodeReady Studio.

Procedure

  1. Start CodeReady Studio.
  2. Start OpenShift Application Explorer.
  3. Right-click the target ProjectNewComponent.

    The New component window appears.

  4. Name your project.
  5. Click the Browse button to select the Eclipse Project.
  6. Set Component type to java.
  7. Set Component version to 8.
  8. Name your application.
  9. Clear the Push after create check box.
  10. Click the Finish button.

    The Console view appears, displaying the validation process.

Your newly created component is now listed in the OpenShift Application Explorer view under your project.

Additional resources

5.6. Deploying a component on cluster using OpenShift Application Explorer

The following section describes how to deploy a component on cluster using OpenShift Application Explorer in CodeReady Studio.

Procedure

  1. Start CodeReady Studio.
  2. Start OpenShift Application Explorer.
  3. Expand your project.
  4. Expand your application.
  5. Right-click the target componentPush.

    The Console view appears, displaying the process of file synchronization.

5.7. Defining an external access URL using OpenShift Application Explorer

The following section describes how to define an external access URL using OpenShift Application Explorer in CodeReady Studio.

Procedure

  1. Start CodeReady Studio.
  2. Start OpenShift Application Explorer.
  3. Expand your project.
  4. Expand your application.
  5. Right-click the target componentNewURL.
  6. Name your URL.
  7. Set Port value to 8080.
  8. Click the Finish button.

    The Console view appears, displaying the process of URL creation.

  9. Right-click the target componentPush.

Your newly created URL is now listed in the OpenShift Application Explorer view under your component.

5.8. Debugging an application on the cluster using OpenShift Application Explorer

The following section describes how to debug a component using OpenShift Application Explorer in CodeReady Studio.

Procedure

  1. Start CodeReady Studio.
  2. Start OpenShift Application Explorer.
  3. Expand your project.
  4. Expand your application.
  5. Right-click the target componentDebug.

    The Console view appears.

  6. Expand your component.
  7. Right-click the target urlOpen in Browser.

    The Confirm Perspective Switch window appears.

  8. Click the Switch button.

    The Debug Perspective window appears.