Chapter 8. Build and run microservices applications on the OpenShift image for JBoss EAP XP

Procedure

1. Log in to your OpenShift instance using the oc login command.

2. Create a new project in OpenShift.

   A project allows a group of users to organize and manage content separately from other groups. You can create a project in OpenShift using the following command.

   Copy to Clipboard Toggle word wrap

   $ oc new-project PROJECT_NAME

   For example, for the microprofile-config quickstart, create a new project named eap-demo using the following command.

   Copy to Clipboard Toggle word wrap

   $ oc new-project eap-demo

Procedure

1. Create a file named helm.yaml using the following YAML content:

   Copy to Clipboard Toggle word wrap

   build:
     uri: https://github.com/jboss-developer/jboss-eap-quickstarts.git
     ref: XP_5.0.0.GA
     contextDir: microprofile-config
     mode: s2i
   deploy:
     replicas: 1

2. Use the following command to deploy your JBoss EAP XP application on Openshift.

   Copy to Clipboard Toggle word wrap

   $ helm install microprofile-config -f helm.yaml jboss-eap/eap-xp5

Procedure

1. Get the service name of your application using the following command.

   Copy to Clipboard Toggle word wrap

   $ oc get service

2. Optional: Expose the main service as a route so you can access your application from outside of OpenShift. For example, for the microprofile-config quickstart, use the following command to expose the required service and port.

   Copy to Clipboard Toggle word wrap

   $ oc expose service/microprofile-config --port=8080

3. Get the URL of the route.

   Copy to Clipboard Toggle word wrap

   $ oc get route

4. Access the application in your web browser using the URL. The URL is the value of the HOST/PORT field from previous command’s output.

   Note

   For JBoss EAP XP 5.0.0 GA distribution, the Microprofile Config quickstart does not reply to HTTPS GET requests to the application’s root context. This enhancement is only available in the {JBossXPShortName101} GA distribution.

   For example, to interact with the Microprofile Config application, the URL might be http://HOST_PORT_Value/config/value in your browser.

   If your application does not use the JBoss EAP root context, append the context of the application to the URL. For example, for the microprofile-config quickstart, the URL might be http://HOST_PORT_VALUE/microprofile-config/.

5. Optionally, you can scale up the application instance by running the following command. This command increases the number of replicas to 3.

   Copy to Clipboard Toggle word wrap

   $ oc scale deploymentconfig DEPLOYMENTCONFIG_NAME --replicas=3

   For example, for the microprofile-config quickstart, use the following command to scale up the application.

   Copy to Clipboard Toggle word wrap

   $ oc scale deployment/microprofile-config --replicas=3