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.

   $ oc new-project PROJECT_NAME

   Copy to Clipboard Toggle word wrap

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

   $ oc new-project eap-demo

   Copy to Clipboard Toggle word wrap

Procedure

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

   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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

Procedure

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

   $ oc get service

   Copy to Clipboard Toggle word wrap

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.

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

   Copy to Clipboard Toggle word wrap

3. Get the URL of the route.

   $ oc get route

   Copy to Clipboard Toggle word wrap

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.

   $ oc scale deploymentconfig DEPLOYMENTCONFIG_NAME --replicas=3

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap