[
https://issues.apache.org/jira/browse/ARTEMIS-3042?focusedWorklogId=861226&page=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-861226
]
ASF GitHub Bot logged work on ARTEMIS-3042:
-------------------------------------------
Author: ASF GitHub Bot
Created on: 09/May/23 15:31
Start Date: 09/May/23 15:31
Worklog Time Spent: 10m
Work Description: gtully commented on code in PR #4297:
URL: https://github.com/apache/activemq-artemis/pull/4297#discussion_r1188786028
##########
artemis-image/README.md:
##########
@@ -0,0 +1,97 @@
+###What is in the image
+
+An _empty_, _open_ broker with a default acceptor on port 61616
+
+ - by empty: has no addresses or queues but will auto create on demand
+ - by open: has no security; authentication or authorization, users or roles
+
+###How will the image behave
+
+ 1) the image will use or create `/app/data` for persistence of data
+
+ 2) the image will use any [.properties
files](https://activemq.apache.org/components/artemis/documentation/latest/configuration-index.html#broker_properties)
from `/app/etc` to augment configuration
+
+ 3) the image will use `/app/etc/broker.xml` if present, to bootstrap
configuration, the 'bring your own config' use case
+
+###Build and Use
+
+First build an OCI image tar file from this artemis project using mvn:
+
+ `$> mvn install`
+
+An OCI image is created as a tar file.
+
+> *Note that any OCI compatible container runtime and registry can be used for
the next steps, eg: docker, podman... I have used podman.*
+
+To load the image tar into a registry, use:
+
+ `$> podman image load --input target/jib-image.tar`
+
+To run the image with host network access, localhost:61616 will be visible,
use:
+
+ `$> podman run --net=host localhost/target/activemq-artemis-image:<...>`
+
+Execute the artemis producer/consumer command line tools from a `local
distribution` to validate:
+Note: there is a `local distribution` in
../artemis-distribution/target/apache-artemis-<version>-bin/apache-artemis-<version>/
Review Comment:
agree, will remove the suggestion to use the local distro.
##########
artemis-image/README.md:
##########
@@ -0,0 +1,93 @@
+###What is in the image
+
+An _empty_, _open_ broker with a default acceptor on port 61616
+
+ - by empty: has no addresses or queues but will auto create on demand
+ - by open: has no security; authentication or authorization, users or roles
+
+###How will the image behave
+
+ 1) the image will use or create `/app/data` for persistence of data
+
+ 2) the image will use any [.properties
files](https://activemq.apache.org/components/artemis/documentation/latest/configuration-index.html#broker_properties)
from `/app/etc` to augment configuration
+
+ 3) the image will use `/app/etc/broker.xml` if present, to bootstrap
configuration, the 'bring your own config' use case
+
+###Build and Use
+
+First build an OCI image tar file from this artemis project using mvn:
+
+ `$> mvn install`
+
+An OCI image is created as a tar file, that tar can be loaded into a registry,
eg:
+
+ `$> podman image load --input target/jib-image.tar`
+
+To run the image with host network access, localhost:61616 will be visible,
use:
+
+ `$> podman run --net=host localhost/target/activemq-artemis-image:<...>`
+
+Execute the artemis producer/consumer command line tools from a `local
distribution` to validate:
+Note: there is a `local distribution` in
../artemis-distribution/target/apache-artemis-<version>-bin/apache-artemis-<version>/
+
+ `$> ./bin/artemis producer --url tcp://127.0.0.1:61616`
+
+ `$> ./bin/artemis consumer --url tcp://127.0.0.1:61616`
+
+###Intent
+
+The intent is that this image is useful as is. If one can trust users, having
no access control or limits can work fine.
+
+If not, then this image can be configured by mounting an `/app/etc` directory
with property files that augment default configuration.
+This image could also be the base for a derived jib image, by simply adding
more property files to the `src/main/resources` directory.
+
+###Examples
Review Comment:
will sort. thanks
Issue Time Tracking
-------------------
Worklog Id: (was: 861226)
Time Spent: 8h 20m (was: 8h 10m)
> Official Docker Multistage Build as well as an official Docker image.
> ---------------------------------------------------------------------
>
> Key: ARTEMIS-3042
> URL: https://issues.apache.org/jira/browse/ARTEMIS-3042
> Project: ActiveMQ Artemis
> Issue Type: Improvement
> Reporter: John Behm
> Priority: Minor
> Labels: docker,, dockerfile,, kubernetes
> Time Spent: 8h 20m
> Remaining Estimate: 0h
>
> It would be rather convenient to get people up and running with an easy to
> build or to setup Docker image that automatically builds the project from
> source, discards the build container and moves the necessary files over to
> the final container that can simply be started.
> The current docker image build is not really user firendly or convenient at
> all.
>
> https://github.com/apache/activemq-artemis/tree/master/artemis-docker
> The whole setup process of artemis in a containerized environment is very
> far from even good.
> The hurdle of using this software is gigantic, as the configuration is so
> complex, one will not be able to do this within one month without having gone
> through the whole documentation multiple times.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
