activemq-artemis/artemis-docker/readme.md

# Docker Image Example

This is an example on how you could create your own Docker Image For Apache ActiveMQ Artemis based on CentOS or Ubuntu.
# Preparing

Use the script ./prepare-docker.sh as it will copy the docker files under the binary distribution.

```
$ ./prepare-docker.sh $ARTEMIS_HOME
```

# Building

Go to `$ARTEMIS_HOME` where you prepared the binary with Docker files.

## For Ubuntu:

From within the `$ARTEMIS_HOME` folder:
```
$ docker build -f ./docker/Dockerfile-ubuntu -t artemis-ubuntu .
```

## For CentOS

From within the `$ARTEMIS_HOME` folder:
```
$ docker build -f ./docker/Dockerfile-centos -t artemis-centos .
```

**Note:**
`-t artemis-ubuntu`,`-t artemis-centos` are just tag names for the purpose of this guide

# Variables:

 - ARTEMIS_USER 
 - ARTEMIS_PASSWORD
 - ANONYMOUS_LOGIN

Default here is FALSE. If you set this to true, it will change security settings passed on the broker instance creation.

- CREATE_ARGUMENTS

Default here is `--user ${ARTEMIS_USER} --password ${ARTEMIS_PASSWORD} --silent --http-host 0.0.0.0 --relax-jolokia"`


This will be passed straight to `./artemis create` during the execution.


# Mapping point

- `/var/lib/artemis-instance`

It's possible to map a folder as the instance broker.
This will hold the configuration and the data of the running broker. This is useful for when you want the data persisted outside of a container.


# Lifecycle of the execution

A broker instance will be created during the execution of the instance. If you pass a mapped folder for `/var/lib/artemis-instance` an image will be created or reused depending on the contents of the folder.



## Running a CentOS image

The image just created in the previous step allows both stateless or stateful runs.
The stateless run is achieved by:
```
$ docker run --rm -it -p 61616:61616 -p 8161:8161 artemis-centos 
```
The image will also support mapped folders and mapped ports. To run the image with the instance persisted on the host:
```
docker run -it -p 61616:61616 -p 8161:8161 -v <broker folder on host>:/var/lib/artemis-instance artemis-centos 
```
where `<broker folder on host>` is a folder where the broker instance is supposed to 
be saved and reused on each run.