[Tile-serving] [openstreetmap/mod_tile] Added compilation instructions for several distros (#252)

[David Hummel]

@hummeltech approved this pull request.

Yeah, I think this looks good, just a few notes. Also a reminder to make sure the `debian` packaging code takes the change from `docs` to `docs/man` into account.

> @@ -0,0 +1,28 @@
+---

This file is no longer necessary.

> @@ -0,0 +1,93 @@
+---

You can replace this file with the version in #253.

> @@ -1,12 +1,13 @@
 ---
-name: Build & Test (Ubuntu Latest)
+name: Build & Test (Ubuntu 20.04)

Good idea, I was thinking this would need to be done eventually.

> @@ -0,0 +1,123 @@
+# Building on CentOS 7
+
+This documents step by step on how to compile and put into use the software `mod_tile` and `renderd`.
+Please see our [Continous Integration script](../.github/workflows/build-and-test-centos-7.yml) for more detail.
+
+As `CentOS 7` does not provide `mapnik`/`mapnik-devel` in the official repository (nor is it available from EPEL,) it must therefore be built and installed before `mod_tile` can be built. Although `boost` is not required (since `boost-devel` exists in the official repository,) the version available there (`1.53.0`) is not in the [recommended dependency list](https://github.com/mapnik/mapnik/blob/master/INSTALL.md#depends). There is a version of `boost` available from EPEL that might work though (`boost169-devel`.)

You can replace lines @ `6-77` in this file with the contents of the version in #253.

> @@ -0,0 +1,81 @@
+# Building on Fedora 34
+
+This documents step by step on how to compile and put into use the software `mod_tile` and `renderd`.
+Please see our [Continous Integration script](../.github/workflows/build-and-test-fedora-34.yml) for more detail.
+
+```shell
+#!/usr/bin/env bash
+
+# Update installed packages
+yum --assumeyes update

Note that `sudo` will likely be required for most of the commands in this document (also in the document for `CentOS`). It is not currently used/needed since the default user from the relevant `Docker` images is `root`.

> @@ -0,0 +1,62 @@
+# Building on Ubuntu 20.04
+
+This documents step by step on how to compile and put into use the software `mod_tile` and `renderd`.
+Please see our [Continous Integration script](../.github/workflows/build-and-test-ubuntu-20-04.yml) for more detail.
+
+```shell
+#!/usr/bin/env bash
+
+# Update installed packages
+sudo apt update && apt upgrade --yes

Should this also be applied in `.github/actions/apt/update/action.yml`? I forgot about the `command` differences between `yum` and `apt` for updating packages.

-- 
You are receiving this because you are subscribed to this thread.
Reply to this email directly or view it on GitHub:
https://github.com/openstreetmap/mod_tile/pull/252#pullrequestreview-720503596
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstreetmap.org/pipermail/tile-serving/attachments/20210802/0778c1f6/attachment.htm>