Red Hat Training

A Red Hat training course is available for Red Hat Fuse

Chapter 1. Add Apicurito as a service to your OpenShift project

You can add Apicurito as a service to your OpenShift project from the OpenShift service catalog. You can access this instance at a URL external to the OpenShift environment.

Prerequisites

  • Obtain the hostname that will allow you to access Apicurito by following the guidelines recommended by your OpenShift system administrator.
  • Verify that the Fuse on OpenShift images and templates, including apicurito-ui and fuse-apicurito-generator, are installed on your OpenShift cluster, by running the following command in a command window:

    oc get is -n openshift

    If the images and templates are not pre-installed, or if the provided versions are out of date, install (or update) the Fuse on OpenShift images and templates as described in the Fuse on OpenShift Guide.

Procedure

To add Apicurito as a service to your OpenShift project:

  1. In a command window, log in to the OpenShift server:

    oc login -u developer -p developer
  2. Create a new project namespace. For example, the following command creates a new project named test:

    oc new-project test
  3. In your web browser, open the OpenShift console and log in with your credentials (for example, username developer and password developer).
  4. Click Catalog. In the Catalog search field, type Apicurito and then select Red Hat Fuse Apicurito.

    apicurito instance create 01

    The Information step of the Red Hat Fuse Apicurito wizard opens.

  5. Click Next.

    The Configuration step of the Red Hat Fuse Apicurito wizard opens.

  6. In the Image Stream Namespace field, type openshift.

    apicurito instance create 02
  7. In the ROUTE_HOSTNAME field, type the external hostname that allows you to access the Apicurito instance, for example apicurito-myproject.192.168.64.43.nip.io.
  8. Accept the default values for the rest of the settings in the Configuration step and click Create.

    The Results step of the template wizard opens.

    apicurito instance create 03
  9. Click Close.
  10. In the OpenShift web console, in the My Projects pane, select the project, for example select test.

    The project’s Overview tab opens, showing the apicurito-ui application.

  11. Click the arrow to the left of the apicurito-ui deployment to expand and view the deployment details:

    apicurito instance create 04
  12. Click the link for the Aplicurito instance, for example https://apicurito-myproject.192.168.64.43.nip.io.

    Apicurito opens in a new web browser window or tab:

    apicurito instance create 05
Note

If you cannot open the Apicurito instance, you might need to edit your computer’s /etc/hosts file to add the ROUTE_HOSTNAME using the following syntax, where $OPENSHIFT_IP_ADDR is the IP address for the OpenShift server and apicurito.my-minishift.apicurio.io is the ROUTE_HOSTNAME that you specified in step 7.

$OPENSHIFT_IP_ADDR apicurito.my-minishift.apicurio.io