Chapter 10. Enable MicroProfile application development for JBoss EAP using JBoss Tools
Chapter 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. Important 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. Note 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 JBoss EAP 8.0 with JBoss EAP XP 5.0 has been installed . Procedure Set up the new server on the New Server dialog 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 . 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.xml file 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-tracing quickstart uses the following environment variable: OTEL_COLLECTOR_HOST Additional resources About Microprofile About JBoss Enterprise Application Platform expansion pack Red Hat JBoss Enterprise Application Platform expansion pack Support and Life Cycle Policies