Chapter 7. Enable Eclipse MicroProfile application development for JBoss EAP on Red Hat CodeReady Studio
If you want to incorporate Eclipse MicroProfile capabilities in applications that you develop on CodeReady Studio, you must enable Eclipse MicroProfile support for JBoss EAP in CodeReady Studio.
JBoss EAP expansion packs provide support for Eclipse MicroProfile.
JBoss EAP expansion packs are not supported on JBoss EAP 7.2 and earlier.
Each version of the JBoss EAP expansion pack supports specific patches of JBoss EAP. For details, see the JBoss EAP expansion pack Support and Life Cycle Policies page.
The JBoss EAP XP Quickstarts for Openshift are provided as Technology Preview only. Technology Preview features are not supported with Red Hat production service level agreements (SLAs), might not be functionally complete, and Red Hat does not recommend to use them for production. These features provide early access to upcoming product features, enabling customers to test functionality and provide feedback during the development process.
See Technology Preview Features Support Scope on the Red Hat Customer Portal for information about the support scope for Technology Preview features.
7.1. Configuring CodeReady Studio to use Eclipse MicroProfile capabilities
To enable Eclipse MicroProfile support on JBoss EAP, register a new runtime server for JBoss EAP XP, and then create the new JBoss EAP 7.3 server.
Give the server an appropriate name that helps you recognize that it supports Eclipse MicroProfile capabilities.
This server uses a newly created JBoss EAP XP runtime that points to the runtime installed previously and uses the standalone-microprofile.xml configuration file.
Prerequisites
Procedure
Set up the new server on the
New Serverdialog box.- In the Select server type list, select Red Hat JBoss Enterprise Application Platform 7.3.
- In the Server’s host name field, enter localhost.
- In the Server name field, enter JBoss EAP 7.3 XP.
- Click Next.
Configure the new server.
- In the Home directory field, if you do not want to use the default setting, specify a new directory; for example: home/myname/dev/microprofile/runtimes/jboss-eap-7.3.
- Make sure the Execution Environment is set to JavaSE-1.8.
- Optional: Change the values in the Server base directory and Configuration file fields.
- Click Finish.
Result
You are now ready to begin developing applications using Eclipse MicroProfile capabilities, or to begin using the Eclipse MicroProfile quickstarts for JBoss EAP.
7.2. Using Eclipse MicroProfile quickstarts for CodeReady Studio
Enabling the Eclipse MicroProfile quickstarts makes the simple examples available to run and test on your installed server.
These examples illustrate the following Eclipse MicroProfile capabilities.
- Eclipse MicroProfile Config
- Eclipse MicroProfile Fault Tolerance
- Eclipse MicroProfile Health
- Eclipse MicroProfile JWT
- Eclipse MicroProfile Metrics
- Eclipse MicroProfile OpenAPI
- Eclipse MicroProfile OpenTracing
- Eclipse MicroProfile REST Client
Procedure
-
Import the
pom.xmlfile from the Quickstart Parent Artifact. If the quickstart you are using requires environment variables, configure the environment variables.
Define environment variables on the launch configuration on the server Overview dialog box.
For example, the
microprofile-opentracingquickstart uses the following environment variables:-
JAEGER_REPORTER_LOG_SPANSset totrue -
JAEGER_SAMPLER_PARAMset to1 -
JAEGER_SAMPLER_TYPEset toconst
-
Additional resources
About JBoss Enterprise Application Platform expansion pack
Red Hat JBoss Enterprise Application Platform expansion pack Support and Life Cycle Policies
