Esta página foi traduzida automaticamente. Leia 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.

Procedência

OficialAssinado por uma identidade de assinatura que este catálogo reconhece como publicador 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 desenvolvedor

Valores que o desenvolvedor define no Aggregate.

NomeTipoPadrã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 de infraestrutura que o operador ajusta por ambiente.

NomeTipoPadrã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 pela topologia uses.

NomeTipoPadrã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 pelos quais este componente se conecta. O destino de cada conexão ligada por um socket deve satisfazer o seletor de rótulos dele, e cada conexão pode carregar um acoplamento nos slots que o socket declara. Cada conexão que o Aggregate ou a Release liga pelo socket deve preencher os slots obrigatórios.

upstream

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

Este socket não declara slots de acoplamento, então uma conexão por ele não carrega nenhum acoplamento.

guard

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

Este socket não declara slots de acoplamento, então uma conexão por ele não carrega nenhum acoplamento.

Slots de acoplamento

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

Nenhum slot de acoplamento declarado.

Lista de permissões de autoinjeção

env

Relações

Arestas tipadas de e para outras entidades publicadas. Uma referência sem destino publicado é exibida como uma aresta quebrada em vez de um link.

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 compartilhado do Aggrega.

Privacidade