Cette page a été traduite automatiquement. Lire l’original en anglais.

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.

Provenance

OfficielSigné par une identité de signature que ce catalogue reconnaît comme éditeur officiel.
Empreinte du contenu
sha256:08b1ca48d3c2871ade1295b70cfb4f5b0e827172c4f0fc9c92ae8d78c02dee64
Publié
2026-11-10T10:12:19Z
Identité de signature
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

Signature

  • Officielapplication/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

Référence à cette version

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

Paramètres du développeur

Valeurs que le développeur définit dans l’Aggregate.

NomTypeValeur par défautObligatoireDescription
upstream_pathstring/nonLocation path prefix the gateway proxies to the upstream. Requests matching this prefix are forwarded to the upstream wired on the `upstream` socket.

Dimensionnement de l’opérateur

Dimensionnement de l’infrastructure que l’opérateur ajuste pour chaque environnement.

NomTypeValeur par défautObligatoireDescription
portinteger (min 1024, max 65535)8080nonHTTP port NGINX listens on. Most operators should omit this and let the Recipe assign the default (8080).
engine_versionstring1.27.5-alpinenonNGINX 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—non—
overridesobject (open)—nonProvider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads.

Contrat de sortie

Valeurs que ce composant publie vers les consommateurs via la topologie uses.

NomTypeValeur par défautObligatoireDescription
hoststring—ouiIn-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—ouiTCP 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—nonHow the published address is spoken to — `http`, so a consumer composes an address on that scheme.

Sockets uses

Les sockets de dépendance par lesquels ce composant se connecte. La cible de chaque connexion câblée via un socket doit satisfaire son sélecteur d’étiquettes, et chaque connexion peut porter une attache dans les emplacements que le socket déclare. Un emplacement obligatoire doit être rempli par chaque connexion que l’Aggregate ou la Release câble via le socket.

upstream

Sélecteur
component.aggrega.ai/type=server
Injection
env

Ce socket ne déclare aucun emplacement d’attache, donc une connexion qui le traverse ne porte aucune attache.

guard

Sélecteur
dataplane.aggrega.ai/prompt-guard=classifier
Injection
—

Ce socket ne déclare aucun emplacement d’attache, donc une connexion qui le traverse ne porte aucune attache.

Emplacements d’attache

Points de liaison nommés auxquels une Feature s’attache à ce composant. Le sélecteur d’un emplacement restreint la Feature qui peut le remplir, et sa liste inject indique comment le matériel de la Feature peut être livré. Un emplacement obligatoire doit être lié sur chaque instance, par une attache sur l’instance ou à une portée supérieure, et un emplacement sensible est déclaré pour traiter du matériel secret. Une Feature peut aussi s’attacher sous un nom qu’aucun emplacement ne déclare.

Aucun emplacement d’attache déclaré.

Liste d’autorisation d’auto-injection

env

Relations

Arêtes typées vers et depuis d’autres entités publiées. Une référence sans cible publiée s’affiche comme une arête rompue plutôt que comme un lien.

Utilise

Utilisé par

Référence du concept Component →

Le catalogue Aggrega — un index ouvert de composants, de fonctionnalités, de recettes et des plugins qui en assurent le rendu.

Conçu avec le système de design partagé d’Aggrega.

Confidentialité