This article builds on my previous tutorial, Enable Eclipse MicroProfile applications on Red Hat JBoss Enterprise Application Platform 7.3. To follow the examples, you must have Eclipse MicroProfile enabled in your Red Hat JBoss Enterprise Application Platform Expansion Pack (JBoss EAP XP) 1.0.0.GA installation, via Red Hat CodeReady Studio. See the previous article for installation instructions.
In this article, we will use the installed MicroProfile-enabled image to set up a JBoss EAP XP quickstart project in Red Hat CodeReady Workspaces (CRW). You can also apply what you learn from this article to develop your own applications using CodeReady Workspaces.
Note: For more examples, be sure to see the video demonstration at the end of the article.
Step 1: Create a new devfile
To start, open CodeReady WorkSpaces and create a new devfile. In the next sections, I'll describe the steps to configure and build this devfile so that you can build and run the quickstarts in CodeReady Workspaces. You can download the sample devfile here.
Step 2: Define the editor plugins
Because this is a Java project, we're using the Java Che plugin:
components: - type: chePlugin id: redhat/java11/latest -
Step 3: Define the Jaeger Docker image
This example uses Jaeger for MicroProfile OpenTracing, so we include a Docker image to start a Jaeger server instance and expose its UI endpoint on port 16686:
components: - alias: jaeger type: dockerimage image: jaegertracing/all-in-one memoryLimit: 128Mi endpoints: - name: 'tracing-ui' port: 16686 -
Note: You can find the full eapxp-quickstarts.yaml file here.
Step 4: Define the JBoss EAP XP component
The last component is the source-to-image (S2I) Docker image for JBoss EAP XP. This image provides instances of both Apache Maven to build the applications and the JBoss EAP XP runtime to run them.
We need to expose the HTTP endpoint to be able to access the running application on port 8080. Later, we'll also need to be able to expose the management endpoint on port 9990, because JBoss EAP XP exposes the MicroProfile Health and MicroProfile Metrics APIs on this endpoint.
We also define the environment variables for this container. These will configure its various elements, as shown:
- type: dockerimage alias: maven image: 'registry.redhat.io/jboss-eap-7/eap-xp1-openjdk11-openshift-rhel8@sha256:bebc469f8b21d8132f7b0df62b90107e68e7a77c36d39270f349216557102787' env: # Enabling Jaeger tracing - name: WILDFLY_TRACING_ENABLED value: 'true' # Define the Jaeger service name - name: JAEGER_SERVICE_NAME value: 'microprofile-opentracing' # Configure Jaeger traces - name: JAEGER_REPORTER_LOG_SPANS value: 'true' - name: JAEGER_SAMPLER_TYPE value: 'const' - name: JAEGER_SAMPLER_PARAM value: '1' - name: MAVEN_OPTS value: >- -Xmx200m -XX:MaxRAMPercentage=50.0 -XX:+UseParallelGC -XX:MinHeapFreeRatio=10 -XX:MaxHeapFreeRatio=20 -XX:GCTimeRatio=4 -XX:AdaptiveSizePolicyWeight=90 -Dsun.zip.disableMemoryMapping=true -Xms20m -Djava.security.egd=file:/dev/./urandom -Duser.home=/home/jboss memoryLimit: 1024Mi endpoints: - name: eap-http port: 8080 - name: eap-management port: 9990 mountSources: true volumes: - name: m2 containerPath: /home/jboss/.m2
First, we set the environment variable WILDFLY_TRACING_ENABLED to true to enable MicroProfile OpenTracing in JBoss EAP XP.
Second, we configure how Microprofile OpenTracing traces are collected and sent to the Jaeger instance using JAEGER_SERVICE_NAME, JAEGER_REPORTER_LOG_SPANS, JAEGER_SAMPLER_TYPE, and JAEGER_SAMPLER_PARAM.
Last, we need to configure Apache Maven using MAVEN_OPTS.
As shown in Figure 1, we provide several commands. The most notable is a build command to build from the Apache Maven pom.xml. (We'll use the copy war command to deploy the application after it's been built.)
Step 5: Build the project
Finally, we select the pom.xml for the microprofile-opentracing quickstart and build the file. Once it is built, you can copy the resulting WAR file. Use the eap-http endpoint command to produce endpoint traces, then use the tracing-ui command to see them in the Jaeger instance, as shown in Figure 2.
Next steps
You can follow these instructions and the video demonstration at the end of the article to build and install the microprofile-health and microprofile-metrics quickstart projects in your workspace. You would use the eap-management endpoint to access MicroProfile Health content, as shown in Figure 3.
Video demo: See more MicroProfile quickstarts in action
This video demonstrates how to set up CodeReady Workspaces to build and run MicroProfile quickstarts on JBoss EAP XP 1.0. Start the video now to see Eclipse MicroProfile OpenTracing, Eclipse MicroProfile Health, and Eclipse MicroProfile Metrics in action.
Conclusion
In my previous article, I showed you how to install JBoss EAP XP 1.0 and enable Eclipse MicroProfile support on that platform. In this article, I showed you how to configure and run a MicroProfile quickstart project using CodeReady Workspaces. For more details, be sure to check out the video demonstration that is included in both articles.