Shared Declarative Loads

Goal

You will connect resources owned by different teams in one declarative load.

The central configuration gives the shared gateway a local ref:

ai_gateways:
  - ref: shared-ai-gateway
    name: shared-ai-gateway
    display_name: Shared Federated AI Gateway

A peer-owned model can refer to that gateway:

ai_gateway_models:
  - ref: peer-support-assistant
    ai_gateway: !ref shared-ai-gateway#id
    name: peer-support-assistant

!ref works here because kongctl loads both declarations before resolving the relationship.

Preview the central and peer configurations as one recursive load:

kongctl plan \
  -f docs/examples/declarative/ai-gateway/federated \
  --recursive \
  --mode apply

This model fits a workflow where separate team files are assembled into one reviewed plan.