docker-mapfish-print2

Docker image and tools for MapFish Print (MFP) VERSION 2 legacy.

This version is still used in quite some contexts.

Find the MapFish Print v2 docs here.
Find Docker Images on DockerHub.
See my repo docker-mapfish-print for a MFP version 3+ Docker Image.

If you read this on DockerHub, local links will not work, read full README here.

Log4J Security fix

Read more here. Bottom line: this project does not use Log4J2 (but v1)!

Building

With the script build.sh the Docker image can be build from the Dockerfile but this is not really necessary as you may use your own docker build commandline.

Build arguments with values if not passed to build:

IMAGE_TIMEZONE - timezone of Docker image, default "Europe/Amsterdam"
IMAGE_LOCALE - locale of Docker image, default "nl_NL.UTF-8"
MFPRINT_VERSION - MapFish Print (Servlet) version, default "2.1-SNAPSHOT"

Versions

I found that 2.1-SNAPSHOT was the highest MFP2 version that worked (for me). These come from https://oss.sonatype.org/content/repositories/snapshots/org/mapfish/print/print-servlet/. If you are able to get a higher version working, let me know, via the issue-tracker.

Build Options

The files under the config dir are automatically integrated in the Docker image as follows:

config/tomcat/*: override any files in the standard Tomcat install (see below)
config/tomcat/bin/setenv.sh: Tomcat options like for memory, proxies etc
config/tomcat/conf/server.xml: server settings like port (default 8080) and threads
config/webapp/WEB-INF/web.xml: override web.xml for Tomcat MFP .war
config/webapp/config/index.html: the demo page, provide your own if required

You can adapt these or use a prebuilt Docker Image and use Volume mapping or extend the image.

Running

See the examples directory for how to run with your own config. The main things to do are:

create Print config YAML file(s) see examples and the MFP v2 docs
configure each config YAML within web.xml at bottom, use config/webapp/WEB-INF/web.xml as starter

Example:

    <!-- Example how to configure for your YAML config(s) -->
    <servlet>
        <servlet-name>mapfish.print.default</servlet-name>
        <servlet-class>org.mapfish.print.servlet.MapPrinterServlet</servlet-class>
        <init-param>
            <param-name>config</param-name>
            <param-value>config/config.default.yaml</param-value>
        </init-param>
    </servlet>
    <servlet-mapping>
        <servlet-name>mapfish.print.default</servlet-name>
        <url-pattern>/pdf.default/*</url-pattern>
    </servlet-mapping>

mount these files into the container using Docker Volume mount (or extend the Docker build)
optional: provide HTML test-pages, see examples

Credits

Kartoza team: https://github.com/kartoza for providing good examples of Dockerfiles for FOSS geospatial Java .war's.
TT Fonts addition: https://github.com/panosoft/docker-prince-server/blob/master/Dockerfile
CampToCamp for developing MapFish Print and many other useful FOSS Geospatial software

justb4 / docker-mapfish-print2