Esta página foi traduzida automaticamente. Ler o original em inglês.

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.

Proveniência

OficialAssinado por uma identidade de assinatura que este catálogo reconhece como editor oficial.
Digest do conteúdo
sha256:08b1ca48d3c2871ade1295b70cfb4f5b0e827172c4f0fc9c92ae8d78c02dee64
Publicado
2026-11-10T10:12:19Z
Identidade de assinatura
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

Assinatura

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

Referência nesta versão

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

Parâmetros do programador

Valores que o programador define no Aggregate.

NomeTipoPredefiniçãoObrigatórioDescrição
upstream_pathstring/nãoLocation path prefix the gateway proxies to the upstream. Requests matching this prefix are forwarded to the upstream wired on the `upstream` socket.

Dimensionamento do operador

Dimensionamento da infraestrutura que o operador ajusta por ambiente.

NomeTipoPredefiniçãoObrigatórioDescrição
portinteger (min 1024, max 65535)8080nãoHTTP port NGINX listens on. Most operators should omit this and let the Recipe assign the default (8080).
engine_versionstring1.27.5-alpinenãoNGINX 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—não—
overridesobject (open)—nãoProvider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads.

Contrato de saída

Valores que este componente publica para os consumidores através da topologia uses.

NomeTipoPredefiniçãoObrigatórioDescrição
hoststring—simIn-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—simTCP 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—nãoHow the published address is spoken to — `http`, so a consumer composes an address on that scheme.

Sockets uses

Os sockets de dependência através dos quais este componente se liga. O destino de cada ligação estabelecida através de um socket tem de satisfazer o respetivo seletor de etiquetas, e cada ligação pode transportar um acoplamento nos slots que o socket declara. Cada ligação que o Aggregate ou a Release estabelece através do socket tem de preencher os slots obrigatórios.

upstream

Seletor
component.aggrega.ai/type=server
Injeção
env

Este socket não declara slots de acoplamento, pelo que uma ligação através dele não transporta nenhum acoplamento.

guard

Seletor
dataplane.aggrega.ai/prompt-guard=classifier
Injeção
—

Este socket não declara slots de acoplamento, pelo que uma ligação através dele não transporta nenhum acoplamento.

Slots de acoplamento

Pontos de vinculação com nome nos quais uma Feature se acopla a este componente. O seletor de um slot restringe qual a Feature que o pode preencher, e a respetiva lista inject indica como o material da Feature pode ser entregue. Um slot obrigatório tem de estar vinculado em cada instância, por um acoplamento na instância ou num âmbito acima dela, e um slot sensível é declarado para tratar material secreto. Uma Feature também se pode acoplar com um nome que nenhum slot declara.

Nenhum slot de acoplamento declarado.

Lista de autorizações de autoinjeção

env

Relações

Arestas tipadas de e para outras entidades publicadas. Uma referência sem destino publicado é apresentada como uma aresta quebrada em vez de uma ligação.

Usa

Usado por

Referência do conceito Component →

O catálogo Aggrega — um índice aberto de componentes, funcionalidades, receitas e dos plugins que os renderizam.

Criado com o sistema de design partilhado do Aggrega.

Privacidade