Chapter 3. Implement, build, and deploy a Fuse application based on a REST API

Procedure

1. In your OpenShift web console, open the project that contains Apicurito.

2. Open the Apicurito console. In the list of applications for the project, click the URL under apicurito. For example: https://apicurito-myproject.192.168.64.38.nip.io

   

   The Apicurito console opens in a separate web browser tab or window:

   

3. Click Open API.

   A file manager window opens.

4. In the file manager window:

   1. Navigate to the folder that contains the existing OpenAPI definition file, for example, openapi.json.

   2. Select the OpenAPI definition file and then click Open.

      The OpenAPI definition opens in the Apicurito console. For example:

      

1. Click Generate.
2. Select Fuse Camel Project from the drop-down list.

Procedure

1. Unzip the Apicurito-generated camel-project.zip file to a temporary folder.
2. Open Red Hat Developer Studio.
3. In Developer Studio, select File Import.
4. In the Import dialog, select Maven Existing Maven Projects.
5. Open the project’s camel-context.xml file in the editor view.

6. Click the REST tab to edit the Rest DSL components.

   For information on defining REST services, see the "Defining REST services" section of the Apache Camel Development Guide.

   For information on extending JAX-RS endpoints with Swagger support, see the Apache CXF Development Guide.

   For information on using the Fuse Tooling REST editor, see the "Viewing and editing Rest DSL components" section of the Tooling User Guide.

7. In the Design tab, edit the Camel routes.

   For information on editing Camel routes, see the "Editing a routing context in the route editor" section of the Tooling User Guide.

1. Log in to your OpenShift cluster:

   $ oc login -u developer -p developer

2. Create a new OpenShift project for the project. For example, the following command creates a new project named test-deploy.

   $ oc new-project test-deploy

3. Change the directory to the folder that contains your Fuse Camel project (for example, myworkspace/camel-project) :

   $ cd myworkspace/camel-project

4. Build and deploy the project to the OpenShift cluster:

   $ mvn clean fabric8:deploy -Popenshift

5. In your browser, open the OpenShift console and navigate to the project (for example, test-deploy). Wait until you can see that the pod for the camel-project application has started.
6. On the project’s Overview page, locate the URL for the camel-project application. The URL uses this form: http://camel-project-MY_PROJECT_NAME.OPENSHIFT_IP_ADDR.nip.io.
7. Click the URL to access the service.