Remove CentOS Stream 8 & CentOS 7 for CI and documentation (#438)

* Updates are no longer available for CentOS Stream 8 since the end of May 2024 * Updates will cease being available for CentOS 7 at the end of June 2024
2025-08-05 18:51:43 +00:00 · 2024-06-04 16:10:38 -07:00
parent 1ad41653c7
commit 039a30eb62
26 changed files with 75 additions and 397 deletions
--- a/.github/actions/cmake/build/action.yml
+++ b/.github/actions/cmake/build/action.yml
@ -7,10 +7,10 @@ runs:
        cmake -B build -S . \
          -LA \
          -DCMAKE_BUILD_TYPE:STRING=${BUILD_TYPE:-Release} \
-          -DCMAKE_INSTALL_LOCALSTATEDIR=${INSTALL_LOCALSTATEDIR:-/var} \
+          -DCMAKE_INSTALL_LOCALSTATEDIR:PATH=${INSTALL_LOCALSTATEDIR:-/var} \
          -DCMAKE_INSTALL_PREFIX:PATH=${INSTALL_PREFIX:-/usr} \
-          -DCMAKE_INSTALL_RUNSTATEDIR=${INSTALL_RUNSTATEDIR:-/run} \
-          -DCMAKE_INSTALL_SYSCONFDIR=${INSTALL_SYSCONFDIR:-/etc} \
+          -DCMAKE_INSTALL_RUNSTATEDIR:PATH=${INSTALL_RUNSTATEDIR:-/run} \
+          -DCMAKE_INSTALL_SYSCONFDIR:PATH=${INSTALL_SYSCONFDIR:-/etc} \
          -DENABLE_TESTS:BOOL=ON
      shell: bash --noprofile --norc -euxo pipefail {0}

--- a/.github/actions/dependencies/install/yum/action.yml
+++ b/.github/actions/dependencies/install/yum/action.yml
@ -18,15 +18,10 @@ runs:
      shell: bash --noprofile --norc -euxo pipefail {0}
      if: startsWith(matrix.image, 'quay.io/centos/centos:stream')

-    - name: Enable PowerTools repository (CentOS Stream 8)
-      run: dnf config-manager --set-enabled powertools
-      shell: bash --noprofile --norc -euxo pipefail {0}
-      if: matrix.image == 'quay.io/centos/centos:stream8'
-
-    - name: Enable CRB repository (CentOS Stream 9)
+    - name: Enable CRB repository (CentOS Stream)
      run: dnf config-manager --set-enabled crb
      shell: bash --noprofile --norc -euxo pipefail {0}
-      if: matrix.image == 'quay.io/centos/centos:stream9'
+      if: startsWith(matrix.image, 'quay.io/centos/centos:stream')

    - name: Install dependency package(s)
      run: |
--- a/.github/workflows/build-and-test.yml
+++ b/.github/workflows/build-and-test.yml
@ -25,7 +25,6 @@ jobs:
          - "fedora:39"
          - "fedora:40"
          - "opensuse/leap:15"
-          - "quay.io/centos/centos:stream8"
          - "quay.io/centos/centos:stream9"
          - "ubuntu:22.04"
        on_default_branch:
--- a/.github/workflows/docker-image-build.yml
+++ b/.github/workflows/docker-image-build.yml
@ -17,8 +17,6 @@ jobs:
      matrix:
        service-name:
          - archlinux
-          - centos-7
-          - centos-stream-8
          - centos-stream-9
          - debian-11
          - debian-12
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@ -21,7 +21,7 @@ project(mod_tile

 set(CMAKE_C_STANDARD 99)
 set(CMAKE_C_STANDARD_REQUIRED ON)
-set(CMAKE_CXX_STANDARD 11)
+set(CMAKE_CXX_STANDARD 11 CACHE STRING "Sets the C++ standard.")
 set(CMAKE_CXX_STANDARD_REQUIRED ON)
 set(THREADS_PREFER_PTHREAD_FLAG ON)

--- a/README.rst
+++ b/README.rst
@ -66,7 +66,6 @@ We prepared instructions for you on how to build the software on the following
 distributions:

 * `Arch Linux </docs/build/building_on_arch_linux.md>`__
-* `CentOS </docs/build/building_on_centos.md>`__
 * `CentOS Stream </docs/build/building_on_centos_stream.md>`__
 * `Debian </docs/build/building_on_debian.md>`__
 * `Fedora </docs/build/building_on_fedora.md>`__
--- a/docker/README.md
+++ b/docker/README.md
@ -5,8 +5,6 @@ For your convenience, we have provided a Docker-based building and testing metho
 ### The following distributions are currently supported:

 - archlinux _(Arch Linux)_ [[Dockerfile](/docker/archlinux/Dockerfile)]
- centos-7 _(CentOS 7)_ [[Dockerfile](/docker/centos/7/Dockerfile)]
- centos-stream-8 _(CentOS Stream 8)_ [[Dockerfile](/docker/centos/stream/Dockerfile)]
 - centos-stream-9 _(CentOS Stream 9)_ [[Dockerfile](/docker/centos/stream/Dockerfile)]
 - debian-10 _(Debian 10)_ [[Dockerfile](/docker/debian/Dockerfile)]
 - debian-11 _(Debian 11)_ [[Dockerfile](/docker/debian/Dockerfile)]
--- a/docker/archlinux/Dockerfile
+++ b/docker/archlinux/Dockerfile
@ -32,10 +32,11 @@ WORKDIR /tmp/mod_tile_build
 RUN export CMAKE_BUILD_PARALLEL_LEVEL=$(nproc) && \
    cmake -B . -S /tmp/mod_tile_src \
        -DCMAKE_BUILD_TYPE:STRING=Release \
-        -DCMAKE_INSTALL_LOCALSTATEDIR=/var \
-        -DCMAKE_INSTALL_PREFIX=/usr \
-        -DCMAKE_INSTALL_RUNSTATEDIR=/run \
-        -DCMAKE_INSTALL_SYSCONFDIR=/etc \
+        -DCMAKE_CXX_STANDARD:STRING=17 \
+        -DCMAKE_INSTALL_LOCALSTATEDIR:PATH=/var \
+        -DCMAKE_INSTALL_PREFIX:PATH=/usr \
+        -DCMAKE_INSTALL_RUNSTATEDIR:PATH=/run \
+        -DCMAKE_INSTALL_SYSCONFDIR:PATH=/etc \
        -DENABLE_TESTS:BOOL=ON && \
    cmake --build .
 RUN export CTEST_PARALLEL_LEVEL=$(nproc) && \
--- a/docker/centos/7/Dockerfile
+++ b/docker/centos/7/Dockerfile
@ -1,178 +0,0 @@
-# Arguments
-ARG mapnik_version=3.1.0
-
-# Mapnik Builder
-FROM centos:centos7 as mapnik-builder
-
-## Arguments
-ARG mapnik_version
-
-## Install mapnik-builder dependencies
-RUN --mount=id=centos:centos7-/var/cache/yum,target=/var/cache/yum,type=cache,sharing=locked \
-    ulimit -n 40000; \
-    echo "install_weak_deps=0" >> /etc/yum.conf && \
-    sed --in-place 's/keepcache=0/keepcache=1/g' /etc/yum.conf && \
-    yum --assumeyes install epel-release centos-release-scl && \
-    yum --assumeyes upgrade && \
-    yum --assumeyes install \
-        boost169-devel \
-        bzip2 \
-        cairo-devel \
-        devtoolset-9-gcc \
-        devtoolset-9-gcc-c++ \
-        freetype-devel \
-        gdal-devel \
-        harfbuzz-devel \
-        libicu-devel \
-        libjpeg-devel \
-        libpng-devel \
-        libtiff-devel \
-        libwebp-devel \
-        libxml2-devel \
-        make \
-        patch \
-        postgresql-devel \
-        proj-devel \
-        python3 \
-        sqlite-devel \
-        tar \
-        zlib-devel
-
-## Download, Build & Install `Mapnik`
-WORKDIR /tmp/mapnik_src
-RUN --mount=id=centos:centos7-mapnik:${mapnik_version},target=/tmp/mapnik_src,type=cache \
-    export DESTDIR="/tmp/mapnik"; \
-    export GDAL_DATA="$(gdal-config --datadir)"; \
-    export JOBS="$(nproc)"; \
-    export PROJ_LIB="/usr/share/proj"; \
-    export PYTHON="python3"; \
-    mkdir --parents ${GDAL_DATA} ${PROJ_LIB}; \
-    if [ ! -f SConstruct ]; then \
-        curl --silent --location https://github.com/mapnik/mapnik/releases/download/v${mapnik_version}/mapnik-v${mapnik_version}.tar.bz2 \
-            | tar --extract --bzip2 --strip-components=1 --file=-; \
-        sed -i 's#BOOST_APPEND = match.groups()\[0\]#BOOST_APPEND = ""#g' SConstruct; \
-    fi; \
-    source /opt/rh/devtoolset-9/enable; \
-    export CUSTOM_DEFINES="-DACCEPT_USE_OF_DEPRECATED_PROJ_API_H=1"; \
-    export CUSTOM_LDFLAGS="-L/usr/lib64/boost169"; \
-    bash configure \
-        CPP_TESTS=False \
-        CUSTOM_CFLAGS="${CUSTOM_CFLAGS:-}" \
-        CUSTOM_CXXFLAGS="${CUSTOM_CXXFLAGS:-}" \
-        CUSTOM_DEFINES="${CUSTOM_DEFINES:-}" \
-        CUSTOM_LDFLAGS="${CUSTOM_LDFLAGS:-}" \
-        DEMO=False \
-        DESTDIR="${DESTDIR}" \
-        FAST=True \
-        INPUT_PLUGINS=all \
-        LIBDIR_SCHEMA=lib64 \
-        OPTIMIZATION=2 \
-        PREFIX=/usr \
-        SVG2PNG=True \
-        XMLPARSER=libxml2 && \
-    make PYTHON="${PYTHON}" && \
-    make install PYTHON="${PYTHON}"
-
-# Builder
-FROM centos:centos7 as builder
-
-## Install builder dependencies
-RUN --mount=id=centos:centos7-/var/cache/yum,target=/var/cache/yum,type=cache,sharing=locked \
-    ulimit -n 40000; \
-    echo "install_weak_deps=0" >> /etc/yum.conf && \
-    sed --in-place 's/keepcache=0/keepcache=1/g' /etc/yum.conf && \
-    yum --assumeyes install epel-release centos-release-scl && \
-    yum --assumeyes upgrade && \
-    yum --assumeyes install \
-        boost169-devel \
-        cairo-devel \
-        cmake3 \
-        devtoolset-9-gcc \
-        devtoolset-9-gcc-c++ \
-        gdal \
-        glib2-devel \
-        harfbuzz-devel \
-        httpd-devel \
-        iniparser-devel \
-        libcurl-devel \
-        libicu-devel \
-        libjpeg \
-        libmemcached-devel \
-        librados2-devel \
-        libtiff \
-        libwebp \
-        make \
-        proj
-
-## Copy files from builder(s)
-### Mapnik
-COPY --from=mapnik-builder /tmp/mapnik /
-
-## Build, Test & Install `mod_tile`
-COPY . /tmp/mod_tile_src
-WORKDIR /tmp/mod_tile_build
-RUN source /opt/rh/devtoolset-9/enable && \
-    export CMAKE_BUILD_PARALLEL_LEVEL=$(nproc) && \
-    export CFLAGS="-I/usr/include/boost169" && \
-    export CXXFLAGS="-I/usr/include/boost169" && \
-    cmake3 -B . -S /tmp/mod_tile_src \
-        -DCMAKE_BUILD_TYPE:STRING=Release \
-        -DCMAKE_INSTALL_LOCALSTATEDIR=/var \
-        -DCMAKE_INSTALL_PREFIX=/usr \
-        -DCMAKE_INSTALL_RUNSTATEDIR=/run \
-        -DCMAKE_INSTALL_SYSCONFDIR=/etc \
-        -DENABLE_TESTS:BOOL=ON && \
-    cmake3 --build .
-RUN export CTEST_PARALLEL_LEVEL=$(nproc) && \
-    export DESTDIR=/tmp/mod_tile && \
-    ctest3 --output-on-failure && \
-    (cmake3 --install . --strip || make DESTDIR=${DESTDIR} install/strip)
-
-# Runner
-FROM centos:centos7 as runner
-
-## Install runner dependencies
-RUN --mount=id=centos:centos7-/var/cache/yum,target=/var/cache/yum,type=cache,sharing=locked \
-    ulimit -n 40000; \
-    echo "install_weak_deps=0" >> /etc/yum.conf && \
-    sed --in-place 's/keepcache=0/keepcache=1/g' /etc/yum.conf && \
-    yum --assumeyes install epel-release && \
-    yum --assumeyes upgrade && \
-    yum --assumeyes install \
-        boost169-filesystem \
-        boost169-program-options \
-        boost169-regex \
-        cairo \
-        gdal \
-        harfbuzz \
-        httpd \
-        iniparser \
-        libicu \
-        libmemcached \
-        librados2 \
-        libtiff \
-        libwebp \
-        proj
-
-## Copy files from builder(s)
-### Mapnik
-COPY --from=mapnik-builder /tmp/mapnik /
-### mod_tile
-COPY --from=builder /tmp/mod_tile /
-COPY --chown=apache:apache --from=builder \
-    /tmp/mod_tile_src/utils/example-map \
-    /usr/share/renderd/example-map
-COPY --from=builder \
-    /tmp/mod_tile_src/etc/apache2/renderd-example-map.conf \
-    /etc/httpd/conf.d/renderd-example-map.conf
-
-## Add configuration
-RUN printf '\n[example-map]\nMAXZOOM=20\nMINZOOM=0\nURI=/tiles/renderd-example\nXML=/usr/share/renderd/example-map/mapnik.xml\n' >> /etc/renderd.conf
-RUN printf '\n[example-map-jpg]\nMAXZOOM=20\nMINZOOM=0\nTYPE=jpg image/jpeg jpeg\nURI=/tiles/renderd-example-jpg\nXML=/usr/share/renderd/example-map/mapnik.xml\n' >> /etc/renderd.conf
-RUN printf '\n[example-map-png256]\nMAXZOOM=20\nMINZOOM=0\nTYPE=png image/png png256\nURI=/tiles/renderd-example-png256\nXML=/usr/share/renderd/example-map/mapnik.xml\n' >> /etc/renderd.conf
-RUN printf '\n[example-map-png32]\nMAXZOOM=20\nMINZOOM=0\nTYPE=png image/png png32\nURI=/tiles/renderd-example-png32\nXML=/usr/share/renderd/example-map/mapnik.xml\n' >> /etc/renderd.conf
-RUN printf '\n[example-map-webp]\nMAXZOOM=20\nMINZOOM=0\nTYPE=webp image/webp webp\nURI=/tiles/renderd-example-webp\nXML=/usr/share/renderd/example-map/mapnik.xml\n' >> /etc/renderd.conf
-
-## Start services
-CMD httpd -e debug -k start; \
-    G_MESSAGES_DEBUG=${G_MESSAGES_DEBUG:-info} renderd --foreground
--- a/docker/centos/stream/Dockerfile
+++ b/docker/centos/stream/Dockerfile
@ -56,15 +56,10 @@ RUN --mount=id=centos:stream${centos_stream_version}-mapnik:${mapnik_version},ta
    if [ ! -f SConstruct ]; then \
        curl --silent --location https://github.com/mapnik/mapnik/releases/download/v${mapnik_version}/mapnik-v${mapnik_version}.tar.bz2 \
            | tar --extract --bzip2 --strip-components=1 --file=-; \
-        if [ "${centos_stream_version}" = "9" ]; then \
-            curl --silent --location https://github.com/mapnik/mapnik/commit/8944e81367d2b3b91a41e24116e1813c01491e5d.patch \
-                | patch -Np1; \
-            curl --silent --location https://github.com/mapnik/mapnik/commit/83779b7b6bdd229740b1b5e12a4a8fe27114cb7d.patch \
-                | patch -F3 -Np1; \
-        fi \
-    fi; \
-    if [ "${centos_stream_version}" = "8" ]; then \
-        export CUSTOM_DEFINES="-DACCEPT_USE_OF_DEPRECATED_PROJ_API_H=1"; \
+        curl --silent --location https://github.com/mapnik/mapnik/commit/8944e81367d2b3b91a41e24116e1813c01491e5d.patch \
+            | patch -Np1; \
+        curl --silent --location https://github.com/mapnik/mapnik/commit/83779b7b6bdd229740b1b5e12a4a8fe27114cb7d.patch \
+            | patch -F3 -Np1; \
    fi; \
    bash configure \
        CPP_TESTS=False \
@ -132,10 +127,10 @@ WORKDIR /tmp/mod_tile_build
 RUN export CMAKE_BUILD_PARALLEL_LEVEL=$(nproc) && \
    cmake -B . -S /tmp/mod_tile_src \
        -DCMAKE_BUILD_TYPE:STRING=Release \
-        -DCMAKE_INSTALL_LOCALSTATEDIR=/var \
-        -DCMAKE_INSTALL_PREFIX=/usr \
-        -DCMAKE_INSTALL_RUNSTATEDIR=/run \
-        -DCMAKE_INSTALL_SYSCONFDIR=/etc \
+        -DCMAKE_INSTALL_LOCALSTATEDIR:PATH=/var \
+        -DCMAKE_INSTALL_PREFIX:PATH=/usr \
+        -DCMAKE_INSTALL_RUNSTATEDIR:PATH=/run \
+        -DCMAKE_INSTALL_SYSCONFDIR:PATH=/etc \
        -DENABLE_TESTS:BOOL=ON && \
    cmake --build .
 RUN export CTEST_PARALLEL_LEVEL=$(nproc) && \
--- a/docker/centos/stream/Dockerfile.autotools
+++ b/docker/centos/stream/Dockerfile.autotools
@ -56,15 +56,10 @@ RUN --mount=id=centos:stream${centos_stream_version}-mapnik:${mapnik_version},ta
    if [ ! -f SConstruct ]; then \
        curl --silent --location https://github.com/mapnik/mapnik/releases/download/v${mapnik_version}/mapnik-v${mapnik_version}.tar.bz2 \
            | tar --extract --bzip2 --strip-components=1 --file=-; \
-        if [ "${centos_stream_version}" = "9" ]; then \
-            curl --silent --location https://github.com/mapnik/mapnik/commit/8944e81367d2b3b91a41e24116e1813c01491e5d.patch \
-                | patch -Np1; \
-            curl --silent --location https://github.com/mapnik/mapnik/commit/83779b7b6bdd229740b1b5e12a4a8fe27114cb7d.patch \
-                | patch -F3 -Np1; \
-        fi \
-    fi; \
-    if [ "${centos_stream_version}" = "8" ]; then \
-        export CUSTOM_DEFINES="-DACCEPT_USE_OF_DEPRECATED_PROJ_API_H=1"; \
+        curl --silent --location https://github.com/mapnik/mapnik/commit/8944e81367d2b3b91a41e24116e1813c01491e5d.patch \
+            | patch -Np1; \
+        curl --silent --location https://github.com/mapnik/mapnik/commit/83779b7b6bdd229740b1b5e12a4a8fe27114cb7d.patch \
+            | patch -F3 -Np1; \
    fi; \
    bash configure \
        CPP_TESTS=False \
--- a/docker/centos/stream/Dockerfile.mapnik-latest
+++ b/docker/centos/stream/Dockerfile.mapnik-latest
@ -117,10 +117,10 @@ RUN export CMAKE_BUILD_PARALLEL_LEVEL=$(nproc) && \
    cmake -B . -S /tmp/mod_tile_src \
        -DCMAKE_BUILD_TYPE:STRING=Release \
        -DCMAKE_CXX_STANDARD_INCLUDE_DIRECTORIES:PATH=/usr/include/boost1.78 \
-        -DCMAKE_INSTALL_LOCALSTATEDIR=/var \
-        -DCMAKE_INSTALL_PREFIX=/usr \
-        -DCMAKE_INSTALL_RUNSTATEDIR=/run \
-        -DCMAKE_INSTALL_SYSCONFDIR=/etc \
+        -DCMAKE_INSTALL_LOCALSTATEDIR:PATH=/var \
+        -DCMAKE_INSTALL_PREFIX:PATH=/usr \
+        -DCMAKE_INSTALL_RUNSTATEDIR:PATH=/run \
+        -DCMAKE_INSTALL_SYSCONFDIR:PATH=/etc \
        -DENABLE_TESTS:BOOL=ON && \
    cmake --build .
 RUN export CTEST_PARALLEL_LEVEL=$(nproc) && \
--- a/docker/debian/Dockerfile
+++ b/docker/debian/Dockerfile
@ -36,10 +36,10 @@ WORKDIR /tmp/mod_tile_build
 RUN export CMAKE_BUILD_PARALLEL_LEVEL=$(nproc) && \
    cmake -B . -S /tmp/mod_tile_src \
        -DCMAKE_BUILD_TYPE:STRING=Release \
-        -DCMAKE_INSTALL_LOCALSTATEDIR=/var \
-        -DCMAKE_INSTALL_PREFIX=/usr \
-        -DCMAKE_INSTALL_RUNSTATEDIR=/run \
-        -DCMAKE_INSTALL_SYSCONFDIR=/etc \
+        -DCMAKE_INSTALL_LOCALSTATEDIR:PATH=/var \
+        -DCMAKE_INSTALL_PREFIX:PATH=/usr \
+        -DCMAKE_INSTALL_RUNSTATEDIR:PATH=/run \
+        -DCMAKE_INSTALL_SYSCONFDIR:PATH=/etc \
        -DENABLE_TESTS:BOOL=ON && \
    cmake --build .
 RUN export CTEST_PARALLEL_LEVEL=$(nproc) && \
--- a/docker/docker-compose.yml
+++ b/docker/docker-compose.yml
@ -54,28 +54,6 @@ services:
      - styles:/opt/styles
      - tiles:/var/cache/renderd/tiles
      - ./full-entrypoint.sh:/entrypoint.sh:ro
-  centos-7:
-    <<: *service_defaults
-    build:
-      <<: *build_defaults
-      dockerfile: docker/centos/7/Dockerfile
-    ulimits:
-      nofile: 40000
-  centos-stream-8:
-    <<: *service_defaults
-    build:
-      <<: *build_defaults_centos_stream
-      args:
-        centos_stream_version: "8"
-        extra_repository: powertools
-  centos-stream-8-autotools:
-    <<: *service_defaults
-    build:
-      <<: *build_defaults_centos_stream
-      args:
-        centos_stream_version: "8"
-        extra_repository: powertools
-      dockerfile: docker/centos/stream/Dockerfile.autotools
  centos-stream-9:
    <<: *service_defaults
    build:
--- a/docker/fedora/Dockerfile
+++ b/docker/fedora/Dockerfile
@ -31,10 +31,10 @@ WORKDIR /tmp/mod_tile_build
 RUN export CMAKE_BUILD_PARALLEL_LEVEL=$(nproc) && \
    cmake -B . -S /tmp/mod_tile_src \
        -DCMAKE_BUILD_TYPE:STRING=Release \
-        -DCMAKE_INSTALL_LOCALSTATEDIR=/var \
-        -DCMAKE_INSTALL_PREFIX=/usr \
-        -DCMAKE_INSTALL_RUNSTATEDIR=/run \
-        -DCMAKE_INSTALL_SYSCONFDIR=/etc \
+        -DCMAKE_INSTALL_LOCALSTATEDIR:PATH=/var \
+        -DCMAKE_INSTALL_PREFIX:PATH=/usr \
+        -DCMAKE_INSTALL_RUNSTATEDIR:PATH=/run \
+        -DCMAKE_INSTALL_SYSCONFDIR:PATH=/etc \
        -DENABLE_TESTS:BOOL=ON && \
    cmake --build .
 RUN export CTEST_PARALLEL_LEVEL=$(nproc) && \
--- a/docker/opensuse/Dockerfile
+++ b/docker/opensuse/Dockerfile
@ -124,10 +124,10 @@ WORKDIR /tmp/mod_tile_build
 RUN export CMAKE_BUILD_PARALLEL_LEVEL=$(nproc) && \
    cmake -B . -S /tmp/mod_tile_src \
        -DCMAKE_BUILD_TYPE:STRING=Release \
-        -DCMAKE_INSTALL_LOCALSTATEDIR=/var \
-        -DCMAKE_INSTALL_PREFIX=/usr \
-        -DCMAKE_INSTALL_RUNSTATEDIR=/run \
-        -DCMAKE_INSTALL_SYSCONFDIR=/etc \
+        -DCMAKE_INSTALL_LOCALSTATEDIR:PATH=/var \
+        -DCMAKE_INSTALL_PREFIX:PATH=/usr \
+        -DCMAKE_INSTALL_RUNSTATEDIR:PATH=/run \
+        -DCMAKE_INSTALL_SYSCONFDIR:PATH=/etc \
        -DENABLE_TESTS:BOOL=ON && \
    cmake --build .
 RUN export CTEST_PARALLEL_LEVEL=$(nproc) && \
--- a/docker/ubuntu/Dockerfile
+++ b/docker/ubuntu/Dockerfile
@ -37,10 +37,10 @@ WORKDIR /tmp/mod_tile_build
 RUN export CMAKE_BUILD_PARALLEL_LEVEL=$(nproc) && \
    cmake -B . -S /tmp/mod_tile_src \
        -DCMAKE_BUILD_TYPE:STRING=Release \
-        -DCMAKE_INSTALL_LOCALSTATEDIR=/var \
-        -DCMAKE_INSTALL_PREFIX=/usr \
-        -DCMAKE_INSTALL_RUNSTATEDIR=/run \
-        -DCMAKE_INSTALL_SYSCONFDIR=/etc \
+        -DCMAKE_INSTALL_LOCALSTATEDIR:PATH=/var \
+        -DCMAKE_INSTALL_PREFIX:PATH=/usr \
+        -DCMAKE_INSTALL_RUNSTATEDIR:PATH=/run \
+        -DCMAKE_INSTALL_SYSCONFDIR:PATH=/etc \
        -DENABLE_TESTS:BOOL=ON && \
    cmake --build .
 RUN export CTEST_PARALLEL_LEVEL=$(nproc) && \
--- a/docs/build/building_on_arch_linux.md
+++ b/docs/build/building_on_arch_linux.md
@ -41,10 +41,10 @@ git clone --depth 1 https://github.com/openstreetmap/mod_tile.git .
 cd /tmp/mod_tile_build
 cmake -B . -S /tmp/mod_tile_src \
  -DCMAKE_BUILD_TYPE:STRING=Release \
-  -DCMAKE_INSTALL_LOCALSTATEDIR=/var \
-  -DCMAKE_INSTALL_PREFIX=/usr \
-  -DCMAKE_INSTALL_RUNSTATEDIR=/run \
-  -DCMAKE_INSTALL_SYSCONFDIR=/etc \
+  -DCMAKE_INSTALL_LOCALSTATEDIR:PATH=/var \
+  -DCMAKE_INSTALL_PREFIX:PATH=/usr \
+  -DCMAKE_INSTALL_RUNSTATEDIR:PATH=/run \
+  -DCMAKE_INSTALL_SYSCONFDIR:PATH=/etc \
  -DENABLE_TESTS:BOOL=ON
 cmake --build .
 ctest
--- a/docs/build/building_on_centos.md
+++ b/docs/build/building_on_centos.md
@ -1,86 +0,0 @@
-# Building on CentOS
-
-This document provides users with step-by-step instructions on how to compile and use`mod_tile` and `renderd`.
-
-Please see our [Continuous Integration script](/.github/workflows/build-and-test.yml) for more details.
-
-A Docker-based building & testing setup pipeline is also available [here](/docker) for your convenience.
-
-_CentOS does not provide a `mapnik`/`mapnik-devel` package, so it will first need to be built & installed, which is beyond the scope of this document, please visit the project's [installation document on GitHub](https://github.com/mapnik/mapnik/blob/master/INSTALL.md) or our [Continuous Integration script](/.github/actions/dependencies/build-and-install/mapnik/action.yml) for more information._
-
-## CentOS 7
-
-```shell
-#!/usr/bin/env bash
-
-# Update installed packages
-sudo yum --assumeyes update
-
-# Install build dependencies
-# (libmemcached-devel & librados2-devel are optional)
-sudo yum --assumeyes install epel-release centos-release-scl
-sudo yum --assumeyes --setopt=install_weak_deps=False install \
-  boost169-devel \
-  cairo-devel \
-  cmake3 \
-  devtoolset-9-gcc \
-  devtoolset-9-gcc-c++ \
-  gcc \
-  gcc-c++ \
-  gdal \
-  git \
-  glib2-devel \
-  harfbuzz-devel \
-  httpd-devel \
-  iniparser-devel \
-  libcurl-devel \
-  libicu-devel \
-  libjpeg \
-  libmemcached-devel \
-  librados2-devel \
-  libtiff \
-  libwebp \
-  make \
-  proj
-
-# Download, Build, Test & Install `mod_tile`
-source /opt/rh/devtoolset-9/enable
-export CFLAGS="-I/usr/include/boost169"
-export CMAKE_BUILD_PARALLEL_LEVEL=$(nproc)
-export CXXFLAGS="-I/usr/include/boost169"
-rm -rf /tmp/mod_tile_src /tmp/mod_tile_build
-mkdir /tmp/mod_tile_src /tmp/mod_tile_build
-cd /tmp/mod_tile_src
-git clone --depth 1 https://github.com/openstreetmap/mod_tile.git .
-cd /tmp/mod_tile_build
-cmake3 -B . -S /tmp/mod_tile_src \
-  -DCMAKE_BUILD_TYPE:STRING=Release \
-  -DCMAKE_INSTALL_LOCALSTATEDIR=/var \
-  -DCMAKE_INSTALL_PREFIX=/usr \
-  -DCMAKE_INSTALL_RUNSTATEDIR=/run \
-  -DCMAKE_INSTALL_SYSCONFDIR=/etc \
-  -DENABLE_TESTS:BOOL=ON
-cmake3 --build .
-ctest3
-sudo cmake --install . --strip
-
-# Create /usr/share/renderd directory
-sudo mkdir --parents /usr/share/renderd
-
-# Copy files of example map
-sudo cp -av /tmp/mod_tile_src/utils/example-map /usr/share/renderd/example-map
-
-# Add configuration
-sudo cp -av /tmp/mod_tile_src/etc/apache2/renderd-example-map.conf /etc/httpd/conf.d/renderd-example-map.conf
-printf '\n[example-map]\nURI=/tiles/renderd-example\nXML=/usr/share/renderd/example-map/mapnik.xml\n' | sudo tee -a /etc/renderd.conf
-printf '\n[example-map-jpg]\nTYPE=jpg image/jpeg jpeg\nURI=/tiles/renderd-example-jpg\nXML=/usr/share/renderd/example-map/mapnik.xml\n' | sudo tee -a /etc/renderd.conf
-printf '\n[example-map-png256]\nTYPE=png image/png png256\nURI=/tiles/renderd-example-png256\nXML=/usr/share/renderd/example-map/mapnik.xml\n' | sudo tee -a /etc/renderd.conf
-printf '\n[example-map-png32]\nTYPE=png image/png png32\nURI=/tiles/renderd-example-png32\nXML=/usr/share/renderd/example-map/mapnik.xml\n' | sudo tee -a /etc/renderd.conf
-printf '\n[example-map-webp]\nTYPE=webp image/webp webp\nURI=/tiles/renderd-example-webp\nXML=/usr/share/renderd/example-map/mapnik.xml\n' | sudo tee -a /etc/renderd.conf
-
-# Start services
-sudo httpd
-sudo renderd -f
-```
-
-Then you can visit: `http://localhost:8081/renderd-example-map`
--- a/docs/build/building_on_centos_stream.md
+++ b/docs/build/building_on_centos_stream.md
@ -8,18 +8,6 @@ A Docker-based building & testing setup pipeline is also available [here](/docke

 _CentOS Stream does not provide a `mapnik`/`mapnik-devel` package, so it will first need to be built & installed, which is beyond the scope of this document, please visit the project's [installation document on GitHub](https://github.com/mapnik/mapnik/blob/master/INSTALL.md) or our [Continuous Integration script](/.github/actions/dependencies/build-and-install/mapnik/action.yml) for more information._

-## CentOS Stream 8
-
-```shell
-#!/usr/bin/env bash
-
-# Update config-manager DNF plugin
-sudo dnf --assumeyes install "dnf-command(config-manager)"
-
-# Enable PowerTools Repository
-sudo dnf config-manager --save --setopt=powertools.enabled=1
-```
-
 ## CentOS Stream 9

 ```shell
@ -30,11 +18,7 @@ sudo dnf --assumeyes install "dnf-command(config-manager)"

 # Enable CRB Repository
 sudo dnf config-manager --save --setopt=crb.enabled=1
-```

-## CentOS Stream 8/9
-
-```shell
 #!/usr/bin/env bash

 # Update installed packages
@ -74,10 +58,10 @@ git clone --depth 1 https://github.com/openstreetmap/mod_tile.git .
 cd /tmp/mod_tile_build
 cmake -B . -S /tmp/mod_tile_src \
  -DCMAKE_BUILD_TYPE:STRING=Release \
-  -DCMAKE_INSTALL_LOCALSTATEDIR=/var \
-  -DCMAKE_INSTALL_PREFIX=/usr \
-  -DCMAKE_INSTALL_RUNSTATEDIR=/run \
-  -DCMAKE_INSTALL_SYSCONFDIR=/etc \
+  -DCMAKE_INSTALL_LOCALSTATEDIR:PATH=/var \
+  -DCMAKE_INSTALL_PREFIX:PATH=/usr \
+  -DCMAKE_INSTALL_RUNSTATEDIR:PATH=/run \
+  -DCMAKE_INSTALL_SYSCONFDIR:PATH=/etc \
  -DENABLE_TESTS:BOOL=ON
 cmake --build .
 ctest
--- a/docs/build/building_on_debian.md
+++ b/docs/build/building_on_debian.md
@ -42,10 +42,10 @@ git clone --depth 1 https://github.com/openstreetmap/mod_tile.git .
 cd /tmp/mod_tile_build
 cmake -B . -S /tmp/mod_tile_src \
  -DCMAKE_BUILD_TYPE:STRING=Release \
-  -DCMAKE_INSTALL_LOCALSTATEDIR=/var \
-  -DCMAKE_INSTALL_PREFIX=/usr \
-  -DCMAKE_INSTALL_RUNSTATEDIR=/run \
-  -DCMAKE_INSTALL_SYSCONFDIR=/etc \
+  -DCMAKE_INSTALL_LOCALSTATEDIR:PATH=/var \
+  -DCMAKE_INSTALL_PREFIX:PATH=/usr \
+  -DCMAKE_INSTALL_RUNSTATEDIR:PATH=/run \
+  -DCMAKE_INSTALL_SYSCONFDIR:PATH=/etc \
  -DENABLE_TESTS:BOOL=ON
 cmake --build .
 ctest
--- a/docs/build/building_on_fedora.md
+++ b/docs/build/building_on_fedora.md
@ -39,10 +39,10 @@ git clone --depth 1 https://github.com/openstreetmap/mod_tile.git .
 cd /tmp/mod_tile_build
 cmake -B . -S /tmp/mod_tile_src \
  -DCMAKE_BUILD_TYPE:STRING=Release \
-  -DCMAKE_INSTALL_LOCALSTATEDIR=/var \
-  -DCMAKE_INSTALL_PREFIX=/usr \
-  -DCMAKE_INSTALL_RUNSTATEDIR=/run \
-  -DCMAKE_INSTALL_SYSCONFDIR=/etc \
+  -DCMAKE_INSTALL_LOCALSTATEDIR:PATH=/var \
+  -DCMAKE_INSTALL_PREFIX:PATH=/usr \
+  -DCMAKE_INSTALL_RUNSTATEDIR:PATH=/run \
+  -DCMAKE_INSTALL_SYSCONFDIR:PATH=/etc \
  -DENABLE_TESTS:BOOL=ON
 cmake --build .
 ctest
--- a/docs/build/building_on_freebsd.md
+++ b/docs/build/building_on_freebsd.md
@ -44,10 +44,10 @@ git clone --depth 1 https://github.com/openstreetmap/mod_tile.git .
 cd /tmp/mod_tile_build
 cmake -B . -S /tmp/mod_tile_src \
  -DCMAKE_BUILD_TYPE:STRING=Release \
-  -DCMAKE_INSTALL_LOCALSTATEDIR=/var \
-  -DCMAKE_INSTALL_PREFIX=/usr/local \
-  -DCMAKE_INSTALL_RUNSTATEDIR=/run \
-  -DCMAKE_INSTALL_SYSCONFDIR=/etc \
+  -DCMAKE_INSTALL_LOCALSTATEDIR:PATH=/var \
+  -DCMAKE_INSTALL_PREFIX:PATH=/usr/local \
+  -DCMAKE_INSTALL_RUNSTATEDIR:PATH=/run \
+  -DCMAKE_INSTALL_SYSCONFDIR:PATH=/etc \
  -DENABLE_TESTS:BOOL=ON
 cmake --build .
 ctest
--- a/docs/build/building_on_macos.md
+++ b/docs/build/building_on_macos.md
@ -40,10 +40,10 @@ git clone --depth 1 https://github.com/openstreetmap/mod_tile.git .
 cd /tmp/mod_tile_build
 cmake -B . -S /tmp/mod_tile_src \
  -DCMAKE_BUILD_TYPE:STRING=Release \
-  -DCMAKE_INSTALL_LOCALSTATEDIR=/var \
-  -DCMAKE_INSTALL_PREFIX=/usr/local \
-  -DCMAKE_INSTALL_RUNSTATEDIR=/var/run \
-  -DCMAKE_INSTALL_SYSCONFDIR=/etc \
+  -DCMAKE_INSTALL_LOCALSTATEDIR:PATH=/var \
+  -DCMAKE_INSTALL_PREFIX:PATH=/usr/local \
+  -DCMAKE_INSTALL_RUNSTATEDIR:PATH=/var/run \
+  -DCMAKE_INSTALL_SYSCONFDIR:PATH=/etc \
  -DENABLE_TESTS:BOOL=ON
 cmake --build .
 ctest
--- a/docs/build/building_on_opensuse.md
+++ b/docs/build/building_on_opensuse.md
@ -58,10 +58,10 @@ git clone --depth 1 https://github.com/openstreetmap/mod_tile.git .
 cd /tmp/mod_tile_build
 cmake -B . -S /tmp/mod_tile_src \
  -DCMAKE_BUILD_TYPE:STRING=Release \
-  -DCMAKE_INSTALL_LOCALSTATEDIR=/var \
-  -DCMAKE_INSTALL_PREFIX=/usr \
-  -DCMAKE_INSTALL_RUNSTATEDIR=/run \
-  -DCMAKE_INSTALL_SYSCONFDIR=/etc \
+  -DCMAKE_INSTALL_LOCALSTATEDIR:PATH=/var \
+  -DCMAKE_INSTALL_PREFIX:PATH=/usr \
+  -DCMAKE_INSTALL_RUNSTATEDIR:PATH=/run \
+  -DCMAKE_INSTALL_SYSCONFDIR:PATH=/etc \
  -DENABLE_TESTS:BOOL=ON
 cmake --build .
 ctest
--- a/docs/build/building_on_ubuntu.md
+++ b/docs/build/building_on_ubuntu.md
@ -42,10 +42,10 @@ git clone --depth 1 https://github.com/openstreetmap/mod_tile.git .
 cd /tmp/mod_tile_build
 cmake -B . -S /tmp/mod_tile_src \
  -DCMAKE_BUILD_TYPE:STRING=Release \
-  -DCMAKE_INSTALL_LOCALSTATEDIR=/var \
-  -DCMAKE_INSTALL_PREFIX=/usr \
-  -DCMAKE_INSTALL_RUNSTATEDIR=/run \
-  -DCMAKE_INSTALL_SYSCONFDIR=/etc \
+  -DCMAKE_INSTALL_LOCALSTATEDIR:PATH=/var \
+  -DCMAKE_INSTALL_PREFIX:PATH=/usr \
+  -DCMAKE_INSTALL_RUNSTATEDIR:PATH=/run \
+  -DCMAKE_INSTALL_SYSCONFDIR:PATH=/etc \
  -DENABLE_TESTS:BOOL=ON
 cmake --build .
 ctest