Эта страница переведена автоматически. Читать английский оригинал.

Component

core/gateway/nginx

An NGINX reverse-proxy gateway. NGINX terminates client HTTP traffic and forwards it to an upstream service wired through its `upstream` uses-socket: the upstream host and port arrive on the injection context and are rendered into the NGINX server configuration as the proxy_pass target, so the gateway routes to whichever component the topology binds. NGINX holds no persistent state, so it renders as a stateless server with no volume. Provider-agnostic: the same component is implemented by a synthesized Helm Recipe on the official NGINX image (Kubernetes) and a Compose Recipe (local development). Exports its host and listen port to consumers via the uses topology. The optional guard socket takes the core/security/nemo-guardrails a core/prompt-injection-shield attachment sends every forwarded request through in place of the upstream; wired alone it changes no request.

Происхождение

ОфициальныйПодписано идентичностью подписи, которую этот каталог признаёт официальным издателем.
Дайджест содержимого
sha256:08b1ca48d3c2871ade1295b70cfb4f5b0e827172c4f0fc9c92ae8d78c02dee64
Опубликовано
2026-11-10T10:12:19Z
Идентичность подписи
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:90a272f811730b256b1146c24e68d287134d443bcc2116b86a2b719f6ef9aca7

Ссылка на эту версию

oci://hub.aggrega.ai/component/core/gateway/nginx:1.0.0

Параметры разработчика

Значения, которые разработчик задаёт в сущности Aggregate.

ИмяТипПо умолчаниюОбязательныйОписание
upstream_pathstring/нетLocation path prefix the gateway proxies to the upstream. Requests matching this prefix are forwarded to the upstream wired on the `upstream` socket.

Размеры, задаваемые оператором

Размеры инфраструктуры, которые оператор настраивает для каждого окружения.

ИмяТипПо умолчаниюОбязательныйОписание
portinteger (min 1024, max 65535)8080нетHTTP port NGINX listens on. Most operators should omit this and let the Recipe assign the default (8080).
engine_versionstring1.27.5-alpineнетNGINX container image tag for the official upstream nginx image. Both targets — the synthesized Helm Deployment (Kubernetes) and the Compose service (local) — run `nginx:<engine_version>`.
computeobject—нет—
overridesobject (open)—нетProvider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads.

Контракт выходных значений

Значения, которые этот компонент публикует для потребителей через топологию uses.

ИмяТипПо умолчаниюОбязательныйОписание
hoststring—даIn-cluster DNS name of the Service fronting the proxy. A consumer sends its client traffic here and the gateway forwards it to whichever component the topology bound to its upstream socket.
portinteger—даTCP port that Service accepts client traffic on. It follows the port an operator set in the Release, so a consumer reads it rather than assuming a default.
protocolstring—нетHow the published address is spoken to — `http`, so a consumer composes an address on that scheme.

Сокеты uses

Сокеты зависимостей, через которые подключается этот компонент. Цель каждого соединения, проведённого через сокет, должна удовлетворять его селектору меток, и каждое соединение может нести подключение в слотах, которые объявляет сокет. Обязательный слот должен заполнить каждое соединение, которое сущность Aggregate или сущность Release проводит через сокет.

upstream

Селектор
component.aggrega.ai/type=server
Внедрение
env

Этот сокет не объявляет слотов подключения, поэтому соединение через него не несёт подключения.

guard

Селектор
dataplane.aggrega.ai/prompt-guard=classifier
Внедрение
—

Этот сокет не объявляет слотов подключения, поэтому соединение через него не несёт подключения.

Слоты подключения

Именованные точки привязки, в которых Feature подключается к этому компоненту. Селектор слота ограничивает, какая сущность Feature может его заполнить, а его список внедрения указывает, как могут доставляться материалы сущности Feature. Обязательный слот должен быть привязан в каждом экземпляре — подключением в самом экземпляре или в области выше него, — а конфиденциальный слот объявляется для работы с секретными материалами. Feature также может подключаться под именем, которое не объявляет ни один слот.

Слоты подключения не объявлены.

Список разрешённых самовнедрений

env

Связи

Типизированные рёбра к другим опубликованным сущностям и от них. Ссылка без опубликованной цели отображается как разорванное ребро, а не как ссылка.

Использует

Используется в

Справочник по понятию Component →

Каталог Aggrega — открытый указатель компонентов, функций, рецептов и плагинов, которые их рендерят.

Создано на общей дизайн-системе Aggrega.

Конфиденциальность