Component
core/gateway/kong
Kong, a database-backed API gateway. It routes client traffic by configuration held in the PostgreSQL backend wired to its `backend` socket; a migrations step provisions the schema before the gateway serves. The database is the system of record, so Kong renders as a stateless server. It publishes its proxy host, port and protocol. It also serves models: each one wired to its models socket gets a route through Kong's AI proxy, at /<alias>/v1 under the connection's alias, sent to the endpoint and model name the model publishes and presenting that connection's credential. It publishes values.model's route as its endpoint and that alias as its model, so an agent's model socket takes it in place of a model; with nothing wired both are empty. A core/prompt-deny-patterns attachment puts Kong's AI Prompt Guard on every one of those routes, where it stays once the attachment is removed. On Kubernetes the Manifest chooses between two realizations. `kong` synthesizes a workload with its bootstrap steps ahead of it and fetches nothing, for a build with no chart repository reachable. `kong-chart` renders the official Kong Helm chart, which also migrates the schema on either side of an upgrade, for a gateway upgraded in place. With `values.metrics_enabled` true each Recipe publishes Kong's metrics, /metrics on its Status API port, as `metrics_endpoint`; false, that key is empty. From another address that port answers a GET of /status, /status/ready or /metrics, with no caller check, and refuses every other request, POST /status/ready among them. On Kubernetes it is already open on the pod and the value names it on a Service; on Docker Compose the value newly opens it to every peer on the network.
Pochodzenie
- Skrót zawartości
- sha256:201da649bd0f7f8e28f27a6d5363a44245d5b9511a49f376a7e3e35c814a3631
- Opublikowano
- 2026-11-10T10:11:58Z
- Tożsamość podpisująca
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
Podpis
- Oficjalnyapplication/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:9191738ab434bbd7188696956cebe55890663c993e802d2edeed0235025f0644
Referencja w tej wersji
oci://hub.aggrega.ai/component/core/gateway/kong:1.0.0Parametry dewelopera
Wartości ustawiane przez dewelopera w encji Aggregate.
| Nazwa | Typ | Wartość domyślna | Wymagane | Opis |
|---|---|---|---|---|
| model | string | — | nie | The alias of a connection on the models socket that this gateway publishes as its model, and whose route its published endpoint addresses. It must be an alias a models connection carries, and the build halts naming this value otherwise; it is required while the models socket holds a connection, and omitted while it holds none. |
| metrics_enabled | boolean | false | nie | Makes Kong's own metrics, in the Prometheus format at /metrics on its Status API port, reachable and publishes their address as `metrics_endpoint`; while false that key is empty. From another address the port answers a GET of /metrics, /status/ready or /status (memory, connections and database reachability), with no caller check, and refuses every other request, POST /status/ready, which with status=draining would take the gateway out of readiness, among them. On Kubernetes the port is already open on the pod, and naming it on a Service adds no audience; on Docker Compose the value newly opens it to every peer on the network. |
Wymiarowanie przez operatora
Wymiarowanie infrastruktury, które operator dostraja dla każdego środowiska.
| Nazwa | Typ | Wartość domyślna | Wymagane | Opis |
|---|---|---|---|---|
| proxy_port | integer (min 1024, max 65535) | 8000 | nie | Proxy data-plane port consumers connect to. |
| admin_port | integer (min 1024, max 65535) | 8001 | nie | Admin API port, reachable in-cluster only. |
| engine_version | string | 3.9.3 | nie | Kong gateway container image tag. Selects the image tag on container targets; the chart-backed realization pins its own image tag. |
| source_version | string | — | nie | Version of the Helm chart the chart-backed realization pulls. Read only by that realization; the workload-synthesis realization pulls no source artifact and ignores it. Changing it away from the Recipe's default does not guarantee value-mapping compatibility with the new chart. |
| compute | object | — | nie | — |
| overrides | object (open) | — | nie | Provider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads. |
Kontrakt wyjściowy
Wartości, które ten komponent publikuje konsumentom za pośrednictwem topologii uses.
| Nazwa | Typ | Wartość domyślna | Wymagane | Opis |
|---|---|---|---|---|
| host | string | — | tak | In-cluster DNS name of the Service fronting the proxy data plane. A consumer sends its client traffic here rather than to the service behind the gateway. |
| port | integer | — | tak | TCP port that Service accepts proxied traffic on. It carries the proxy port an operator set, never the Admin API port, which stays in-cluster. |
| protocol | string | — | nie | How the published address is spoken to — `http`, so a consumer composes an address on that scheme. |
| endpoint | string | — | nie | Full base URL of the OpenAI-compatible API the gateway serves for the model values.model names, with the host, the port and that alias's route already composed. A caller hands it to a client library as its base URL. Every other wired model is served at the same host and port under its own alias in the path. Empty while nothing is wired to the models socket. |
| model | string | — | nie | The alias a consumer wired to the gateway sends as its model name: values.model. The route behind the endpoint asks for the model it was written for whatever name a request carries. Empty while nothing is wired to the models socket. |
| metrics_endpoint | string | — | nie | The full address Prometheus scrapes this component's metrics at — scheme, host, port and path, `http://<host>:<status port>/metrics`, the host being the Service a realization puts the Status API port on. Empty while values.metrics_enabled is false. |
Gniazda uses
Gniazda zależności, przez które łączy się ten komponent. Cel każdego połączenia poprowadzonego przez gniazdo musi spełniać jego selektor etykiet, a każde połączenie może przenosić dołączenie w slotach deklarowanych przez gniazdo. Wymagany slot musi wypełnić każde połączenie, które encja Aggregate lub encja Release prowadzi przez gniazdo.
backend
- Selektor
- component.aggrega.ai/type=stateful-server
- Wstrzykiwanie
- env
Sloty, które może wypełnić każde połączenie przez to gniazdo
| Slot | Selektor | Wymagane | Wstrzykiwanie | Wrażliwe | Opis |
|---|---|---|---|---|---|
| credential | feature.aggrega.ai/kind=secret | nie | env | tak | Optional password the gateway presents to the backend this connection reaches, shared with that backend. When attached, supplies the backend password via the credential subsystem. Unattached, compose/kong, helm/kong and helm/kong-chart present the development literal `apppass`, which this catalog publishes, so every Release that leaves the slot unattached shares that password. |
models
- Selektor
- component.aggrega.ai/category=ai-model
- Wstrzykiwanie
- —
Sloty, które może wypełnić każde połączenie przez to gniazdo
| Slot | Selektor | Wymagane | Wstrzykiwanie | Wrażliwe | Opis |
|---|---|---|---|---|---|
| credential | feature.aggrega.ai/kind=secret | nie | env | tak | Optional credential the gateway presents to the model this connection reaches, as a bearer token. When attached, the Recipe delivers it as AI_PROXY_<ALIAS>_API_KEY, the connection's alias in capitals with every character other than a letter or a digit as an underscore — a Kubernetes secretKeyRef on helm, the value the credential publishes under that name on the inject pipe on compose — and the connection's route reads the token through Kong's environment vault, naming the variable rather than the value. Unattached, the route adds no credential. |
Sloty dołączania
Nazwane punkty wiązania, w których encja Feature dołącza się do tego komponentu. Selektor slotu ogranicza, która encja Feature może go wypełnić, a jego lista inject określa, jak można dostarczyć materiał encji Feature. Wymagany slot musi być powiązany w każdej instancji, przez dołączenie w instancji lub w zakresie nad nią, a slot wrażliwy jest zadeklarowany do obsługi materiału tajnego. Encja Feature może również dołączyć się pod nazwą, której nie deklaruje żaden slot.
Nie zadeklarowano slotów dołączania.
Lista dozwolonych samowstrzyknięć
env
Relacje
Typowane krawędzie do innych opublikowanych encji i od nich. Odwołanie bez opublikowanego celu jest renderowane jako przerwana krawędź, a nie jako łącze.
Używa
- używaużywa gniazda «backend»
component.aggrega.ai/type=stateful-server
Sloty dołączania: credential
core/ai-agent/dify-plugin-daemon v1.0.0 →core/ai-tool/filesystem v1.0.0 →core/datastore/chroma v1.0.0 →core/datastore/cognee v1.0.0 →core/datastore/documentdb v1.0.0 →core/datastore/elasticsearch v1.0.0 →core/datastore/etcd v1.0.0 →core/datastore/ferretdb v1.0.0 →core/datastore/mariadb v1.0.0 →core/datastore/milvus v1.0.0 →core/datastore/mysql v1.0.0 →core/datastore/mysql-innodb-cluster v1.0.0 →core/datastore/opensearch v1.0.0 →core/datastore/pgvector v1.0.0 →core/datastore/postgres v1.0.0 →core/datastore/qdrant v1.0.0 →core/datastore/timescaledb v1.0.0 →core/datastore/weaviate v1.0.0 →core/devtool/harbor v1.0.0 →core/messaging/kafka v1.0.0 →core/messaging/rabbitmq v1.0.0 →core/observability/fluentd v1.0.0 →core/observability/jaeger v1.0.0 →core/observability/loki v1.0.0 →core/observability/prometheus v1.0.0 →core/observability/tempo v1.0.0 →core/security/openbao v1.0.0 → - używaużywa gniazda «models»
component.aggrega.ai/category=ai-model
Sloty dołączania: credential
core/ai-model/ai21 v1.0.0 →core/ai-model/anthropic v1.0.0 →core/ai-model/azure-managed v1.0.0 →core/ai-model/azure-openai v1.0.0 →core/ai-model/azure-openai-embedding v1.0.0 →core/ai-model/bedrock v1.0.0 →core/ai-model/bedrock-embedding v1.0.0 →core/ai-model/cohere v1.0.0 →core/ai-model/databricks v1.0.0 →core/ai-model/docker-model-runner v1.0.0 →core/ai-model/gemini v1.0.0 →core/ai-model/huggingface v1.0.0 →core/ai-model/litellm v1.0.0 →core/ai-model/mistral v1.0.0 →core/ai-model/nemoguard-content-safety v1.0.0 →core/ai-model/nvidia-api v1.0.0 →core/ai-model/nvidia-nim v1.0.0 →core/ai-model/nvidia-nim-operator v1.0.0 →core/ai-model/ollama v1.0.0 →core/ai-model/openai v1.0.0 →core/ai-model/openai-compatible v1.0.0 →core/ai-model/openai-embedding v1.0.0 →core/ai-model/replicate v1.0.0 →core/ai-model/sagemaker v1.0.0 →core/ai-model/tei v1.0.0 →core/ai-model/tgi v1.0.0 →core/ai-model/vertex-ai v1.0.0 →core/ai-model/vertex-ai-embedding v1.0.0 →core/ai-model/vllm v1.0.0 →
Używane przez
używa gniazda «model»
używa gniazda «model»
używa gniazda «model»
używa gniazda «model»
używa gniazda «model»
używa gniazda «model»
używa gniazda «model»
używa gniazda «model»
używa gniazda «model»
używa gniazda «model»
używa gniazda «model»
używa gniazda «model»
używa gniazda «model»
używa gniazda «model»
używa gniazda «model»
używa gniazda «model»
używa gniazda «model»
używa gniazda «model»
używa gniazda «model»
używa gniazda «model»
używa gniazda «model»
używa gniazda «model»
używa gniazda «model»
używa gniazda «model»
używa gniazda «model»
używa gniazda «model»
używa gniazda «model»
używa gniazda «model»
używa gniazda «model»
używa gniazda «model»
używa gniazda «model»
używa gniazda «model»
używa gniazda «model»
używa gniazda «target_model»
używa gniazda «extraction_model»
używa gniazda «embedding_model»
używa gniazda «upstream»
używa gniazda «forward_target»
używa gniazda «scrape_target»
używa gniazda «store»
dotyczy
dotyczy
dotyczy
dotyczy
dotyczy
dotyczy
dotyczy
dotyczy
dotyczy
implementuje
implementuje
implementuje