このページは機械翻訳されています。英語の原文を読む。

Recipe

kong

Kong, a database-backed API gateway, for local development via Docker Compose, synthesized from the Workload kind by the compose provider. The PostgreSQL backend on the `backend` edge is the system of record, so it renders stateless with no volume. The connection's host, port, user and database arrive on the inject pipe under the four KONG_PG_* variables the edge's inject block names; an edge leaving any missing halts the build naming the edge and the variables. A schema-provisioning step runs the same image and connection before the gateway starts. With no credential on the backend connection, the steps and the gateway share the inline development default the PostgreSQL Recipe for this target also falls back to; an attached one is rendered as KONG_PG_PASSWORD, the key it must publish under. Each model wired to the models socket gets a chat and a completion route through Kong's AI proxy, in Kong's declarative configuration that a second step imports into the database before the gateway starts. A connection's credential is the value it publishes as AI_PROXY_<ALIAS>_API_KEY, written into the bearer token the routes name through Kong's environment vault: a Compose variable reference such as ${OPENAI_API_KEY} lands as that reference, a literal as itself. With `values.metrics_enabled` true the Status API moves off loopback to port 8007 of every interface and provides.metrics_endpoint publishes /metrics on it; false, that key is empty. While it is on, every peer on the Compose network reaches that port, but only a GET of /status, /status/ready or /metrics: the KongStatusGuard bundle refuses the rest, POST /status/ready among them.

来歴

公式このカタログが公式の公開者として認めている署名 ID によって署名されています。
コンテンツダイジェスト
sha256:92dedc086399bb798bfc276a39b90177abfbc1960f67b9decbcda3e4538824a2
公開日
2026-11-10T10:19:24Z
署名 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:469fcdeb5a2144336b09dd76d76bd01e07ac065f5a9daa9c1673ce551c1ac59e

このバージョンの参照

oci://hub.aggrega.ai/recipe/compose/kong:1.0.0
ターゲット
—
実装対象
core/gateway/kong:1.0.0

提供

このレシピが利用側のために配線する決定論的なポインターテンプレートです。

名前テンプレート
host{{ .context.instance_id }}
port{{ .infra.proxy_port }}
protocolhttp
endpoint{{ with optional .values "model" "" }}http://{{ $.context.instance_id }}:{{ $.infra.proxy_port }}/{{ . }}/v1{{ end }}
model{{ optional .values "model" "" }}
metrics_endpoint{{ if .values.metrics_enabled }}http://{{ .context.instance_id }}:{{ .locals.status_port }}/metrics{{ end }}

Workload

Workload · form: stateless · replicas: 1 · containers: main

ローカル変数

名前テンプレート
model_routes_deliverycompose_configs
model_routes_config_name{{ .context.instance_id }}-model-routes
model_routes_path/etc/kong/model-routes.yaml
connection_variable_prefixAI_PROXY_
credential_variable_suffix_API_KEY
header_variable_suffix_AUTHORIZATION
status_port8007
status_guard_deliverycompose_configs
status_guard_config_name{{ .context.instance_id }}-status-guard
status_guard_path/etc/kong/status-guard.conf

値のマッピング

値のマッピングは宣言されていません。

関係

他の公開エンティティとの間の型付きエッジです。公開されたターゲットがない参照は、リンクではなく切れたエッジとして表示されます。

使用先

  • 実装実装コントラクト互換

    core/gateway/kong:1.0.0

    必須の出力はすべて満たされており、提供されるすべての出力がコントラクトに記載されています。

使用元

カタログ内にこのエンティティに依存しているものはありません。

Recipe の概念リファレンス →

Aggrega カタログ — コンポーネント、機能、レシピ、およびそれらをレンダリングするプラグインのオープンなインデックスです。

共有の Aggrega デザインシステムで構築されています。

プライバシー