PCIC's custom tileserver image which is used to serve maps tiles to our applications.
The tileserver is built using the Apache Webserver (from repo) and mod_tile. The tiles have been pre-rendered and are stored on shared storage which can be mounted into the container. We have not enabled renderd in the container since we want to serve tiles, not render them at this point.
Some of the configuration items you'll need to provide are:
Provide configuration files for Apache to:
- Load the
mod_tilesmodule - Serve the tiles
- Listen on the correct port
- Setup logging
Mapnik files are not included in the image or with docker-compose since they're not needed to serve pre-rendered tiles, though they are referenced in the docker-compose (commented out).
The renderd configuration is used by mod_tiles to determine where to serve tiles from.
The tilestore directory provides the tiles that will be served
A basic run.sh script is included in the image, but a customized one may be required for logging or other settings.
- The
run.shscript links theaccess.loganderror.logfiles tostdoutandstderrprior to starting apache
Some sample files can be included in the webroot that allow you to view tiles for diagnostic purposes.
Creating a versioned release involves:
- Summarize the changes from the last release in
NEWS.md - Commit these changes, then tag the release:
git add NEWS.md
git commit -m"Bump to version x.x.x_xx"
git tag -a -m"x.x.x_xx" x.x.x_xx
git push --follow-tags