Add configuration for CrateDB HTTP API endpoint on a subdirectory path

Author: amotl

spikes/http-api-behind-nginx/README.rst

@@ -0,0 +1,27 @@
+#############################
+CrateDB HTTP API behind Nginx
+#############################
+
+
+*****
+About
+*****
+
+Nginx configuration for hosting the CrateDB HTTP API endpoint on a subdirectory
+path. Here: `/db`.
+
+
+*****
+Usage
+*****
+
+Start CrateDB::
+
+    docker run -it --rm --publish=4200:4200 --publish=5432:5432 --name=cratedb crate/crate:5.0.1 -Cdiscovery.type=single-node -Ccluster.routing.allocation.disk.threshold_enabled=false
+
+Start Nginx::
+
+    wget https://raw.githubusercontent.com/crate/cratedb-examples/main/spikes/http-api-behind-nginx/nginx.conf
+    nginx -c $(pwd)/nginx.conf
+
+Then, navigate to http://localhost:7070/db/.

spikes/http-api-behind-nginx/nginx.conf

@@ -0,0 +1,34 @@
+# Nginx configuration for hosting the CrateDB HTTP API endpoint on a subdirectory path.
+# Here: `/db`.
+
+daemon off;
+error_log /dev/stderr info;
+
+worker_processes  1;
+
+events {
+  worker_connections  256;
+}
+
+http {
+  keepalive_timeout  65;
+  access_log /dev/stderr;
+
+  server {
+    listen       7070;
+    server_name  localhost;
+
+    location /db/ {
+
+      # Cut away the `/db` prefix and reverse-proxy requests to CrateDB on `localhost`.
+      rewrite       ^/db/(.*)$  /$1  break;
+      proxy_pass    http://localhost:4200/;
+
+      # Obligatory configuration for setting appropriate HTTP headers.
+      proxy_set_header        Host            $http_host;
+      proxy_set_header        X-Real-IP       $remote_addr;
+      proxy_set_header        X-Forwarded-For $proxy_add_x_forwarded_for;
+      # proxy_set_header        X-Forwarded-Proto https;
+    }
+  }
+}