How to run MapTiler Server in Kubernetes

This article provides instructions on how to run MapTiler Server using Kubernetes.

Requirements

• Running Kubernetes cluster with at least 1 node.
• Running Ingress controller.
• (Optional) Persistent Volume type supporting ReadWriteMany access mode to be able to share tileset data and configuration in multi-instance deployments.

Usage

Helm must be installed to use the chart. Please refer to Helm's documentation to get started.

Installing the Chart

To install the chart with the release name maptiler-server-app:

helm repo add maptiler https://labs.maptiler.com/maptiler-server-kubernetes/
helm install maptiler-server-app maptiler/maptiler-server

The command deploys MapTiler Server on the Kubernetes cluster in the default configuration.

Uninstalling the Chart

To uninstall the maptiler-server-app deployment:

helm uninstall maptiler-server-app

Complete chart documentation is available at ArtifactHub.io.

Sample configurations

NGINX Ingress Controller

Sample NGINX Ingress controller configuration in values.yaml.
In order to use TLS in this scenario, a Kubernetes TLS Secret maptiler-server-tls with public/private key pair must exist.

To specify a custom max request body size for NGINX, a nginx.ingress.kubernetes.io/proxy-body-size annotation must be defined.

ingress:
  enabled: true
  className: nginx
  annotations:
    nginx.ingress.kubernetes.io/proxy-body-size: 300m
  hosts:
    - host: maps.company.com
      paths:
        - path: /
          pathType: Prefix
  tls:
    - secretName: maptiler-server-tls
      hosts:
        - maps.company.com

Persistence

To be able to run in multiple replicas which share tileset data and configuration, each replica of MapTiler Server must be able to access the same Persistent Volume. You can either configure the Persistent Volume Claim to use a Storage Class which supports ReadWriteMany access mode or setup an NFS storage.

storage:
  storageClassName: csi-cinder-classic
  size: 20Gi

volumes:
  - name: maptiler-server-data
    persistentVolumeClaim:
      claimName: maptiler-server-app

volumeMounts:
  - mountPath: /data/
    name: maptiler-server-data