feat(conf): inject nginx directives into kong's proxy location block (#…

…11623)

`nginx_location_*`: the new prefix allows for the dynamic
injection of Nginx directives into the `/` location block within
Kong's Proxy server block.

changelog/unreleased/kong/inject-nginx-directives-location.yml

@@ -0,0 +1,3 @@
+message: Allow to inject Nginx directives into Kong's proxy location block
+type: feature
+scope: Configuration

kong.conf.default

@@ -1069,6 +1069,8 @@
 # - `nginx_http_<directive>`: Injects `<directive>` in Kong's `http {}` block.
 # - `nginx_proxy_<directive>`: Injects `<directive>` in Kong's proxy
 #   `server {}` block.
+# - `nginx_location_<directive>`: Injects `<directive>` in Kong's proxy `/`
+#    location block (nested under Kong's proxy server {} block).
 # - `nginx_upstream_<directive>`: Injects `<directive>` in Kong's proxy
 #   `upstream {}` block.
 # - `nginx_admin_<directive>`: Injects `<directive>` in Kong's Admin API

kong/conf_loader/init.lua

@@ -197,6 +197,11 @@ local DYNAMIC_KEY_NAMESPACES = {
     prefix = "nginx_proxy_",
     ignore = EMPTY,
   },
+  {
+    injected_conf_name = "nginx_location_directives",
+    prefix = "nginx_location_",
+    ignore = EMPTY,
+  },
   {
     injected_conf_name = "nginx_status_directives",
     prefix = "nginx_status_",

kong/templates/nginx_kong.lua

@@ -157,6 +157,11 @@ server {
         proxy_buffering          on;
         proxy_request_buffering  on;
 
+        # injected nginx_location_* directives
+> for _, el in ipairs(nginx_location_directives) do
+        $(el.name) $(el.value);
+> end
+
         proxy_set_header      TE                 $upstream_te;
         proxy_set_header      Host               $upstream_host;
         proxy_set_header      Upgrade            $upstream_upgrade;

spec/01-unit/04-prefix_handler_spec.lua

@@ -611,6 +611,14 @@ describe("NGINX conf compiler", function()
         assert.matches("large_client_header_buffers%s+16 24k;", nginx_conf)
       end)
 
+      it("injects nginx_location_* directives", function()
+        local conf = assert(conf_loader(nil, {
+          nginx_location_proxy_ignore_headers = "X-Accel-Redirect",
+        }))
+        local nginx_conf = prefix_handler.compile_kong_conf(conf)
+        assert.matches("proxy_ignore_headers%sX%-Accel%-Redirect;", nginx_conf)
+      end)
+
       it("injects nginx_admin_* directives", function()
         local conf = assert(conf_loader(nil, {
           nginx_admin_large_client_header_buffers = "4 24k",