Document partials lookup features a bit more clearly

Feature Requests & Feedback
1

I have a prod and non-prod Kong gateway, and I want to use a shared Redis config in both instances (each instance has its own config, not a single config shared between both).

The documentation only shows how to use the ID of a config, which means that in my CICD I would need to store my config IDs as variables, and then use yq or possibly some deck patch commands to parse and update those values in my plugins, because putting the username and password for Valkey into my configs, which is a no-go.

However, after some tinkering, I got it to work using two separate files and deck merge

file 1:

_format_version: "3.0"

_info:
  default_lookup_tags:
    partials:
     - valkey_config

file 2 (each plugin is in a separate file):

_format_version: "3.0"

plugins:
  - name: proxy-cache-advanced
    partials:
      - name: valkey1

The ID is not actually needed, which means if I name and tag my valkey configs the same in both of my Kong instance, I don’t have to use and maintain CICD variables for this.

So this would enable me to tag all of my shared valkey configs with valkey_config and then apply them by name, so long as the naming were consistent, i.e. valkey1,valkey2, etc.

I realize this might not be useful for all customers, but the current docs only show how to use the ID, which to me doesn’t really display the strength/utility of being able to use lookups at all.

2

Hey, I’ve updated the docs to add an FAQ that will help other users who run into a similar case.

Thanks for reporting this!