This repository holds the training for the microprofile specifications. After working through the training one should be able to understand the most common microprofile specifications, their impacts, their interoperability and how to use them properly in real time applications.
This training is based on the Jakarta-EE 8.0 (Eclipse MicroProfile 4.1) specification and the Wildfly 26.1.3.Final application server.
To get the application running you need the following software installed:
The application can be accessed via http://localhost:8080/mptraining/api/welcome.
Follow the instructions to work through the exercises.
|
Important
|
When running in an IDE the actual port will depend on your configuration. |
Before you progress further into the setup of the training run mvn clean install in the projects root directory.
This will build the project and also gather some dependencies needed further in the setup.
Refer to the documentation of the IDE of your choice, which must provide integration for Wildfly/JBoss servers, for how to set up the project.
Configure you wildfly to use microprofile configuration by adding -c standalone-microprofile.xml to your startup script in your run configuration.
|
Important
|
When running in an IDE you may have to add this to both the run and debug configurations if you use both of them. |
After the first startup you need to run the scripts.cli on your wildfly with jboss-cli for further configuration.
The scripts.cli references some files (e.g. postgres driver) in the projects build folder (target).
Therefore you have to run the cli script from the projects root directory:
<your-JBOSS_HOME-directory>/bin/jboss-cli.sh --file=infrastructure/wildfly/scripts.cli --connect
Restart your server after the script finished.
|
Important
|
You need to run the server with the standalone-microprofile.xml otherwise microprofile extensions are not available.
|
Change to the infrastructure directory and run docker-compose up -d.
To access the infrastructure tools use one of the following links:
The credentials for all applications can be found in our infrastructure guide.
See our WIKI for contribution guidelines and deeper documentation about this project.