Red Hat SummitChapter 10. Enable MicroProfile application development for JBoss EAP using JBoss Tools
If you want to incorporate MicroProfile capabilities in applications that you develop using JBoss Tools, you must enable MicroProfile support for JBoss EAP in JBoss Tools.
JBoss EAP expansion packs provide support for 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.
10.1. Configuring JBoss Tools to use MicroProfile capabilities
To enable MicroProfile support on JBoss EAP, register a new runtime server for JBoss EAP XP, and then create the new JBoss EAP 8.0 server.
Give the server an appropriate name that helps you recognize that it supports 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.
If you set the Target runtime to 8.0 or a later runtime version in JBoss Tools, your project is compatible with the Jakarta EE 8 specification.
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 8.0.
- In the Server’s host name field, enter localhost.
- In the Server name field, enter JBoss EAP 8.0 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.4.
- 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 MicroProfile capabilities, or to begin using the MicroProfile quickstarts for JBoss EAP.
10.2. Using MicroProfile quickstarts for JBoss Tools
Enabling the MicroProfile quickstarts makes the simple examples available to run and test on your installed server.
These examples illustrate the following MicroProfile capabilities.
- MicroProfile Config
- MicroProfile Fault Tolerance
- MicroProfile Health
- MicroProfile JWT
- MicroProfile OpenAPI
- MicroProfile REST Client
Procedure
-
Import the
pom.xmlfile from the Quickstart Parent Artifact. If you are using a quickstart that requires environment variables, configure those variables on the launch configuration on the server Overview dialog box.
For example, the
opentelemetry-tracingquickstart uses the following environment variable:-
OTEL_COLLECTOR_HOST
-
Additional resources
About JBoss Enterprise Application Platform expansion pack
Red Hat JBoss Enterprise Application Platform expansion pack Support and Life Cycle Policies
