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.
来歴
- コンテンツダイジェスト
- sha256:f134ea916a430087260ec843b7ecca6ce65fe2f4941c14fcf609a6427b555c32
- 公開日
- 2026-11-10T10:24:40Z
- 署名 ID
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
署名
- 公式application/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
このバージョンの参照
oci://hub.aggrega.ai/recipe/helm/kong:1.0.0- ターゲット
- —
- 実装対象
- core/gateway/kong:1.0.0
提供
このレシピが利用側のために配線する決定論的なポインターテンプレートです。
| 名前 | テンプレート |
|---|---|
| host | {{ .context.rendered_name }}-default |
| port | {{ .infra.proxy_port }} |
| protocol | http |
| 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
ローカル変数
| 名前 | テンプレート |
|---|---|
| model_routes_delivery | config_map |
| model_routes_file | model-routes.yaml |
| model_routes_config_map_suffix | -model-routes |
| connection_variable_prefix | AI_PROXY_ |
| credential_variable_suffix | _API_KEY |
| header_variable_suffix | _AUTHORIZATION |
| status_port | 8007 |
| status_guard_delivery | config_map |
| status_guard_file | status-guard.conf |
| status_guard_config_map_suffix | -status-guard |
値のマッピング
値のマッピングは宣言されていません。
関係
他の公開エンティティとの間の型付きエッジです。公開されたターゲットがない参照は、リンクではなく切れたエッジとして表示されます。
使用先
- 実装実装コントラクト互換
core/gateway/kong:1.0.0
必須の出力はすべて満たされており、提供されるすべての出力がコントラクトに記載されています。
使用元
カタログ内にこのエンティティに依存しているものはありません。