Lighttpd: Add socket support and documentation

Dockerfile

@@ -137,6 +137,7 @@ ENV MS_DEBUGLEVEL=0 \
     LIGHTTPD_PORT=8080 \
     LIGHTTPD_FASTCGI_HOST=spawn-fcgi \
     LIGHTTPD_FASTCGI_PORT=3000 \
+    LIGHTTPD_FASTCGI_SOCKET='' \
     LIGHTTPD_ACCESSLOG_FORMAT="%h %V %u %t \"%r\" %>s %b"
 
 CMD ["/usr/local/bin/start-server"]

README.md

@@ -9,7 +9,7 @@ Only tags for minor releases exist, not tag for bug fixes.
 If the container is run as root, apache listens on port `80`. If it is run as
 another user, it listens on port `8080`.
 
-## Tunings
+## Apache Tunings
 
 You can use the following environment variables (when starting the container)
 to tune it:
@@ -29,6 +29,27 @@ to tune it:
 - `APACHE_LIMIT_REQUEST_LINE`: The maximum size of the HTTP request line in
   bytes (defaults to `8190`)
 
+## Lighttpd
+
+You can also use lighttpd as the web server.
+
+The main benefit of that is to have only one running process per container, that's useful especially on Kubernetes.
+
+For that you need tow containers, one for the MapServer and `spawn-fcgi`, and one for `lighttpd`.
+
+The environment variable needed by mapserver should be on the `spawn-fcgi` container.
+
+The MapServer logs will be available on the 'lighttpd' container.
+
+Used environment variables:
+
+- `LIGHTTPD_CONF`: The lighttpd configuration file (defaults to `/etc/lighttpd/lighttpd.conf`)
+- `LIGHTTPD_PORT`: The port lighttpd will listen on (defaults to `8080`)
+- `LIGHTTPD_FASTCGI_HOST`: The host of the FastCGI server (`spawn-fcgi`, defaults to `spawn-fcgi`)
+- `LIGHTTPD_FASTCGI_PORT`: The port of the FastCGI server (`spawn-fcgi`, defaults to `3000`)
+- `LIGHTTPD_FASTCGI_SOCKET`: The socket of the FastCGI server (defaults to `''`)
+- `LIGHTTPD_ACCESSLOG_FORMAT`: The format of the access log (defaults to `"%h %V %u %t \"%r\" %>s %b"`)
+
 ## Running multiple Mapfiles
 
 This section is for if you would like to use more than one Mapfile, or use a Mapfile

runtime/etc/lighttpd/lighttpd.conf

@@ -7,12 +7,23 @@ server.errorlog = "/dev/fd/2"
 accesslog.format = env.LIGHTTPD_ACCESSLOG_FORMAT
 accesslog.filename = "/dev/fd/2"
 
-fastcgi.server = ( "" =>
-  (
+env.LIGHTTPD_FASTCGI_SOCKET == "" {
+  fastcgi.server = ( "" =>
 	(
-	  "host" => env.LIGHTTPD_FASTCGI_HOST,
-	  "port" => env.LIGHTTPD_FASTCGI_PORT,
-	  "check-local" => "disable",
-	),
+	  (
+		"host" => env.LIGHTTPD_FASTCGI_HOST,
+		"port" => env.LIGHTTPD_FASTCGI_PORT,
+		"check-local" => "disable",
+	  ),
+	)
   )
-)
+} else {
+  fastcgi.server = ( "" =>
+	(
+	  (
+		"socket" => env.LIGHTTPD_FASTCGI_SOCKET,
+		"check-local" => "disable",
+	  ),
+	)
+  )
+}

runtime/usr/local/bin/start-server

@@ -4,7 +4,11 @@ if [[ "${SERVER}" == spawn-fcgi ]]; then
     echo "Starting with spawn-fcgi"
     # Save the environment to be able to restore it in the FCGI daemon (used in /usr/local/bin/mapserv_wrapper)
     ${GET_ENV} | sed -e 's/.\+/export "\0"/' > /tmp/init_env
-    /usr/bin/spawn-fcgi -p "${LIGHTTPD_FASTCGI_PORT}" -n -- /usr/local/bin/mapserv_wrapper
+    if [[ "${LIGHTTPD_FASTCGI_SOCKET}" == "" ]]; then
+        exec /usr/bin/spawn-fcgi -p "${LIGHTTPD_FASTCGI_PORT}" -n -- /usr/local/bin/mapserv_wrapper
+    else
+        exec /usr/bin/spawn-fcgi -s "${LIGHTTPD_FASTCGI_SOCKET}" -n -- /usr/local/bin/mapserv_wrapper
+    fi
 else
     if [[ "${SERVER}" == lighttpd ]]; then
         echo "Starting lighttpd"