Apache Artemis Examples

Clone this repo:
  1. 02e960a ARTEMIS-6070 protect default branch by Justin Bertram · 3 weeks ago main
  2. da0d530 Update examples to version 2.54.0 by Justin Bertram · 3 weeks ago 2.54.0
  3. 6953f79 ARTEMIS-5985 Prepare security-oidc example with exhaustive readme.md about OAuth2/OIDC by Grzegorz Grzybek · 9 weeks ago
  4. b2552ea ARTEMIS-6055 refactor CLI default password handling by Justin Bertram · 4 weeks ago
  5. 9d5e168 ARTEMIS-6037 fix examples by Justin Bertram · 6 weeks ago

Apache Artemis Examples

This repository contains various examples demonstrating many of the features of Apache Artemis.

Getting Started

Prepare the broker distribution

To begin, run the following at the root of your examples checkout to prepare a broker distribution for use.

mvn clean package

This will establish a broker installation within the artemis-distribution module in the root, which the individual examples will then reference while creating a broker instance when they are run.

Running individual examples

After preparing the broker distribution as above, you can then run most individual examples by changing into their directory and running mvn verify or mvn install (See the readme.md file in each example directory for specific details).

For instance, a simple introductory example would be the “queue” example. To run it, do the following:

cd examples/features/standard/queue/
mvn clean verify

This will start a broker instance, using the previously prepared broker installation in artemis-distribution, and then run the example client application against it, which will print having produced and consumed a message.

Contributing

See CONTRIBUTING for details.