You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@jspwiki.apache.org by Carl Marcum <cm...@apache.org> on 2020/12/28 13:08:39 UTC
Proposed Docker page rework
Hi All,
To avoid the spam filter for such a large change see below for the
proposed page contents.
The references to the previous image on Docker Hub will need replaced
when you have the new one ready.
I'd be happy to make the edit.
The major changes are the that the image has changed a lot since the
metskem/docker-jspwikiused on the current page so I described the new
one somewhat.
In addition to using the pre-built image I added how to build your own
and added a example of how you can customize it based on CentOS or
Amazon Linux and the Corretto JDK which I did for mine.
In the persisting data section I added how to seed the volume directory
with the default pages.
If you would like to use it or have any changes please let me know.
Best regards,
Carl
---- Begin
!!! JSPWiki for Docker
JSPWiki can be used with [Docker|https://docs.docker.com]. Docker images
can be built from source or you can use a pre-built official image.
[{TableOfContents }]
!! Default Image
The default JSPWiki Docker image uses the official Docker Community
supported [Apache Tomcat 9
image|https://github.com/docker-library/tomcat/blob/b9416beec5364c00694595d6f3c61b09e764113c/9.0/jdk11/openjdk-buster/Dockerfile]
which is based on the [OpenJDK
11|https://github.com/docker-library/openjdk/blob/20450f7a60b8db7aafd491a5ea55c6a3548138c6/11/jdk/buster/Dockerfile]
built on Debian Buster.
JSPWiki is built from source using [Apache
Maven|http://maven.apache.org/] during the image build process.
!! Prerequisites
To use the pre-built image or build one from source you only need a
[Docker Engine|https://docs.docker.com/engine/]. See the [installation
instructions|http://docs.docker.com/installation/] on the docker site
for details.
!! Using the Pre-Built Image
To download it locally from the [docker
hub|https://registry.hub.docker.com/u/metskem/docker-jspwiki/].
! Get the Image
{{{
$ docker pull metskem/docker-jspwiki
}}}
! Running the Container
{{{
$ docker run -d -p 8080:8080 --name jspwiki metskem/docker-jspwiki
}}}
This means :
* __-d__ - detached mode, run the container in the background
* __-p 8080:8080__ - bind the host port (8080) to the container port
(8080). JSPWiki always runs on port 8080 inside the container.
* __--name jspwiki__ - the new docker container will get the name
''jspwiki'' (instead of a generated container name)
* __metskem/docker-jspwiki__ - the name of the image to run
!! Building from Source
! Building the Image
From the source root directory that contains the Dockerfile. The
example uses a {{$version}} variable because the version is referred to
multiple times. It is optional and can be replaced by any version number
you would like to use. If you do not specify a version with the tag name
it will default to 'latest'.
Watch out for the space and period at the end which means the current
directory.
{{{
$ version='2.11.0'
$ docker build --tag="jspwiki:$version" .
}}}
! Running the Container
This is exactly like running the pre-built image except for the image
{{name:version}} at the end.
{{{
$ docker run -d -p 8080:8080 --name jspwiki jspwiki:$version
}}}
!! Check the Results
Just point your browser at [http://localhost:8080/], that should give
you a working wiki right away !
To see the list of running containers use {{docker ps}} or {{docker
container ls}} and {{docker ps -a}} or {{docker container ls -a}} will
show all containers running and stopped.
{{{
$ docker ps
CONTAINER ID IMAGE COMMAND CREATED
STATUS PORTS NAMES
5f0f5b0b5996 metskem/docker-jspwiki "/usr/local/tomcat/bi" 4
minutes ago Up 4 minutes 0.0.0.0:8080->8080/tcp jspwiki
}}}
You can also execute commands inside the jspwiki container with the
docker exec command and, for example, look at the last 5 lines in
/var/jspwiki/logs/jspwiki.log :
{{{
$ docker exec -ti jspwiki tail -5 /var/jspwiki/logs/jspwiki.log
2016-03-28 09:34:35,070 [localhost-startStop-1] INFO
org.apache.wiki.util.UtilJ2eeCompat - apache tomcat detected
2016-03-28 09:34:35,073 [localhost-startStop-1] INFO
org.apache.wiki.ajax.WikiAjaxDispatcherServlet -
WikiAjaxDispatcherServlet initialized.
2016-03-28 09:34:35,075 [localhost-startStop-1] INFO
org.apache.wiki.WikiServlet - WikiServlet initialized.
2016-03-28 09:34:38,054 [http-nio-8080-exec-1] INFO
org.apache.wiki.util.PropertyReader JSPWiki:/
JSPWiki:http://localhost:8080/ - No jspwiki.custom.config defined for
this context, looking for custom properties file with default name of:
/jspwiki-custom.properties
2016-03-28 09:34:38,057 [http-nio-8080-exec-1] INFO
org.apache.wiki.util.PropertyReader JSPWiki:/
JSPWiki:http://localhost:8080/ - No custom property file found, relying
on JSPWiki defaults.
}}}
!! Stopping and Starting the Container
To stop the container, simply issue the {{docker stop}} or {{docker
container stop}} command against the containerid (or container name if
you gave it a name during first run).
{{{
$ docker ps
CONTAINER ID IMAGE COMMAND CREATED
STATUS PORTS NAMES
5f0f5b0b5996 metskem/docker-jspwiki "/usr/local/tomcat/bi" 6
minutes ago Up 6 minutes 0.0.0.0:8080->8080/tcp jspwiki
$ docker stop jspwiki
jspwiki
$ docker ps
CONTAINER ID IMAGE COMMAND CREATED
STATUS PORTS NAMES
$ docker ps -a
CONTAINER ID IMAGE COMMAND CREATED
STATUS PORTS NAMES
5f0f5b0b5996 metskem/docker-jspwiki "/usr/local/tomcat/bi" 6
minutes ago Exited (143) 4 seconds ago jspwiki
}}}
You can restart it with the {{docker start}} or {{docker container
start}} command, you have to find the containerid with the {{docker ps
-a}} command first , (or simply use the container name if you gave the
container a name during first run):
{{{
$ docker start jspwiki
jspwiki
$ docker ps
CONTAINER ID IMAGE COMMAND CREATED
STATUS PORTS NAMES
5f0f5b0b5996 metskem/docker-jspwiki "/usr/local/tomcat/bi" 7
minutes ago Up 5 seconds 0.0.0.0:8080->8080/tcp jspwiki
}}}
As you will notice, after a stop/start you still have the data (pages)
that were created after the first container start. %%small (you can
check easily with the Recent Changes page) %%
!! Removing the Container
If you want to get rid of the container (and all of the data in it !)
you first should stop it, then you can remove it with the {{docker rm}}
or {{docker container rm}} command %%small (or use docker rm -f to
forcibly remove it right away)%%:
{{{
$ docker ps
CONTAINER ID IMAGE COMMAND CREATED
STATUS PORTS NAMES
5f0f5b0b5996 metskem/docker-jspwiki "/usr/local/tomcat/bi" 9
minutes ago Up About a minute 0.0.0.0:8080->8080/tcp jspwiki
$ docker stop jspwiki
jspwiki
$ docker ps -a
CONTAINER ID IMAGE COMMAND CREATED
STATUS PORTS NAMES
5f0f5b0b5996 metskem/docker-jspwiki "/usr/local/tomcat/bi" 9
minutes ago Exited (143) 6 seconds ago jspwiki
$ docker rm jspwiki
jspwiki
$ docker ps -a
CONTAINER ID IMAGE COMMAND CREATED
STATUS PORTS NAMES
}}}
Note that all your data is lost when you remove the container. (You can
keep data apart using Docker Volumes, see next paragraph)
!! Persisting Data
If you use docker to run JSPWiki only for quick test purposes, you
probably are not interested in keeping the data (created/changed pages,
registered users, logfiles).\\
But you can also run a JSPWiki docker container in production-like
environments where you want to keep your data even after you removed a
container. \\As an example you might sometimes want to run a newer
version of your JSPWiki Docker container.
! Seeding the Volume Directory
To begin with the default pages you can copy them from the source tree
into a host OS directory used to persist the data.
{{{
$ cp ./jspwiki-wikipages/en/src/main/resources/*
<path-to-your>/jspwiki-pages/
}}}
! Running with a Volume
To use the data outside of the container, you can use the {{--volume}}
switch when you startup the container :
{{{
$ docker run -d -p 8080:8080 --env="jspwiki_baseURL=http://localhost/"
--name jspwiki_8080
--volume="<path-to-your>/jspwiki-pages:/var/jspwiki/pages"
metskem/docker-jspwiki
240232ebb32e58dee7ad95471128210f71007bbeb11735ffd5394113959ace75
}}}
This way you will get your pages in a directory on the host OS in
<path-to-your>/jspwiki-pages.\\
!! Running Multiple Instances
You can run multiple instances of the image of course. You only have to
make sure they use different TCP ports.\\
So for example starting 5 containers (with also a limit on memory usage
added) :
{{{
$ for PORT in `seq 9080 9084`; do docker run -d -p ${PORT}:8080
--memory=128m --env="jspwiki_baseURL=http://localhost:${PORT}/" --name
jspwiki-${PORT} metskem/docker-jspwiki; done
68481eed8d609ac91711a78bd80505b398a8a37c9cc435e44eb0b2b7f881444b
b3b967dc4fe721d5efce65959bfd5b4fa6061e053b3fd7b6d814bfc68a0a5261
6a23a3ac3df9aaf1a7f2dda96b6a535d58d06a429f458edaa4101ec89a6416e1
b55b716ed49ff6ca6ba581794fe4ba5bde0439e10301f78acb62d5dec1118304
73d4cd8f29a072884a965ad3a86a5d090762fc046fe424c7b842b1c0b3a72122
$ docker ps
CONTAINER ID IMAGE COMMAND CREATED
STATUS PORTS NAMES
73d4cd8f29a0 metskem/docker-jspwiki "/bin/sh -c '/usr/lo 4
seconds ago Up 3 seconds 0.0.0.0:9084->8080/tcp jspwiki-9084
b55b716ed49f metskem/docker-jspwiki "/bin/sh -c '/usr/lo 4
seconds ago Up 3 seconds 0.0.0.0:9083->8080/tcp jspwiki-9083
6a23a3ac3df9 metskem/docker-jspwiki "/bin/sh -c '/usr/lo 4
seconds ago Up 3 seconds 0.0.0.0:9082->8080/tcp jspwiki-9082
b3b967dc4fe7 metskem/docker-jspwiki "/bin/sh -c '/usr/lo 5
seconds ago Up 4 seconds 0.0.0.0:9081->8080/tcp jspwiki-9081
68481eed8d60 metskem/docker-jspwiki "/bin/sh -c '/usr/lo 5
seconds ago Up 4 seconds 0.0.0.0:9080->8080/tcp jspwiki-9080
}}}
And you can easily get rid of them too :
{{{
$ docker stop `docker ps -aq`
73d4cd8f29a0
b55b716ed49f
6a23a3ac3df9
b3b967dc4fe7
68481eed8d60
240232ebb32e
c8c73ddd9876
$ docker rm `docker ps -aq`
73d4cd8f29a0
b55b716ed49f
6a23a3ac3df9
b3b967dc4fe7
68481eed8d60
240232ebb32e
c8c73ddd9876
$ docker ps -a
CONTAINER ID IMAGE COMMAND CREATED
STATUS PORTS NAMES
}}}
!! Customizing Your Image
You can customize your build by making source code changes (not covered
here) or change other things like the Tomcat base image version and
platform OS and JDK version.
__Example__: Change the platform OS from Debian to the CentOS based
variation Amazon Linux 2 that uses their Corretto JDK optimized to run
in AWS.
Edit the Dockerfile as follows:\\
Change the Maven image used for building JSPWiki to match the one for
the OS. (Probably not need but done for consistancy)
{{{
# FROM maven:3.6-jdk-8 as package
FROM maven:3.6-amazoncorretto-11 as package
}}}
Change the Tomcat base image
{{{
# FROM tomcat:9.0
FROM tomcat:9.0-jdk11-corretto
}}}
Replace some Debian specifc lines with RedHat counterparts to add the
unzip package.
{{{
# RUN set -x \
# && export DEBIAN_FRONTEND=noninteractive \
# && apt install --fix-missing --quiet --yes unzip
RUN yum -y install \
unzip
}}}
Add after the {{# install jspwiki}} section and before {{# make port
visible in metadata}}
{{{
# remove unzip and cleanup
RUN yum -y remove \
unzip \
&& yum clean all
}}}
That's all.. Enjoy!
---- End
Re: Proposed Docker page rework
Posted by Carl Marcum <cm...@apache.org>.
Hi Juan Pablo,
I'll watch out for news of an official docker image to finish the edits.
Happy New Year!
Carl
On 1/1/21 2:42 PM, Juan Pablo Santos Rodríguez wrote:
> Hi Carl,
>
> the suggested rework looked good to me, so I've just went and posted
> it at jspwiki-wiki.a.o; if needed, we can continue the rework later
> on.. I've only added the
> PageViewPlugin at the end, so that the page shows up at the SystemInfo
> one. The changes can be seen at
> https://jspwiki-wiki.apache.org/Diff.jsp?page=Docker&r1=22&r2=21
> <https://jspwiki-wiki.apache.org/Diff.jsp?page=Docker&r1=22&r2=21>
>
>
> best regards & happy new year!!
> juan pablo
>
> On Mon, Dec 28, 2020 at 2:08 PM Carl Marcum <cmarcum@apache.org
> <ma...@apache.org>> wrote:
>
> Hi All,
>
> To avoid the spam filter for such a large change see below for the
> proposed page contents.
> The references to the previous image on Docker Hub will need replaced
> when you have the new one ready.
> I'd be happy to make the edit.
>
> The major changes are the that the image has changed a lot since the
> metskem/docker-jspwikiused on the current page so I described the new
> one somewhat.
>
> In addition to using the pre-built image I added how to build your
> own
> and added a example of how you can customize it based on CentOS or
> Amazon Linux and the Corretto JDK which I did for mine.
>
> In the persisting data section I added how to seed the volume
> directory
> with the default pages.
>
> If you would like to use it or have any changes please let me know.
>
> Best regards,
> Carl
>
> ---- Begin
>
> !!! JSPWiki for Docker
>
> JSPWiki can be used with [Docker|https://docs.docker.com
> <https://docs.docker.com>]. Docker images
> can be built from source or you can use a pre-built official image.
>
> [{TableOfContents }]
>
>
> !! Default Image
>
> The default JSPWiki Docker image uses the official Docker Community
> supported [Apache Tomcat 9
> image|https://github.com/docker-library/tomcat/blob/b9416beec5364c00694595d6f3c61b09e764113c/9.0/jdk11/openjdk-buster/Dockerfile
> <https://github.com/docker-library/tomcat/blob/b9416beec5364c00694595d6f3c61b09e764113c/9.0/jdk11/openjdk-buster/Dockerfile>]
>
> which is based on the [OpenJDK
> 11|https://github.com/docker-library/openjdk/blob/20450f7a60b8db7aafd491a5ea55c6a3548138c6/11/jdk/buster/Dockerfile
> <https://github.com/docker-library/openjdk/blob/20450f7a60b8db7aafd491a5ea55c6a3548138c6/11/jdk/buster/Dockerfile>]
>
> built on Debian Buster.
>
> JSPWiki is built from source using [Apache
> Maven|http://maven.apache.org/ <http://maven.apache.org/>] during
> the image build process.
>
> !! Prerequisites
>
> To use the pre-built image or build one from source you only need a
> [Docker Engine|https://docs.docker.com/engine/
> <https://docs.docker.com/engine/>]. See the [installation
> instructions|http://docs.docker.com/installation/
> <http://docs.docker.com/installation/>] on the docker site
> for details.
>
> !! Using the Pre-Built Image
> To download it locally from the [docker
> hub|https://registry.hub.docker.com/u/metskem/docker-jspwiki/
> <https://registry.hub.docker.com/u/metskem/docker-jspwiki/>].
> ! Get the Image
> {{{
> $ docker pull metskem/docker-jspwiki
> }}}
> ! Running the Container
> {{{
> $ docker run -d -p 8080:8080 --name jspwiki metskem/docker-jspwiki
> }}}
>
> This means :
> * __-d__ - detached mode, run the container in the background
> * __-p 8080:8080__ - bind the host port (8080) to the container port
> (8080). JSPWiki always runs on port 8080 inside the container.
> * __--name jspwiki__ - the new docker container will get the name
> ''jspwiki'' (instead of a generated container name)
> * __metskem/docker-jspwiki__ - the name of the image to run
>
> !! Building from Source
> ! Building the Image
> From the source root directory that contains the Dockerfile. The
> example uses a {{$version}} variable because the version is
> referred to
> multiple times. It is optional and can be replaced by any version
> number
> you would like to use. If you do not specify a version with the
> tag name
> it will default to 'latest'.
>
> Watch out for the space and period at the end which means the current
> directory.
> {{{
> $ version='2.11.0'
> $ docker build --tag="jspwiki:$version" .
> }}}
>
> ! Running the Container
> This is exactly like running the pre-built image except for the image
> {{name:version}} at the end.
> {{{
> $ docker run -d -p 8080:8080 --name jspwiki jspwiki:$version
> }}}
>
> !! Check the Results
>
> Just point your browser at [http://localhost:8080/
> <http://localhost:8080/>], that should give
> you a working wiki right away !
>
> To see the list of running containers use {{docker ps}} or {{docker
> container ls}} and {{docker ps -a}} or {{docker container ls -a}}
> will
> show all containers running and stopped.
> {{{
> $ docker ps
> CONTAINER ID IMAGE COMMAND CREATED
> STATUS PORTS NAMES
> 5f0f5b0b5996 metskem/docker-jspwiki "/usr/local/tomcat/bi" 4
> minutes ago Up 4 minutes 0.0.0.0:8080->8080/tcp jspwiki
> }}}
>
> You can also execute commands inside the jspwiki container with the
> docker exec command and, for example, look at the last 5 lines in
> /var/jspwiki/logs/jspwiki.log :
> {{{
> $ docker exec -ti jspwiki tail -5 /var/jspwiki/logs/jspwiki.log
> 2016-03-28 09:34:35,070 [localhost-startStop-1] INFO
> org.apache.wiki.util.UtilJ2eeCompat - apache tomcat detected
> 2016-03-28 09:34:35,073 [localhost-startStop-1] INFO
> org.apache.wiki.ajax.WikiAjaxDispatcherServlet -
> WikiAjaxDispatcherServlet initialized.
> 2016-03-28 09:34:35,075 [localhost-startStop-1] INFO
> org.apache.wiki.WikiServlet - WikiServlet initialized.
> 2016-03-28 09:34:38,054 [http-nio-8080-exec-1] INFO
> org.apache.wiki.util.PropertyReader JSPWiki:/
> JSPWiki:http://localhost:8080/ <http://localhost:8080/> - No
> jspwiki.custom.config defined for
> this context, looking for custom properties file with default name
> of:
> /jspwiki-custom.properties
> 2016-03-28 09:34:38,057 [http-nio-8080-exec-1] INFO
> org.apache.wiki.util.PropertyReader JSPWiki:/
> JSPWiki:http://localhost:8080/ <http://localhost:8080/> - No
> custom property file found, relying
> on JSPWiki defaults.
> }}}
>
> !! Stopping and Starting the Container
>
> To stop the container, simply issue the {{docker stop}} or {{docker
> container stop}} command against the containerid (or container
> name if
> you gave it a name during first run).
>
> {{{
> $ docker ps
> CONTAINER ID IMAGE COMMAND CREATED
> STATUS PORTS NAMES
> 5f0f5b0b5996 metskem/docker-jspwiki "/usr/local/tomcat/bi" 6
> minutes ago Up 6 minutes 0.0.0.0:8080->8080/tcp jspwiki
> $ docker stop jspwiki
> jspwiki
> $ docker ps
> CONTAINER ID IMAGE COMMAND CREATED
> STATUS PORTS NAMES
> $ docker ps -a
> CONTAINER ID IMAGE COMMAND CREATED
> STATUS PORTS NAMES
> 5f0f5b0b5996 metskem/docker-jspwiki "/usr/local/tomcat/bi" 6
> minutes ago Exited (143) 4 seconds ago
> jspwiki
> }}}
>
> You can restart it with the {{docker start}} or {{docker container
> start}} command, you have to find the containerid with the
> {{docker ps
> -a}} command first , (or simply use the container name if you gave
> the
> container a name during first run):
> {{{
> $ docker start jspwiki
> jspwiki
> $ docker ps
> CONTAINER ID IMAGE COMMAND CREATED
> STATUS PORTS NAMES
> 5f0f5b0b5996 metskem/docker-jspwiki "/usr/local/tomcat/bi" 7
> minutes ago Up 5 seconds 0.0.0.0:8080->8080/tcp jspwiki
> }}}
>
> As you will notice, after a stop/start you still have the data
> (pages)
> that were created after the first container start. %%small (you can
> check easily with the Recent Changes page) %%
>
> !! Removing the Container
>
> If you want to get rid of the container (and all of the data in it !)
> you first should stop it, then you can remove it with the {{docker
> rm}}
> or {{docker container rm}} command %%small (or use docker rm -f to
> forcibly remove it right away)%%:
> {{{
> $ docker ps
> CONTAINER ID IMAGE COMMAND CREATED
> STATUS PORTS NAMES
> 5f0f5b0b5996 metskem/docker-jspwiki "/usr/local/tomcat/bi" 9
> minutes ago Up About a minute 0.0.0.0:8080->8080/tcp jspwiki
> $ docker stop jspwiki
> jspwiki
> $ docker ps -a
> CONTAINER ID IMAGE COMMAND CREATED
> STATUS PORTS NAMES
> 5f0f5b0b5996 metskem/docker-jspwiki "/usr/local/tomcat/bi" 9
> minutes ago Exited (143) 6 seconds ago
> jspwiki
> $ docker rm jspwiki
> jspwiki
> $ docker ps -a
> CONTAINER ID IMAGE COMMAND CREATED
> STATUS PORTS NAMES
>
> }}}
>
> Note that all your data is lost when you remove the container.
> (You can
> keep data apart using Docker Volumes, see next paragraph)
>
> !! Persisting Data
>
> If you use docker to run JSPWiki only for quick test purposes, you
> probably are not interested in keeping the data (created/changed
> pages,
> registered users, logfiles).\\
> But you can also run a JSPWiki docker container in production-like
> environments where you want to keep your data even after you
> removed a
> container. \\As an example you might sometimes want to run a newer
> version of your JSPWiki Docker container.
>
> ! Seeding the Volume Directory
> To begin with the default pages you can copy them from the source
> tree
> into a host OS directory used to persist the data.
> {{{
> $ cp ./jspwiki-wikipages/en/src/main/resources/*
> <path-to-your>/jspwiki-pages/
> }}}
> ! Running with a Volume
> To use the data outside of the container, you can use the
> {{--volume}}
> switch when you startup the container :
> {{{
> $ docker run -d -p 8080:8080
> --env="jspwiki_baseURL=http://localhost/ <http://localhost/>"
> --name jspwiki_8080
> --volume="<path-to-your>/jspwiki-pages:/var/jspwiki/pages"
> metskem/docker-jspwiki
> 240232ebb32e58dee7ad95471128210f71007bbeb11735ffd5394113959ace75
> }}}
>
> This way you will get your pages in a directory on the host OS in
> <path-to-your>/jspwiki-pages.\\
>
> !! Running Multiple Instances
>
> You can run multiple instances of the image of course. You only
> have to
> make sure they use different TCP ports.\\
> So for example starting 5 containers (with also a limit on memory
> usage
> added) :
> {{{
> $ for PORT in `seq 9080 9084`; do docker run -d -p ${PORT}:8080
> --memory=128m --env="jspwiki_baseURL=http://localhost:${PORT}/"
> --name
> jspwiki-${PORT} metskem/docker-jspwiki; done
> 68481eed8d609ac91711a78bd80505b398a8a37c9cc435e44eb0b2b7f881444b
> b3b967dc4fe721d5efce65959bfd5b4fa6061e053b3fd7b6d814bfc68a0a5261
> 6a23a3ac3df9aaf1a7f2dda96b6a535d58d06a429f458edaa4101ec89a6416e1
> b55b716ed49ff6ca6ba581794fe4ba5bde0439e10301f78acb62d5dec1118304
> 73d4cd8f29a072884a965ad3a86a5d090762fc046fe424c7b842b1c0b3a72122
> $ docker ps
> CONTAINER ID IMAGE COMMAND CREATED
> STATUS PORTS NAMES
> 73d4cd8f29a0 metskem/docker-jspwiki "/bin/sh -c '/usr/lo 4
> seconds ago Up 3 seconds 0.0.0.0:9084->8080/tcp jspwiki-9084
> b55b716ed49f metskem/docker-jspwiki "/bin/sh -c '/usr/lo 4
> seconds ago Up 3 seconds 0.0.0.0:9083->8080/tcp jspwiki-9083
> 6a23a3ac3df9 metskem/docker-jspwiki "/bin/sh -c '/usr/lo 4
> seconds ago Up 3 seconds 0.0.0.0:9082->8080/tcp jspwiki-9082
> b3b967dc4fe7 metskem/docker-jspwiki "/bin/sh -c '/usr/lo 5
> seconds ago Up 4 seconds 0.0.0.0:9081->8080/tcp jspwiki-9081
> 68481eed8d60 metskem/docker-jspwiki "/bin/sh -c '/usr/lo 5
> seconds ago Up 4 seconds 0.0.0.0:9080->8080/tcp jspwiki-9080
>
> }}}
>
> And you can easily get rid of them too :
> {{{
> $ docker stop `docker ps -aq`
> 73d4cd8f29a0
> b55b716ed49f
> 6a23a3ac3df9
> b3b967dc4fe7
> 68481eed8d60
> 240232ebb32e
> c8c73ddd9876
> $ docker rm `docker ps -aq`
> 73d4cd8f29a0
> b55b716ed49f
> 6a23a3ac3df9
> b3b967dc4fe7
> 68481eed8d60
> 240232ebb32e
> c8c73ddd9876
> $ docker ps -a
> CONTAINER ID IMAGE COMMAND CREATED
> STATUS PORTS NAMES
> }}}
>
> !! Customizing Your Image
> You can customize your build by making source code changes (not
> covered
> here) or change other things like the Tomcat base image version and
> platform OS and JDK version.
>
> __Example__: Change the platform OS from Debian to the CentOS based
> variation Amazon Linux 2 that uses their Corretto JDK optimized to
> run
> in AWS.
> Edit the Dockerfile as follows:\\
>
> Change the Maven image used for building JSPWiki to match the one for
> the OS. (Probably not need but done for consistancy)
> {{{
> # FROM maven:3.6-jdk-8 as package
> FROM maven:3.6-amazoncorretto-11 as package
> }}}
> Change the Tomcat base image
> {{{
> # FROM tomcat:9.0
> FROM tomcat:9.0-jdk11-corretto
> }}}
> Replace some Debian specifc lines with RedHat counterparts to add the
> unzip package.
> {{{
> # RUN set -x \
> # && export DEBIAN_FRONTEND=noninteractive \
> # && apt install --fix-missing --quiet --yes unzip
> RUN yum -y install \
> unzip
> }}}
> Add after the {{# install jspwiki}} section and before {{# make port
> visible in metadata}}
> {{{
> # remove unzip and cleanup
> RUN yum -y remove \
> unzip \
> && yum clean all
> }}}
> That's all.. Enjoy!
>
> ---- End
>
Re: Proposed Docker page rework
Posted by Carl Marcum <cm...@apache.org>.
Hi Juan Pablo,
Sorry for my delayed reply now.
I've been busy with an OpenOffice release.
Yes it looks good now. Thanks!
Best regards,
Carl
On 1/11/21 4:48 PM, Juan Pablo Santos Rodríguez wrote:
> Hi,
>
> apologies for the late reply, but yes, of course is ok, whatever page you
> see needs some extra-care please go and edit it :-)
>
> Re. the Docker page, I've seen you've already made some edits, I've made a
> sweep and fixed a big bunch, should be (mostly) ok now.. If there's
> something left to fix, also feel free to edit it
>
> thx for looking into this!
>
>
> br,
> juan pablo
>
> On Sun, Jan 3, 2021 at 4:29 PM Carl Marcum <cm...@apache.org> wrote:
>
>> It looks like there are quite a few non-printable characters causing
>> unwanted line-wrapping.
>>
>> If I try to fix more than a few at a time I'm getting caught by the spam
>> filter.
>> If I keep fixing them there are going to be a lot of page versions.
>> Is that okay?
>>
>> Thanks,
>> Carl
>>
>> On 1/1/21 2:42 PM, Juan Pablo Santos Rodríguez wrote:
>>
>> Hi Carl,
>>
>> the suggested rework looked good to me, so I've just went and posted it at
>> jspwiki-wiki.a.o; if needed, we can continue the rework later on.. I've
>> only added the
>> PageViewPlugin at the end, so that the page shows up at the SystemInfo
>> one. The changes can be seen at
>> https://jspwiki-wiki.apache.org/Diff.jsp?page=Docker&r1=22&r2=21
>>
>>
>> best regards & happy new year!!
>> juan pablo
>>
>> On Mon, Dec 28, 2020 at 2:08 PM Carl Marcum <cm...@apache.org> wrote:
>>
>>> Hi All,
>>>
>>> To avoid the spam filter for such a large change see below for the
>>> proposed page contents.
>>> The references to the previous image on Docker Hub will need replaced
>>> when you have the new one ready.
>>> I'd be happy to make the edit.
>>>
>>> The major changes are the that the image has changed a lot since the
>>> metskem/docker-jspwikiused on the current page so I described the new
>>> one somewhat.
>>>
>>> In addition to using the pre-built image I added how to build your own
>>> and added a example of how you can customize it based on CentOS or
>>> Amazon Linux and the Corretto JDK which I did for mine.
>>>
>>> In the persisting data section I added how to seed the volume directory
>>> with the default pages.
>>>
>>> If you would like to use it or have any changes please let me know.
>>>
>>> Best regards,
>>> Carl
>>>
>>> ---- Begin
>>>
>>> !!! JSPWiki for Docker
>>>
>>> JSPWiki can be used with [Docker|https://docs.docker.com]. Docker images
>>> can be built from source or you can use a pre-built official image.
>>>
>>> [{TableOfContents }]
>>>
>>>
>>> !! Default Image
>>>
>>> The default JSPWiki Docker image uses the official Docker Community
>>> supported [Apache Tomcat 9
>>> image|
>>> https://github.com/docker-library/tomcat/blob/b9416beec5364c00694595d6f3c61b09e764113c/9.0/jdk11/openjdk-buster/Dockerfile]
>>>
>>> which is based on the [OpenJDK
>>> 11|
>>> https://github.com/docker-library/openjdk/blob/20450f7a60b8db7aafd491a5ea55c6a3548138c6/11/jdk/buster/Dockerfile]
>>>
>>> built on Debian Buster.
>>>
>>> JSPWiki is built from source using [Apache
>>> Maven|http://maven.apache.org/] during the image build process.
>>>
>>> !! Prerequisites
>>>
>>> To use the pre-built image or build one from source you only need a
>>> [Docker Engine|https://docs.docker.com/engine/]. See the [installation
>>> instructions|http://docs.docker.com/installation/] on the docker site
>>> for details.
>>>
>>> !! Using the Pre-Built Image
>>> To download it locally from the [docker
>>> hub|https://registry.hub.docker.com/u/metskem/docker-jspwiki/].
>>> ! Get the Image
>>> {{{
>>> $ docker pull metskem/docker-jspwiki
>>> }}}
>>> ! Running the Container
>>> {{{
>>> $ docker run -d -p 8080:8080 --name jspwiki metskem/docker-jspwiki
>>> }}}
>>>
>>> This means :
>>> * __-d__ - detached mode, run the container in the background
>>> * __-p 8080:8080__ - bind the host port (8080) to the container port
>>> (8080). JSPWiki always runs on port 8080 inside the container.
>>> * __--name jspwiki__ - the new docker container will get the name
>>> ''jspwiki'' (instead of a generated container name)
>>> * __metskem/docker-jspwiki__ - the name of the image to run
>>>
>>> !! Building from Source
>>> ! Building the Image
>>> From the source root directory that contains the Dockerfile. The
>>> example uses a {{$version}} variable because the version is referred to
>>> multiple times. It is optional and can be replaced by any version number
>>> you would like to use. If you do not specify a version with the tag name
>>> it will default to 'latest'.
>>>
>>> Watch out for the space and period at the end which means the current
>>> directory.
>>> {{{
>>> $ version='2.11.0'
>>> $ docker build --tag="jspwiki:$version" .
>>> }}}
>>>
>>> ! Running the Container
>>> This is exactly like running the pre-built image except for the image
>>> {{name:version}} at the end.
>>> {{{
>>> $ docker run -d -p 8080:8080 --name jspwiki jspwiki:$version
>>> }}}
>>>
>>> !! Check the Results
>>>
>>> Just point your browser at [http://localhost:8080/], that should give
>>> you a working wiki right away !
>>>
>>> To see the list of running containers use {{docker ps}} or {{docker
>>> container ls}} and {{docker ps -a}} or {{docker container ls -a}} will
>>> show all containers running and stopped.
>>> {{{
>>> $ docker ps
>>> CONTAINER ID IMAGE COMMAND CREATED
>>> STATUS PORTS NAMES
>>> 5f0f5b0b5996 metskem/docker-jspwiki "/usr/local/tomcat/bi" 4
>>> minutes ago Up 4 minutes 0.0.0.0:8080->8080/tcp jspwiki
>>> }}}
>>>
>>> You can also execute commands inside the jspwiki container with the
>>> docker exec command and, for example, look at the last 5 lines in
>>> /var/jspwiki/logs/jspwiki.log :
>>> {{{
>>> $ docker exec -ti jspwiki tail -5 /var/jspwiki/logs/jspwiki.log
>>> 2016-03-28 09:34:35,070 [localhost-startStop-1] INFO
>>> org.apache.wiki.util.UtilJ2eeCompat - apache tomcat detected
>>> 2016-03-28 09:34:35,073 [localhost-startStop-1] INFO
>>> org.apache.wiki.ajax.WikiAjaxDispatcherServlet -
>>> WikiAjaxDispatcherServlet initialized.
>>> 2016-03-28 09:34:35,075 [localhost-startStop-1] INFO
>>> org.apache.wiki.WikiServlet - WikiServlet initialized.
>>> 2016-03-28 09:34:38,054 [http-nio-8080-exec-1] INFO
>>> org.apache.wiki.util.PropertyReader JSPWiki:/
>>> JSPWiki:http://localhost:8080/ - No jspwiki.custom.config defined for
>>> this context, looking for custom properties file with default name of:
>>> /jspwiki-custom.properties
>>> 2016-03-28 09:34:38,057 [http-nio-8080-exec-1] INFO
>>> org.apache.wiki.util.PropertyReader JSPWiki:/
>>> JSPWiki:http://localhost:8080/ - No custom property file found, relying
>>> on JSPWiki defaults.
>>> }}}
>>>
>>> !! Stopping and Starting the Container
>>>
>>> To stop the container, simply issue the {{docker stop}} or {{docker
>>> container stop}} command against the containerid (or container name if
>>> you gave it a name during first run).
>>>
>>> {{{
>>> $ docker ps
>>> CONTAINER ID IMAGE COMMAND CREATED
>>> STATUS PORTS NAMES
>>> 5f0f5b0b5996 metskem/docker-jspwiki "/usr/local/tomcat/bi" 6
>>> minutes ago Up 6 minutes 0.0.0.0:8080->8080/tcp jspwiki
>>> $ docker stop jspwiki
>>> jspwiki
>>> $ docker ps
>>> CONTAINER ID IMAGE COMMAND CREATED
>>> STATUS PORTS NAMES
>>> $ docker ps -a
>>> CONTAINER ID IMAGE COMMAND CREATED
>>> STATUS PORTS NAMES
>>> 5f0f5b0b5996 metskem/docker-jspwiki "/usr/local/tomcat/bi" 6
>>> minutes ago Exited (143) 4 seconds ago jspwiki
>>> }}}
>>>
>>> You can restart it with the {{docker start}} or {{docker container
>>> start}} command, you have to find the containerid with the {{docker ps
>>> -a}} command first , (or simply use the container name if you gave the
>>> container a name during first run):
>>> {{{
>>> $ docker start jspwiki
>>> jspwiki
>>> $ docker ps
>>> CONTAINER ID IMAGE COMMAND CREATED
>>> STATUS PORTS NAMES
>>> 5f0f5b0b5996 metskem/docker-jspwiki "/usr/local/tomcat/bi" 7
>>> minutes ago Up 5 seconds 0.0.0.0:8080->8080/tcp jspwiki
>>> }}}
>>>
>>> As you will notice, after a stop/start you still have the data (pages)
>>> that were created after the first container start. %%small (you can
>>> check easily with the Recent Changes page) %%
>>>
>>> !! Removing the Container
>>>
>>> If you want to get rid of the container (and all of the data in it !)
>>> you first should stop it, then you can remove it with the {{docker rm}}
>>> or {{docker container rm}} command %%small (or use docker rm -f to
>>> forcibly remove it right away)%%:
>>> {{{
>>> $ docker ps
>>> CONTAINER ID IMAGE COMMAND CREATED
>>> STATUS PORTS NAMES
>>> 5f0f5b0b5996 metskem/docker-jspwiki "/usr/local/tomcat/bi" 9
>>> minutes ago Up About a minute 0.0.0.0:8080->8080/tcp jspwiki
>>> $ docker stop jspwiki
>>> jspwiki
>>> $ docker ps -a
>>> CONTAINER ID IMAGE COMMAND CREATED
>>> STATUS PORTS NAMES
>>> 5f0f5b0b5996 metskem/docker-jspwiki "/usr/local/tomcat/bi" 9
>>> minutes ago Exited (143) 6 seconds ago jspwiki
>>> $ docker rm jspwiki
>>> jspwiki
>>> $ docker ps -a
>>> CONTAINER ID IMAGE COMMAND CREATED
>>> STATUS PORTS NAMES
>>>
>>> }}}
>>>
>>> Note that all your data is lost when you remove the container. (You can
>>> keep data apart using Docker Volumes, see next paragraph)
>>>
>>> !! Persisting Data
>>>
>>> If you use docker to run JSPWiki only for quick test purposes, you
>>> probably are not interested in keeping the data (created/changed pages,
>>> registered users, logfiles).\\
>>> But you can also run a JSPWiki docker container in production-like
>>> environments where you want to keep your data even after you removed a
>>> container. \\As an example you might sometimes want to run a newer
>>> version of your JSPWiki Docker container.
>>>
>>> ! Seeding the Volume Directory
>>> To begin with the default pages you can copy them from the source tree
>>> into a host OS directory used to persist the data.
>>> {{{
>>> $ cp ./jspwiki-wikipages/en/src/main/resources/*
>>> <path-to-your>/jspwiki-pages/
>>> }}}
>>> ! Running with a Volume
>>> To use the data outside of the container, you can use the {{--volume}}
>>> switch when you startup the container :
>>> {{{
>>> $ docker run -d -p 8080:8080 --env="jspwiki_baseURL=http://localhost/"
>>> --name jspwiki_8080
>>> --volume="<path-to-your>/jspwiki-pages:/var/jspwiki/pages"
>>> metskem/docker-jspwiki
>>> 240232ebb32e58dee7ad95471128210f71007bbeb11735ffd5394113959ace75
>>> }}}
>>>
>>> This way you will get your pages in a directory on the host OS in
>>> <path-to-your>/jspwiki-pages.\\
>>>
>>> !! Running Multiple Instances
>>>
>>> You can run multiple instances of the image of course. You only have to
>>> make sure they use different TCP ports.\\
>>> So for example starting 5 containers (with also a limit on memory usage
>>> added) :
>>> {{{
>>> $ for PORT in `seq 9080 9084`; do docker run -d -p ${PORT}:8080
>>> --memory=128m --env="jspwiki_baseURL=http://localhost:${PORT}/" --name
>>> jspwiki-${PORT} metskem/docker-jspwiki; done
>>> 68481eed8d609ac91711a78bd80505b398a8a37c9cc435e44eb0b2b7f881444b
>>> b3b967dc4fe721d5efce65959bfd5b4fa6061e053b3fd7b6d814bfc68a0a5261
>>> 6a23a3ac3df9aaf1a7f2dda96b6a535d58d06a429f458edaa4101ec89a6416e1
>>> b55b716ed49ff6ca6ba581794fe4ba5bde0439e10301f78acb62d5dec1118304
>>> 73d4cd8f29a072884a965ad3a86a5d090762fc046fe424c7b842b1c0b3a72122
>>> $ docker ps
>>> CONTAINER ID IMAGE COMMAND CREATED
>>> STATUS PORTS NAMES
>>> 73d4cd8f29a0 metskem/docker-jspwiki "/bin/sh -c '/usr/lo 4
>>> seconds ago Up 3 seconds 0.0.0.0:9084->8080/tcp jspwiki-9084
>>> b55b716ed49f metskem/docker-jspwiki "/bin/sh -c '/usr/lo 4
>>> seconds ago Up 3 seconds 0.0.0.0:9083->8080/tcp jspwiki-9083
>>> 6a23a3ac3df9 metskem/docker-jspwiki "/bin/sh -c '/usr/lo 4
>>> seconds ago Up 3 seconds 0.0.0.0:9082->8080/tcp jspwiki-9082
>>> b3b967dc4fe7 metskem/docker-jspwiki "/bin/sh -c '/usr/lo 5
>>> seconds ago Up 4 seconds 0.0.0.0:9081->8080/tcp jspwiki-9081
>>> 68481eed8d60 metskem/docker-jspwiki "/bin/sh -c '/usr/lo 5
>>> seconds ago Up 4 seconds 0.0.0.0:9080->8080/tcp jspwiki-9080
>>>
>>> }}}
>>>
>>> And you can easily get rid of them too :
>>> {{{
>>> $ docker stop `docker ps -aq`
>>> 73d4cd8f29a0
>>> b55b716ed49f
>>> 6a23a3ac3df9
>>> b3b967dc4fe7
>>> 68481eed8d60
>>> 240232ebb32e
>>> c8c73ddd9876
>>> $ docker rm `docker ps -aq`
>>> 73d4cd8f29a0
>>> b55b716ed49f
>>> 6a23a3ac3df9
>>> b3b967dc4fe7
>>> 68481eed8d60
>>> 240232ebb32e
>>> c8c73ddd9876
>>> $ docker ps -a
>>> CONTAINER ID IMAGE COMMAND CREATED
>>> STATUS PORTS NAMES
>>> }}}
>>>
>>> !! Customizing Your Image
>>> You can customize your build by making source code changes (not covered
>>> here) or change other things like the Tomcat base image version and
>>> platform OS and JDK version.
>>>
>>> __Example__: Change the platform OS from Debian to the CentOS based
>>> variation Amazon Linux 2 that uses their Corretto JDK optimized to run
>>> in AWS.
>>> Edit the Dockerfile as follows:\\
>>>
>>> Change the Maven image used for building JSPWiki to match the one for
>>> the OS. (Probably not need but done for consistancy)
>>> {{{
>>> # FROM maven:3.6-jdk-8 as package
>>> FROM maven:3.6-amazoncorretto-11 as package
>>> }}}
>>> Change the Tomcat base image
>>> {{{
>>> # FROM tomcat:9.0
>>> FROM tomcat:9.0-jdk11-corretto
>>> }}}
>>> Replace some Debian specifc lines with RedHat counterparts to add the
>>> unzip package.
>>> {{{
>>> # RUN set -x \
>>> # && export DEBIAN_FRONTEND=noninteractive \
>>> # && apt install --fix-missing --quiet --yes unzip
>>> RUN yum -y install \
>>> unzip
>>> }}}
>>> Add after the {{# install jspwiki}} section and before {{# make port
>>> visible in metadata}}
>>> {{{
>>> # remove unzip and cleanup
>>> RUN yum -y remove \
>>> unzip \
>>> && yum clean all
>>> }}}
>>> That's all.. Enjoy!
>>>
>>> ---- End
>>>
>>
Re: Proposed Docker page rework
Posted by Juan Pablo Santos Rodríguez <ju...@gmail.com>.
Hi,
apologies for the late reply, but yes, of course is ok, whatever page you
see needs some extra-care please go and edit it :-)
Re. the Docker page, I've seen you've already made some edits, I've made a
sweep and fixed a big bunch, should be (mostly) ok now.. If there's
something left to fix, also feel free to edit it
thx for looking into this!
br,
juan pablo
On Sun, Jan 3, 2021 at 4:29 PM Carl Marcum <cm...@apache.org> wrote:
> It looks like there are quite a few non-printable characters causing
> unwanted line-wrapping.
>
> If I try to fix more than a few at a time I'm getting caught by the spam
> filter.
> If I keep fixing them there are going to be a lot of page versions.
> Is that okay?
>
> Thanks,
> Carl
>
> On 1/1/21 2:42 PM, Juan Pablo Santos Rodríguez wrote:
>
> Hi Carl,
>
> the suggested rework looked good to me, so I've just went and posted it at
> jspwiki-wiki.a.o; if needed, we can continue the rework later on.. I've
> only added the
> PageViewPlugin at the end, so that the page shows up at the SystemInfo
> one. The changes can be seen at
> https://jspwiki-wiki.apache.org/Diff.jsp?page=Docker&r1=22&r2=21
>
>
> best regards & happy new year!!
> juan pablo
>
> On Mon, Dec 28, 2020 at 2:08 PM Carl Marcum <cm...@apache.org> wrote:
>
>> Hi All,
>>
>> To avoid the spam filter for such a large change see below for the
>> proposed page contents.
>> The references to the previous image on Docker Hub will need replaced
>> when you have the new one ready.
>> I'd be happy to make the edit.
>>
>> The major changes are the that the image has changed a lot since the
>> metskem/docker-jspwikiused on the current page so I described the new
>> one somewhat.
>>
>> In addition to using the pre-built image I added how to build your own
>> and added a example of how you can customize it based on CentOS or
>> Amazon Linux and the Corretto JDK which I did for mine.
>>
>> In the persisting data section I added how to seed the volume directory
>> with the default pages.
>>
>> If you would like to use it or have any changes please let me know.
>>
>> Best regards,
>> Carl
>>
>> ---- Begin
>>
>> !!! JSPWiki for Docker
>>
>> JSPWiki can be used with [Docker|https://docs.docker.com]. Docker images
>> can be built from source or you can use a pre-built official image.
>>
>> [{TableOfContents }]
>>
>>
>> !! Default Image
>>
>> The default JSPWiki Docker image uses the official Docker Community
>> supported [Apache Tomcat 9
>> image|
>> https://github.com/docker-library/tomcat/blob/b9416beec5364c00694595d6f3c61b09e764113c/9.0/jdk11/openjdk-buster/Dockerfile]
>>
>> which is based on the [OpenJDK
>> 11|
>> https://github.com/docker-library/openjdk/blob/20450f7a60b8db7aafd491a5ea55c6a3548138c6/11/jdk/buster/Dockerfile]
>>
>> built on Debian Buster.
>>
>> JSPWiki is built from source using [Apache
>> Maven|http://maven.apache.org/] during the image build process.
>>
>> !! Prerequisites
>>
>> To use the pre-built image or build one from source you only need a
>> [Docker Engine|https://docs.docker.com/engine/]. See the [installation
>> instructions|http://docs.docker.com/installation/] on the docker site
>> for details.
>>
>> !! Using the Pre-Built Image
>> To download it locally from the [docker
>> hub|https://registry.hub.docker.com/u/metskem/docker-jspwiki/].
>> ! Get the Image
>> {{{
>> $ docker pull metskem/docker-jspwiki
>> }}}
>> ! Running the Container
>> {{{
>> $ docker run -d -p 8080:8080 --name jspwiki metskem/docker-jspwiki
>> }}}
>>
>> This means :
>> * __-d__ - detached mode, run the container in the background
>> * __-p 8080:8080__ - bind the host port (8080) to the container port
>> (8080). JSPWiki always runs on port 8080 inside the container.
>> * __--name jspwiki__ - the new docker container will get the name
>> ''jspwiki'' (instead of a generated container name)
>> * __metskem/docker-jspwiki__ - the name of the image to run
>>
>> !! Building from Source
>> ! Building the Image
>> From the source root directory that contains the Dockerfile. The
>> example uses a {{$version}} variable because the version is referred to
>> multiple times. It is optional and can be replaced by any version number
>> you would like to use. If you do not specify a version with the tag name
>> it will default to 'latest'.
>>
>> Watch out for the space and period at the end which means the current
>> directory.
>> {{{
>> $ version='2.11.0'
>> $ docker build --tag="jspwiki:$version" .
>> }}}
>>
>> ! Running the Container
>> This is exactly like running the pre-built image except for the image
>> {{name:version}} at the end.
>> {{{
>> $ docker run -d -p 8080:8080 --name jspwiki jspwiki:$version
>> }}}
>>
>> !! Check the Results
>>
>> Just point your browser at [http://localhost:8080/], that should give
>> you a working wiki right away !
>>
>> To see the list of running containers use {{docker ps}} or {{docker
>> container ls}} and {{docker ps -a}} or {{docker container ls -a}} will
>> show all containers running and stopped.
>> {{{
>> $ docker ps
>> CONTAINER ID IMAGE COMMAND CREATED
>> STATUS PORTS NAMES
>> 5f0f5b0b5996 metskem/docker-jspwiki "/usr/local/tomcat/bi" 4
>> minutes ago Up 4 minutes 0.0.0.0:8080->8080/tcp jspwiki
>> }}}
>>
>> You can also execute commands inside the jspwiki container with the
>> docker exec command and, for example, look at the last 5 lines in
>> /var/jspwiki/logs/jspwiki.log :
>> {{{
>> $ docker exec -ti jspwiki tail -5 /var/jspwiki/logs/jspwiki.log
>> 2016-03-28 09:34:35,070 [localhost-startStop-1] INFO
>> org.apache.wiki.util.UtilJ2eeCompat - apache tomcat detected
>> 2016-03-28 09:34:35,073 [localhost-startStop-1] INFO
>> org.apache.wiki.ajax.WikiAjaxDispatcherServlet -
>> WikiAjaxDispatcherServlet initialized.
>> 2016-03-28 09:34:35,075 [localhost-startStop-1] INFO
>> org.apache.wiki.WikiServlet - WikiServlet initialized.
>> 2016-03-28 09:34:38,054 [http-nio-8080-exec-1] INFO
>> org.apache.wiki.util.PropertyReader JSPWiki:/
>> JSPWiki:http://localhost:8080/ - No jspwiki.custom.config defined for
>> this context, looking for custom properties file with default name of:
>> /jspwiki-custom.properties
>> 2016-03-28 09:34:38,057 [http-nio-8080-exec-1] INFO
>> org.apache.wiki.util.PropertyReader JSPWiki:/
>> JSPWiki:http://localhost:8080/ - No custom property file found, relying
>> on JSPWiki defaults.
>> }}}
>>
>> !! Stopping and Starting the Container
>>
>> To stop the container, simply issue the {{docker stop}} or {{docker
>> container stop}} command against the containerid (or container name if
>> you gave it a name during first run).
>>
>> {{{
>> $ docker ps
>> CONTAINER ID IMAGE COMMAND CREATED
>> STATUS PORTS NAMES
>> 5f0f5b0b5996 metskem/docker-jspwiki "/usr/local/tomcat/bi" 6
>> minutes ago Up 6 minutes 0.0.0.0:8080->8080/tcp jspwiki
>> $ docker stop jspwiki
>> jspwiki
>> $ docker ps
>> CONTAINER ID IMAGE COMMAND CREATED
>> STATUS PORTS NAMES
>> $ docker ps -a
>> CONTAINER ID IMAGE COMMAND CREATED
>> STATUS PORTS NAMES
>> 5f0f5b0b5996 metskem/docker-jspwiki "/usr/local/tomcat/bi" 6
>> minutes ago Exited (143) 4 seconds ago jspwiki
>> }}}
>>
>> You can restart it with the {{docker start}} or {{docker container
>> start}} command, you have to find the containerid with the {{docker ps
>> -a}} command first , (or simply use the container name if you gave the
>> container a name during first run):
>> {{{
>> $ docker start jspwiki
>> jspwiki
>> $ docker ps
>> CONTAINER ID IMAGE COMMAND CREATED
>> STATUS PORTS NAMES
>> 5f0f5b0b5996 metskem/docker-jspwiki "/usr/local/tomcat/bi" 7
>> minutes ago Up 5 seconds 0.0.0.0:8080->8080/tcp jspwiki
>> }}}
>>
>> As you will notice, after a stop/start you still have the data (pages)
>> that were created after the first container start. %%small (you can
>> check easily with the Recent Changes page) %%
>>
>> !! Removing the Container
>>
>> If you want to get rid of the container (and all of the data in it !)
>> you first should stop it, then you can remove it with the {{docker rm}}
>> or {{docker container rm}} command %%small (or use docker rm -f to
>> forcibly remove it right away)%%:
>> {{{
>> $ docker ps
>> CONTAINER ID IMAGE COMMAND CREATED
>> STATUS PORTS NAMES
>> 5f0f5b0b5996 metskem/docker-jspwiki "/usr/local/tomcat/bi" 9
>> minutes ago Up About a minute 0.0.0.0:8080->8080/tcp jspwiki
>> $ docker stop jspwiki
>> jspwiki
>> $ docker ps -a
>> CONTAINER ID IMAGE COMMAND CREATED
>> STATUS PORTS NAMES
>> 5f0f5b0b5996 metskem/docker-jspwiki "/usr/local/tomcat/bi" 9
>> minutes ago Exited (143) 6 seconds ago jspwiki
>> $ docker rm jspwiki
>> jspwiki
>> $ docker ps -a
>> CONTAINER ID IMAGE COMMAND CREATED
>> STATUS PORTS NAMES
>>
>> }}}
>>
>> Note that all your data is lost when you remove the container. (You can
>> keep data apart using Docker Volumes, see next paragraph)
>>
>> !! Persisting Data
>>
>> If you use docker to run JSPWiki only for quick test purposes, you
>> probably are not interested in keeping the data (created/changed pages,
>> registered users, logfiles).\\
>> But you can also run a JSPWiki docker container in production-like
>> environments where you want to keep your data even after you removed a
>> container. \\As an example you might sometimes want to run a newer
>> version of your JSPWiki Docker container.
>>
>> ! Seeding the Volume Directory
>> To begin with the default pages you can copy them from the source tree
>> into a host OS directory used to persist the data.
>> {{{
>> $ cp ./jspwiki-wikipages/en/src/main/resources/*
>> <path-to-your>/jspwiki-pages/
>> }}}
>> ! Running with a Volume
>> To use the data outside of the container, you can use the {{--volume}}
>> switch when you startup the container :
>> {{{
>> $ docker run -d -p 8080:8080 --env="jspwiki_baseURL=http://localhost/"
>> --name jspwiki_8080
>> --volume="<path-to-your>/jspwiki-pages:/var/jspwiki/pages"
>> metskem/docker-jspwiki
>> 240232ebb32e58dee7ad95471128210f71007bbeb11735ffd5394113959ace75
>> }}}
>>
>> This way you will get your pages in a directory on the host OS in
>> <path-to-your>/jspwiki-pages.\\
>>
>> !! Running Multiple Instances
>>
>> You can run multiple instances of the image of course. You only have to
>> make sure they use different TCP ports.\\
>> So for example starting 5 containers (with also a limit on memory usage
>> added) :
>> {{{
>> $ for PORT in `seq 9080 9084`; do docker run -d -p ${PORT}:8080
>> --memory=128m --env="jspwiki_baseURL=http://localhost:${PORT}/" --name
>> jspwiki-${PORT} metskem/docker-jspwiki; done
>> 68481eed8d609ac91711a78bd80505b398a8a37c9cc435e44eb0b2b7f881444b
>> b3b967dc4fe721d5efce65959bfd5b4fa6061e053b3fd7b6d814bfc68a0a5261
>> 6a23a3ac3df9aaf1a7f2dda96b6a535d58d06a429f458edaa4101ec89a6416e1
>> b55b716ed49ff6ca6ba581794fe4ba5bde0439e10301f78acb62d5dec1118304
>> 73d4cd8f29a072884a965ad3a86a5d090762fc046fe424c7b842b1c0b3a72122
>> $ docker ps
>> CONTAINER ID IMAGE COMMAND CREATED
>> STATUS PORTS NAMES
>> 73d4cd8f29a0 metskem/docker-jspwiki "/bin/sh -c '/usr/lo 4
>> seconds ago Up 3 seconds 0.0.0.0:9084->8080/tcp jspwiki-9084
>> b55b716ed49f metskem/docker-jspwiki "/bin/sh -c '/usr/lo 4
>> seconds ago Up 3 seconds 0.0.0.0:9083->8080/tcp jspwiki-9083
>> 6a23a3ac3df9 metskem/docker-jspwiki "/bin/sh -c '/usr/lo 4
>> seconds ago Up 3 seconds 0.0.0.0:9082->8080/tcp jspwiki-9082
>> b3b967dc4fe7 metskem/docker-jspwiki "/bin/sh -c '/usr/lo 5
>> seconds ago Up 4 seconds 0.0.0.0:9081->8080/tcp jspwiki-9081
>> 68481eed8d60 metskem/docker-jspwiki "/bin/sh -c '/usr/lo 5
>> seconds ago Up 4 seconds 0.0.0.0:9080->8080/tcp jspwiki-9080
>>
>> }}}
>>
>> And you can easily get rid of them too :
>> {{{
>> $ docker stop `docker ps -aq`
>> 73d4cd8f29a0
>> b55b716ed49f
>> 6a23a3ac3df9
>> b3b967dc4fe7
>> 68481eed8d60
>> 240232ebb32e
>> c8c73ddd9876
>> $ docker rm `docker ps -aq`
>> 73d4cd8f29a0
>> b55b716ed49f
>> 6a23a3ac3df9
>> b3b967dc4fe7
>> 68481eed8d60
>> 240232ebb32e
>> c8c73ddd9876
>> $ docker ps -a
>> CONTAINER ID IMAGE COMMAND CREATED
>> STATUS PORTS NAMES
>> }}}
>>
>> !! Customizing Your Image
>> You can customize your build by making source code changes (not covered
>> here) or change other things like the Tomcat base image version and
>> platform OS and JDK version.
>>
>> __Example__: Change the platform OS from Debian to the CentOS based
>> variation Amazon Linux 2 that uses their Corretto JDK optimized to run
>> in AWS.
>> Edit the Dockerfile as follows:\\
>>
>> Change the Maven image used for building JSPWiki to match the one for
>> the OS. (Probably not need but done for consistancy)
>> {{{
>> # FROM maven:3.6-jdk-8 as package
>> FROM maven:3.6-amazoncorretto-11 as package
>> }}}
>> Change the Tomcat base image
>> {{{
>> # FROM tomcat:9.0
>> FROM tomcat:9.0-jdk11-corretto
>> }}}
>> Replace some Debian specifc lines with RedHat counterparts to add the
>> unzip package.
>> {{{
>> # RUN set -x \
>> # && export DEBIAN_FRONTEND=noninteractive \
>> # && apt install --fix-missing --quiet --yes unzip
>> RUN yum -y install \
>> unzip
>> }}}
>> Add after the {{# install jspwiki}} section and before {{# make port
>> visible in metadata}}
>> {{{
>> # remove unzip and cleanup
>> RUN yum -y remove \
>> unzip \
>> && yum clean all
>> }}}
>> That's all.. Enjoy!
>>
>> ---- End
>>
>
>
Re: Proposed Docker page rework
Posted by Carl Marcum <cm...@apache.org>.
It looks like there are quite a few non-printable characters causing
unwanted line-wrapping.
If I try to fix more than a few at a time I'm getting caught by the spam
filter.
If I keep fixing them there are going to be a lot of page versions.
Is that okay?
Thanks,
Carl
On 1/1/21 2:42 PM, Juan Pablo Santos Rodríguez wrote:
> Hi Carl,
>
> the suggested rework looked good to me, so I've just went and posted
> it at jspwiki-wiki.a.o; if needed, we can continue the rework later
> on.. I've only added the
> PageViewPlugin at the end, so that the page shows up at the SystemInfo
> one. The changes can be seen at
> https://jspwiki-wiki.apache.org/Diff.jsp?page=Docker&r1=22&r2=21
> <https://jspwiki-wiki.apache.org/Diff.jsp?page=Docker&r1=22&r2=21>
>
>
> best regards & happy new year!!
> juan pablo
>
> On Mon, Dec 28, 2020 at 2:08 PM Carl Marcum <cmarcum@apache.org
> <ma...@apache.org>> wrote:
>
> Hi All,
>
> To avoid the spam filter for such a large change see below for the
> proposed page contents.
> The references to the previous image on Docker Hub will need replaced
> when you have the new one ready.
> I'd be happy to make the edit.
>
> The major changes are the that the image has changed a lot since the
> metskem/docker-jspwikiused on the current page so I described the new
> one somewhat.
>
> In addition to using the pre-built image I added how to build your
> own
> and added a example of how you can customize it based on CentOS or
> Amazon Linux and the Corretto JDK which I did for mine.
>
> In the persisting data section I added how to seed the volume
> directory
> with the default pages.
>
> If you would like to use it or have any changes please let me know.
>
> Best regards,
> Carl
>
> ---- Begin
>
> !!! JSPWiki for Docker
>
> JSPWiki can be used with [Docker|https://docs.docker.com
> <https://docs.docker.com>]. Docker images
> can be built from source or you can use a pre-built official image.
>
> [{TableOfContents }]
>
>
> !! Default Image
>
> The default JSPWiki Docker image uses the official Docker Community
> supported [Apache Tomcat 9
> image|https://github.com/docker-library/tomcat/blob/b9416beec5364c00694595d6f3c61b09e764113c/9.0/jdk11/openjdk-buster/Dockerfile
> <https://github.com/docker-library/tomcat/blob/b9416beec5364c00694595d6f3c61b09e764113c/9.0/jdk11/openjdk-buster/Dockerfile>]
>
> which is based on the [OpenJDK
> 11|https://github.com/docker-library/openjdk/blob/20450f7a60b8db7aafd491a5ea55c6a3548138c6/11/jdk/buster/Dockerfile
> <https://github.com/docker-library/openjdk/blob/20450f7a60b8db7aafd491a5ea55c6a3548138c6/11/jdk/buster/Dockerfile>]
>
> built on Debian Buster.
>
> JSPWiki is built from source using [Apache
> Maven|http://maven.apache.org/ <http://maven.apache.org/>] during
> the image build process.
>
> !! Prerequisites
>
> To use the pre-built image or build one from source you only need a
> [Docker Engine|https://docs.docker.com/engine/
> <https://docs.docker.com/engine/>]. See the [installation
> instructions|http://docs.docker.com/installation/
> <http://docs.docker.com/installation/>] on the docker site
> for details.
>
> !! Using the Pre-Built Image
> To download it locally from the [docker
> hub|https://registry.hub.docker.com/u/metskem/docker-jspwiki/
> <https://registry.hub.docker.com/u/metskem/docker-jspwiki/>].
> ! Get the Image
> {{{
> $ docker pull metskem/docker-jspwiki
> }}}
> ! Running the Container
> {{{
> $ docker run -d -p 8080:8080 --name jspwiki metskem/docker-jspwiki
> }}}
>
> This means :
> * __-d__ - detached mode, run the container in the background
> * __-p 8080:8080__ - bind the host port (8080) to the container port
> (8080). JSPWiki always runs on port 8080 inside the container.
> * __--name jspwiki__ - the new docker container will get the name
> ''jspwiki'' (instead of a generated container name)
> * __metskem/docker-jspwiki__ - the name of the image to run
>
> !! Building from Source
> ! Building the Image
> From the source root directory that contains the Dockerfile. The
> example uses a {{$version}} variable because the version is
> referred to
> multiple times. It is optional and can be replaced by any version
> number
> you would like to use. If you do not specify a version with the
> tag name
> it will default to 'latest'.
>
> Watch out for the space and period at the end which means the current
> directory.
> {{{
> $ version='2.11.0'
> $ docker build --tag="jspwiki:$version" .
> }}}
>
> ! Running the Container
> This is exactly like running the pre-built image except for the image
> {{name:version}} at the end.
> {{{
> $ docker run -d -p 8080:8080 --name jspwiki jspwiki:$version
> }}}
>
> !! Check the Results
>
> Just point your browser at [http://localhost:8080/
> <http://localhost:8080/>], that should give
> you a working wiki right away !
>
> To see the list of running containers use {{docker ps}} or {{docker
> container ls}} and {{docker ps -a}} or {{docker container ls -a}}
> will
> show all containers running and stopped.
> {{{
> $ docker ps
> CONTAINER ID IMAGE COMMAND CREATED
> STATUS PORTS NAMES
> 5f0f5b0b5996 metskem/docker-jspwiki "/usr/local/tomcat/bi" 4
> minutes ago Up 4 minutes 0.0.0.0:8080->8080/tcp jspwiki
> }}}
>
> You can also execute commands inside the jspwiki container with the
> docker exec command and, for example, look at the last 5 lines in
> /var/jspwiki/logs/jspwiki.log :
> {{{
> $ docker exec -ti jspwiki tail -5 /var/jspwiki/logs/jspwiki.log
> 2016-03-28 09:34:35,070 [localhost-startStop-1] INFO
> org.apache.wiki.util.UtilJ2eeCompat - apache tomcat detected
> 2016-03-28 09:34:35,073 [localhost-startStop-1] INFO
> org.apache.wiki.ajax.WikiAjaxDispatcherServlet -
> WikiAjaxDispatcherServlet initialized.
> 2016-03-28 09:34:35,075 [localhost-startStop-1] INFO
> org.apache.wiki.WikiServlet - WikiServlet initialized.
> 2016-03-28 09:34:38,054 [http-nio-8080-exec-1] INFO
> org.apache.wiki.util.PropertyReader JSPWiki:/
> JSPWiki:http://localhost:8080/ <http://localhost:8080/> - No
> jspwiki.custom.config defined for
> this context, looking for custom properties file with default name
> of:
> /jspwiki-custom.properties
> 2016-03-28 09:34:38,057 [http-nio-8080-exec-1] INFO
> org.apache.wiki.util.PropertyReader JSPWiki:/
> JSPWiki:http://localhost:8080/ <http://localhost:8080/> - No
> custom property file found, relying
> on JSPWiki defaults.
> }}}
>
> !! Stopping and Starting the Container
>
> To stop the container, simply issue the {{docker stop}} or {{docker
> container stop}} command against the containerid (or container
> name if
> you gave it a name during first run).
>
> {{{
> $ docker ps
> CONTAINER ID IMAGE COMMAND CREATED
> STATUS PORTS NAMES
> 5f0f5b0b5996 metskem/docker-jspwiki "/usr/local/tomcat/bi" 6
> minutes ago Up 6 minutes 0.0.0.0:8080->8080/tcp jspwiki
> $ docker stop jspwiki
> jspwiki
> $ docker ps
> CONTAINER ID IMAGE COMMAND CREATED
> STATUS PORTS NAMES
> $ docker ps -a
> CONTAINER ID IMAGE COMMAND CREATED
> STATUS PORTS NAMES
> 5f0f5b0b5996 metskem/docker-jspwiki "/usr/local/tomcat/bi" 6
> minutes ago Exited (143) 4 seconds ago
> jspwiki
> }}}
>
> You can restart it with the {{docker start}} or {{docker container
> start}} command, you have to find the containerid with the
> {{docker ps
> -a}} command first , (or simply use the container name if you gave
> the
> container a name during first run):
> {{{
> $ docker start jspwiki
> jspwiki
> $ docker ps
> CONTAINER ID IMAGE COMMAND CREATED
> STATUS PORTS NAMES
> 5f0f5b0b5996 metskem/docker-jspwiki "/usr/local/tomcat/bi" 7
> minutes ago Up 5 seconds 0.0.0.0:8080->8080/tcp jspwiki
> }}}
>
> As you will notice, after a stop/start you still have the data
> (pages)
> that were created after the first container start. %%small (you can
> check easily with the Recent Changes page) %%
>
> !! Removing the Container
>
> If you want to get rid of the container (and all of the data in it !)
> you first should stop it, then you can remove it with the {{docker
> rm}}
> or {{docker container rm}} command %%small (or use docker rm -f to
> forcibly remove it right away)%%:
> {{{
> $ docker ps
> CONTAINER ID IMAGE COMMAND CREATED
> STATUS PORTS NAMES
> 5f0f5b0b5996 metskem/docker-jspwiki "/usr/local/tomcat/bi" 9
> minutes ago Up About a minute 0.0.0.0:8080->8080/tcp jspwiki
> $ docker stop jspwiki
> jspwiki
> $ docker ps -a
> CONTAINER ID IMAGE COMMAND CREATED
> STATUS PORTS NAMES
> 5f0f5b0b5996 metskem/docker-jspwiki "/usr/local/tomcat/bi" 9
> minutes ago Exited (143) 6 seconds ago
> jspwiki
> $ docker rm jspwiki
> jspwiki
> $ docker ps -a
> CONTAINER ID IMAGE COMMAND CREATED
> STATUS PORTS NAMES
>
> }}}
>
> Note that all your data is lost when you remove the container.
> (You can
> keep data apart using Docker Volumes, see next paragraph)
>
> !! Persisting Data
>
> If you use docker to run JSPWiki only for quick test purposes, you
> probably are not interested in keeping the data (created/changed
> pages,
> registered users, logfiles).\\
> But you can also run a JSPWiki docker container in production-like
> environments where you want to keep your data even after you
> removed a
> container. \\As an example you might sometimes want to run a newer
> version of your JSPWiki Docker container.
>
> ! Seeding the Volume Directory
> To begin with the default pages you can copy them from the source
> tree
> into a host OS directory used to persist the data.
> {{{
> $ cp ./jspwiki-wikipages/en/src/main/resources/*
> <path-to-your>/jspwiki-pages/
> }}}
> ! Running with a Volume
> To use the data outside of the container, you can use the
> {{--volume}}
> switch when you startup the container :
> {{{
> $ docker run -d -p 8080:8080
> --env="jspwiki_baseURL=http://localhost/ <http://localhost/>"
> --name jspwiki_8080
> --volume="<path-to-your>/jspwiki-pages:/var/jspwiki/pages"
> metskem/docker-jspwiki
> 240232ebb32e58dee7ad95471128210f71007bbeb11735ffd5394113959ace75
> }}}
>
> This way you will get your pages in a directory on the host OS in
> <path-to-your>/jspwiki-pages.\\
>
> !! Running Multiple Instances
>
> You can run multiple instances of the image of course. You only
> have to
> make sure they use different TCP ports.\\
> So for example starting 5 containers (with also a limit on memory
> usage
> added) :
> {{{
> $ for PORT in `seq 9080 9084`; do docker run -d -p ${PORT}:8080
> --memory=128m --env="jspwiki_baseURL=http://localhost:${PORT}/"
> --name
> jspwiki-${PORT} metskem/docker-jspwiki; done
> 68481eed8d609ac91711a78bd80505b398a8a37c9cc435e44eb0b2b7f881444b
> b3b967dc4fe721d5efce65959bfd5b4fa6061e053b3fd7b6d814bfc68a0a5261
> 6a23a3ac3df9aaf1a7f2dda96b6a535d58d06a429f458edaa4101ec89a6416e1
> b55b716ed49ff6ca6ba581794fe4ba5bde0439e10301f78acb62d5dec1118304
> 73d4cd8f29a072884a965ad3a86a5d090762fc046fe424c7b842b1c0b3a72122
> $ docker ps
> CONTAINER ID IMAGE COMMAND CREATED
> STATUS PORTS NAMES
> 73d4cd8f29a0 metskem/docker-jspwiki "/bin/sh -c '/usr/lo 4
> seconds ago Up 3 seconds 0.0.0.0:9084->8080/tcp jspwiki-9084
> b55b716ed49f metskem/docker-jspwiki "/bin/sh -c '/usr/lo 4
> seconds ago Up 3 seconds 0.0.0.0:9083->8080/tcp jspwiki-9083
> 6a23a3ac3df9 metskem/docker-jspwiki "/bin/sh -c '/usr/lo 4
> seconds ago Up 3 seconds 0.0.0.0:9082->8080/tcp jspwiki-9082
> b3b967dc4fe7 metskem/docker-jspwiki "/bin/sh -c '/usr/lo 5
> seconds ago Up 4 seconds 0.0.0.0:9081->8080/tcp jspwiki-9081
> 68481eed8d60 metskem/docker-jspwiki "/bin/sh -c '/usr/lo 5
> seconds ago Up 4 seconds 0.0.0.0:9080->8080/tcp jspwiki-9080
>
> }}}
>
> And you can easily get rid of them too :
> {{{
> $ docker stop `docker ps -aq`
> 73d4cd8f29a0
> b55b716ed49f
> 6a23a3ac3df9
> b3b967dc4fe7
> 68481eed8d60
> 240232ebb32e
> c8c73ddd9876
> $ docker rm `docker ps -aq`
> 73d4cd8f29a0
> b55b716ed49f
> 6a23a3ac3df9
> b3b967dc4fe7
> 68481eed8d60
> 240232ebb32e
> c8c73ddd9876
> $ docker ps -a
> CONTAINER ID IMAGE COMMAND CREATED
> STATUS PORTS NAMES
> }}}
>
> !! Customizing Your Image
> You can customize your build by making source code changes (not
> covered
> here) or change other things like the Tomcat base image version and
> platform OS and JDK version.
>
> __Example__: Change the platform OS from Debian to the CentOS based
> variation Amazon Linux 2 that uses their Corretto JDK optimized to
> run
> in AWS.
> Edit the Dockerfile as follows:\\
>
> Change the Maven image used for building JSPWiki to match the one for
> the OS. (Probably not need but done for consistancy)
> {{{
> # FROM maven:3.6-jdk-8 as package
> FROM maven:3.6-amazoncorretto-11 as package
> }}}
> Change the Tomcat base image
> {{{
> # FROM tomcat:9.0
> FROM tomcat:9.0-jdk11-corretto
> }}}
> Replace some Debian specifc lines with RedHat counterparts to add the
> unzip package.
> {{{
> # RUN set -x \
> # && export DEBIAN_FRONTEND=noninteractive \
> # && apt install --fix-missing --quiet --yes unzip
> RUN yum -y install \
> unzip
> }}}
> Add after the {{# install jspwiki}} section and before {{# make port
> visible in metadata}}
> {{{
> # remove unzip and cleanup
> RUN yum -y remove \
> unzip \
> && yum clean all
> }}}
> That's all.. Enjoy!
>
> ---- End
>
Re: Proposed Docker page rework
Posted by Juan Pablo Santos Rodríguez <ju...@gmail.com>.
Hi Carl,
the suggested rework looked good to me, so I've just went and posted it at
jspwiki-wiki.a.o; if needed, we can continue the rework later on.. I've
only added the
PageViewPlugin at the end, so that the page shows up at the SystemInfo one.
The changes can be seen at
https://jspwiki-wiki.apache.org/Diff.jsp?page=Docker&r1=22&r2=21
best regards & happy new year!!
juan pablo
On Mon, Dec 28, 2020 at 2:08 PM Carl Marcum <cm...@apache.org> wrote:
> Hi All,
>
> To avoid the spam filter for such a large change see below for the
> proposed page contents.
> The references to the previous image on Docker Hub will need replaced
> when you have the new one ready.
> I'd be happy to make the edit.
>
> The major changes are the that the image has changed a lot since the
> metskem/docker-jspwikiused on the current page so I described the new
> one somewhat.
>
> In addition to using the pre-built image I added how to build your own
> and added a example of how you can customize it based on CentOS or
> Amazon Linux and the Corretto JDK which I did for mine.
>
> In the persisting data section I added how to seed the volume directory
> with the default pages.
>
> If you would like to use it or have any changes please let me know.
>
> Best regards,
> Carl
>
> ---- Begin
>
> !!! JSPWiki for Docker
>
> JSPWiki can be used with [Docker|https://docs.docker.com]. Docker images
> can be built from source or you can use a pre-built official image.
>
> [{TableOfContents }]
>
>
> !! Default Image
>
> The default JSPWiki Docker image uses the official Docker Community
> supported [Apache Tomcat 9
> image|
> https://github.com/docker-library/tomcat/blob/b9416beec5364c00694595d6f3c61b09e764113c/9.0/jdk11/openjdk-buster/Dockerfile]
>
> which is based on the [OpenJDK
> 11|
> https://github.com/docker-library/openjdk/blob/20450f7a60b8db7aafd491a5ea55c6a3548138c6/11/jdk/buster/Dockerfile]
>
> built on Debian Buster.
>
> JSPWiki is built from source using [Apache
> Maven|http://maven.apache.org/] during the image build process.
>
> !! Prerequisites
>
> To use the pre-built image or build one from source you only need a
> [Docker Engine|https://docs.docker.com/engine/]. See the [installation
> instructions|http://docs.docker.com/installation/] on the docker site
> for details.
>
> !! Using the Pre-Built Image
> To download it locally from the [docker
> hub|https://registry.hub.docker.com/u/metskem/docker-jspwiki/].
> ! Get the Image
> {{{
> $ docker pull metskem/docker-jspwiki
> }}}
> ! Running the Container
> {{{
> $ docker run -d -p 8080:8080 --name jspwiki metskem/docker-jspwiki
> }}}
>
> This means :
> * __-d__ - detached mode, run the container in the background
> * __-p 8080:8080__ - bind the host port (8080) to the container port
> (8080). JSPWiki always runs on port 8080 inside the container.
> * __--name jspwiki__ - the new docker container will get the name
> ''jspwiki'' (instead of a generated container name)
> * __metskem/docker-jspwiki__ - the name of the image to run
>
> !! Building from Source
> ! Building the Image
> From the source root directory that contains the Dockerfile. The
> example uses a {{$version}} variable because the version is referred to
> multiple times. It is optional and can be replaced by any version number
> you would like to use. If you do not specify a version with the tag name
> it will default to 'latest'.
>
> Watch out for the space and period at the end which means the current
> directory.
> {{{
> $ version='2.11.0'
> $ docker build --tag="jspwiki:$version" .
> }}}
>
> ! Running the Container
> This is exactly like running the pre-built image except for the image
> {{name:version}} at the end.
> {{{
> $ docker run -d -p 8080:8080 --name jspwiki jspwiki:$version
> }}}
>
> !! Check the Results
>
> Just point your browser at [http://localhost:8080/], that should give
> you a working wiki right away !
>
> To see the list of running containers use {{docker ps}} or {{docker
> container ls}} and {{docker ps -a}} or {{docker container ls -a}} will
> show all containers running and stopped.
> {{{
> $ docker ps
> CONTAINER ID IMAGE COMMAND CREATED
> STATUS PORTS NAMES
> 5f0f5b0b5996 metskem/docker-jspwiki "/usr/local/tomcat/bi" 4
> minutes ago Up 4 minutes 0.0.0.0:8080->8080/tcp jspwiki
> }}}
>
> You can also execute commands inside the jspwiki container with the
> docker exec command and, for example, look at the last 5 lines in
> /var/jspwiki/logs/jspwiki.log :
> {{{
> $ docker exec -ti jspwiki tail -5 /var/jspwiki/logs/jspwiki.log
> 2016-03-28 09:34:35,070 [localhost-startStop-1] INFO
> org.apache.wiki.util.UtilJ2eeCompat - apache tomcat detected
> 2016-03-28 09:34:35,073 [localhost-startStop-1] INFO
> org.apache.wiki.ajax.WikiAjaxDispatcherServlet -
> WikiAjaxDispatcherServlet initialized.
> 2016-03-28 09:34:35,075 [localhost-startStop-1] INFO
> org.apache.wiki.WikiServlet - WikiServlet initialized.
> 2016-03-28 09:34:38,054 [http-nio-8080-exec-1] INFO
> org.apache.wiki.util.PropertyReader JSPWiki:/
> JSPWiki:http://localhost:8080/ - No jspwiki.custom.config defined for
> this context, looking for custom properties file with default name of:
> /jspwiki-custom.properties
> 2016-03-28 09:34:38,057 [http-nio-8080-exec-1] INFO
> org.apache.wiki.util.PropertyReader JSPWiki:/
> JSPWiki:http://localhost:8080/ - No custom property file found, relying
> on JSPWiki defaults.
> }}}
>
> !! Stopping and Starting the Container
>
> To stop the container, simply issue the {{docker stop}} or {{docker
> container stop}} command against the containerid (or container name if
> you gave it a name during first run).
>
> {{{
> $ docker ps
> CONTAINER ID IMAGE COMMAND CREATED
> STATUS PORTS NAMES
> 5f0f5b0b5996 metskem/docker-jspwiki "/usr/local/tomcat/bi" 6
> minutes ago Up 6 minutes 0.0.0.0:8080->8080/tcp jspwiki
> $ docker stop jspwiki
> jspwiki
> $ docker ps
> CONTAINER ID IMAGE COMMAND CREATED
> STATUS PORTS NAMES
> $ docker ps -a
> CONTAINER ID IMAGE COMMAND CREATED
> STATUS PORTS NAMES
> 5f0f5b0b5996 metskem/docker-jspwiki "/usr/local/tomcat/bi" 6
> minutes ago Exited (143) 4 seconds ago jspwiki
> }}}
>
> You can restart it with the {{docker start}} or {{docker container
> start}} command, you have to find the containerid with the {{docker ps
> -a}} command first , (or simply use the container name if you gave the
> container a name during first run):
> {{{
> $ docker start jspwiki
> jspwiki
> $ docker ps
> CONTAINER ID IMAGE COMMAND CREATED
> STATUS PORTS NAMES
> 5f0f5b0b5996 metskem/docker-jspwiki "/usr/local/tomcat/bi" 7
> minutes ago Up 5 seconds 0.0.0.0:8080->8080/tcp jspwiki
> }}}
>
> As you will notice, after a stop/start you still have the data (pages)
> that were created after the first container start. %%small (you can
> check easily with the Recent Changes page) %%
>
> !! Removing the Container
>
> If you want to get rid of the container (and all of the data in it !)
> you first should stop it, then you can remove it with the {{docker rm}}
> or {{docker container rm}} command %%small (or use docker rm -f to
> forcibly remove it right away)%%:
> {{{
> $ docker ps
> CONTAINER ID IMAGE COMMAND CREATED
> STATUS PORTS NAMES
> 5f0f5b0b5996 metskem/docker-jspwiki "/usr/local/tomcat/bi" 9
> minutes ago Up About a minute 0.0.0.0:8080->8080/tcp jspwiki
> $ docker stop jspwiki
> jspwiki
> $ docker ps -a
> CONTAINER ID IMAGE COMMAND CREATED
> STATUS PORTS NAMES
> 5f0f5b0b5996 metskem/docker-jspwiki "/usr/local/tomcat/bi" 9
> minutes ago Exited (143) 6 seconds ago jspwiki
> $ docker rm jspwiki
> jspwiki
> $ docker ps -a
> CONTAINER ID IMAGE COMMAND CREATED
> STATUS PORTS NAMES
>
> }}}
>
> Note that all your data is lost when you remove the container. (You can
> keep data apart using Docker Volumes, see next paragraph)
>
> !! Persisting Data
>
> If you use docker to run JSPWiki only for quick test purposes, you
> probably are not interested in keeping the data (created/changed pages,
> registered users, logfiles).\\
> But you can also run a JSPWiki docker container in production-like
> environments where you want to keep your data even after you removed a
> container. \\As an example you might sometimes want to run a newer
> version of your JSPWiki Docker container.
>
> ! Seeding the Volume Directory
> To begin with the default pages you can copy them from the source tree
> into a host OS directory used to persist the data.
> {{{
> $ cp ./jspwiki-wikipages/en/src/main/resources/*
> <path-to-your>/jspwiki-pages/
> }}}
> ! Running with a Volume
> To use the data outside of the container, you can use the {{--volume}}
> switch when you startup the container :
> {{{
> $ docker run -d -p 8080:8080 --env="jspwiki_baseURL=http://localhost/"
> --name jspwiki_8080
> --volume="<path-to-your>/jspwiki-pages:/var/jspwiki/pages"
> metskem/docker-jspwiki
> 240232ebb32e58dee7ad95471128210f71007bbeb11735ffd5394113959ace75
> }}}
>
> This way you will get your pages in a directory on the host OS in
> <path-to-your>/jspwiki-pages.\\
>
> !! Running Multiple Instances
>
> You can run multiple instances of the image of course. You only have to
> make sure they use different TCP ports.\\
> So for example starting 5 containers (with also a limit on memory usage
> added) :
> {{{
> $ for PORT in `seq 9080 9084`; do docker run -d -p ${PORT}:8080
> --memory=128m --env="jspwiki_baseURL=http://localhost:${PORT}/" --name
> jspwiki-${PORT} metskem/docker-jspwiki; done
> 68481eed8d609ac91711a78bd80505b398a8a37c9cc435e44eb0b2b7f881444b
> b3b967dc4fe721d5efce65959bfd5b4fa6061e053b3fd7b6d814bfc68a0a5261
> 6a23a3ac3df9aaf1a7f2dda96b6a535d58d06a429f458edaa4101ec89a6416e1
> b55b716ed49ff6ca6ba581794fe4ba5bde0439e10301f78acb62d5dec1118304
> 73d4cd8f29a072884a965ad3a86a5d090762fc046fe424c7b842b1c0b3a72122
> $ docker ps
> CONTAINER ID IMAGE COMMAND CREATED
> STATUS PORTS NAMES
> 73d4cd8f29a0 metskem/docker-jspwiki "/bin/sh -c '/usr/lo 4
> seconds ago Up 3 seconds 0.0.0.0:9084->8080/tcp jspwiki-9084
> b55b716ed49f metskem/docker-jspwiki "/bin/sh -c '/usr/lo 4
> seconds ago Up 3 seconds 0.0.0.0:9083->8080/tcp jspwiki-9083
> 6a23a3ac3df9 metskem/docker-jspwiki "/bin/sh -c '/usr/lo 4
> seconds ago Up 3 seconds 0.0.0.0:9082->8080/tcp jspwiki-9082
> b3b967dc4fe7 metskem/docker-jspwiki "/bin/sh -c '/usr/lo 5
> seconds ago Up 4 seconds 0.0.0.0:9081->8080/tcp jspwiki-9081
> 68481eed8d60 metskem/docker-jspwiki "/bin/sh -c '/usr/lo 5
> seconds ago Up 4 seconds 0.0.0.0:9080->8080/tcp jspwiki-9080
>
> }}}
>
> And you can easily get rid of them too :
> {{{
> $ docker stop `docker ps -aq`
> 73d4cd8f29a0
> b55b716ed49f
> 6a23a3ac3df9
> b3b967dc4fe7
> 68481eed8d60
> 240232ebb32e
> c8c73ddd9876
> $ docker rm `docker ps -aq`
> 73d4cd8f29a0
> b55b716ed49f
> 6a23a3ac3df9
> b3b967dc4fe7
> 68481eed8d60
> 240232ebb32e
> c8c73ddd9876
> $ docker ps -a
> CONTAINER ID IMAGE COMMAND CREATED
> STATUS PORTS NAMES
> }}}
>
> !! Customizing Your Image
> You can customize your build by making source code changes (not covered
> here) or change other things like the Tomcat base image version and
> platform OS and JDK version.
>
> __Example__: Change the platform OS from Debian to the CentOS based
> variation Amazon Linux 2 that uses their Corretto JDK optimized to run
> in AWS.
> Edit the Dockerfile as follows:\\
>
> Change the Maven image used for building JSPWiki to match the one for
> the OS. (Probably not need but done for consistancy)
> {{{
> # FROM maven:3.6-jdk-8 as package
> FROM maven:3.6-amazoncorretto-11 as package
> }}}
> Change the Tomcat base image
> {{{
> # FROM tomcat:9.0
> FROM tomcat:9.0-jdk11-corretto
> }}}
> Replace some Debian specifc lines with RedHat counterparts to add the
> unzip package.
> {{{
> # RUN set -x \
> # && export DEBIAN_FRONTEND=noninteractive \
> # && apt install --fix-missing --quiet --yes unzip
> RUN yum -y install \
> unzip
> }}}
> Add after the {{# install jspwiki}} section and before {{# make port
> visible in metadata}}
> {{{
> # remove unzip and cleanup
> RUN yum -y remove \
> unzip \
> && yum clean all
> }}}
> That's all.. Enjoy!
>
> ---- End
>