You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@activemq.apache.org by cl...@apache.org on 2019/02/05 18:57:50 UTC
[activemq-artemis] 03/05: ARTEMIS-2245 adding Docker images User
guide
This is an automated email from the ASF dual-hosted git repository.
clebertsuconic pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/activemq-artemis.git
commit 8c89c3584fbd12f6a26de9fdaabab3061c2a6f59
Author: Francesco Nigro <ni...@gmail.com>
AuthorDate: Mon Feb 4 18:54:57 2019 +0100
ARTEMIS-2245 adding Docker images User guide
---
docs/user-manual/en/SUMMARY.md | 1 +
docs/user-manual/en/docker.md | 26 ++++++++++++++++++++++++++
2 files changed, 27 insertions(+)
diff --git a/docs/user-manual/en/SUMMARY.md b/docs/user-manual/en/SUMMARY.md
index 0aa3085..3243b54 100644
--- a/docs/user-manual/en/SUMMARY.md
+++ b/docs/user-manual/en/SUMMARY.md
@@ -72,4 +72,5 @@
* [Maven Plugin](maven-plugin.md)
* [Unit Testing](unit-testing.md)
* [Troubleshooting and Performance Tuning](perf-tuning.md)
+* [Docker support](docker.md)
* [Configuration Reference](configuration-index.md)
diff --git a/docs/user-manual/en/docker.md b/docs/user-manual/en/docker.md
new file mode 100644
index 0000000..5dfcf55
--- /dev/null
+++ b/docs/user-manual/en/docker.md
@@ -0,0 +1,26 @@
+# Artemis on Docker
+
+Artemis provide support to build CentOS and Ubuntu images of the broker, allowing to reuse
+an existing broker instance *ie from a previous image run* or just creating a fresh new one.
+
+## Building a CentOS image
+From within the folder with both `Dockerfile-centos` file and `assets` folder:
+```
+$ docker build -f Dockerfile-centos -t artemis-centos .
+```
+> **Note:**
+>`-t artemis-centos` is just a tag name for the purpose of this guide
+## 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
+```
+While a stateful run with:
+```
+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.
+
+