Recipe

kong

Kong, a database-backed API gateway, on Kubernetes via the helm provider's Workload synthesis (a stateless Deployment plus a ClusterIP Service on the proxy port). The PostgreSQL backend is the system of record, so the gateway renders stateless. Its host, port, user and database arrive on .context.inject.env under the four KONG_PG_* variables the `backend` edge's inject block names; an edge leaving any missing halts the build naming the edge and the variables. A migrations step runs to completion before the gateway serves. With no credential on the backend connection the Recipe uses an inline development default; with one, KONG_PG_PASSWORD comes from the credential subsystem. Each model wired to the models socket gets a chat and a completion route through Kong's AI proxy, written as Kong's declarative configuration in a ConfigMap that a second step imports into the database before the gateway starts. A connection's credential arrives as an env secretKeyRef and the routes name it through Kong's environment vault, so no credential value is in the rendered output. Reach for this realization where the build must complete with nothing fetched; reach for `kong-chart` where the gateway will be upgraded in place, since it migrates the schema on either side of an upgrade. With `values.metrics_enabled` true the Service also carries the Status API port, 8007, and provides.metrics_endpoint publishes /metrics on it; false, that key is empty. That port, open on the pod for the probes, answers only a GET of /status, /status/ready or /metrics from another address: the KongStatusGuard bundle refuses the rest, POST /status/ready among them.

Provenance

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
Content digest
sha256:f134ea916a430087260ec843b7ecca6ce65fe2f4941c14fcf609a6427b555c32
Published
2026-11-10T10:24:40Z
Signing identity
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

Signature

  • Officialapplication/vnd.dev.sigstore.bundle.v0.3+json

    https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

    sha256:298db818546009026f1dcf619cc9aa7db677ca997f7312c499dc2490eb09430f

Reference at this version

oci://hub.aggrega.ai/recipe/helm/kong:1.0.0
Target
—
Implements
core/gateway/kong:1.0.0

Provides

Deterministic pointer templates this recipe wires for consumers.

NameTemplate
host{{ .context.rendered_name }}-default
port{{ .infra.proxy_port }}
protocolhttp
endpoint{{ with optional .values "model" "" }}http://{{ $.context.rendered_name }}-default:{{ $.infra.proxy_port }}/{{ . }}/v1{{ end }}
model{{ optional .values "model" "" }}
metrics_endpoint{{ if .values.metrics_enabled }}http://{{ .context.rendered_name }}-default:{{ .locals.status_port }}/metrics{{ end }}

Workload

Workload · replicas: 1 · containers: main

Locals

NameTemplate
model_routes_deliveryconfig_map
model_routes_filemodel-routes.yaml
model_routes_config_map_suffix-model-routes
connection_variable_prefixAI_PROXY_
credential_variable_suffix_API_KEY
header_variable_suffix_AUTHORIZATION
status_port8007
status_guard_deliveryconfig_map
status_guard_filestatus-guard.conf
status_guard_config_map_suffix-status-guard

Values mapping

No values mapping declared.

Relationships

Typed edges to and from other published entities. A reference with no published target renders as a broken edge rather than a link.

Uses

  • implementsimplementscontract compatible

    core/gateway/kong:1.0.0

    All required outputs are satisfied and every provided output is named in the contract.

Used by

Nothing in the catalog depends on this entity.

Recipe concept reference →

The Aggrega catalog — an open index of components, features, recipes, and the plugins that render them.

Built with the shared Aggrega design system.

Privacy