README.md

# ActiveMQ Artemis

Apache ActiveMQ is an open source, multi-protocol, Java-based messaging server.

## Download

1. Go to the [Apache webpage](https://ironbank.dso.mil/ironbank/repomap/opensource/apache) in Iron Bank and download the latest ActiveMQ Artemis tarball.

2. Navigate to the location of the download and run:
```
docker load -i <Apache ActiveMQ Artemis tarball>
``` 

## Install

1. Clone this repo and change into the 'deployment' directory.
```
git clone https://repo1.dsop.io/dsop/opensource/apache/active-mq-artemis.git
cd active-mq-artemis/deployment
```

2. Create a namespace for our ActiveMQ deployment:
```
kubectl create ns active-mq
```

3. Modify _kustomization.yaml_ to use your own custom username and password. **This file MUST be configured with proper values in order to deploy**:
```
- ARTEMIS_USER=<<<ADMIN USER GOES HERE>>>            # line 10
- ARTEMIS_PASSWORD=<<<ADMIN PASSWORD GOES HERE>>>    # line 11
```

4. Modify _activemq-deployment.yaml_ to use the ActiveMQ image we loaded from Iron Bank.
```
- image: <IRON_BANK_IMAGE>       # line 18 
```

5. Create a persistent volume claim, deployment, and service using the kustomize directory that you're in.
```
kubectl -n active-mq apply -k .
```

## Usage

1. Retrieve the external IP and port of the active-mq loadbalancer service or use port-forwarding to access the ActiveMQ console.
```
kubectl -n active-mq get svc
# OR
kubectl -n active-mq port-forward svc/active-mq 8161:8161
```

2. Navigate to the ActiveMQ console (`localhost:8161/console`) in your browser and login using the username and password you provided in step 3 of the install instructions.

3. (Optional) Further configure Apache ActiveMQ Artemis to use your desired settings: [Artemis Documentation](https://activemq.apache.org/components/artemis/documentation/latest/security.html).

## Notes

Exposed Ports: 
- 8161 (Web Server)
- 9404 (JMX Exporter)
- 61616 (Port for CORE,MQTT,AMQP,HORNETQ,STOMP,OPENWIRE)
- 5445 (Port for HORNETQ,STOMP)
- 5672 (Port for AMQP)
- 1883 (Port for MQTT)
- 61613 (Port for STOMP)

For testing purposes only, see [here](https://github.com/apache/activemq-artemis/tree/master/artemis-docker).