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.
Herkunft
- Inhalts-Digest
- sha256:08b1ca48d3c2871ade1295b70cfb4f5b0e827172c4f0fc9c92ae8d78c02dee64
- Veröffentlicht
- 2026-11-10T10:12:19Z
- Signaturidentität
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
Signatur
- Offiziellapplication/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
Referenz zu dieser Version
oci://hub.aggrega.ai/component/core/gateway/nginx:1.0.0Entwicklerparameter
Werte, die der Entwickler im Aggregate festlegt.
| Name | Typ | Standardwert | Erforderlich | Beschreibung |
|---|---|---|---|---|
| upstream_path | string | / | nein | Location path prefix the gateway proxies to the upstream. Requests matching this prefix are forwarded to the upstream wired on the `upstream` socket. |
Dimensionierung durch den Operator
Infrastrukturdimensionierung, die der Operator pro Umgebung anpasst.
| Name | Typ | Standardwert | Erforderlich | Beschreibung |
|---|---|---|---|---|
| port | integer (min 1024, max 65535) | 8080 | nein | HTTP port NGINX listens on. Most operators should omit this and let the Recipe assign the default (8080). |
| engine_version | string | 1.27.5-alpine | nein | 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>`. |
| compute | object | — | nein | — |
| overrides | object (open) | — | nein | Provider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads. |
Ausgabevertrag
Werte, die diese Komponente über die uses-Topologie an Konsumenten veröffentlicht.
| Name | Typ | Standardwert | Erforderlich | Beschreibung |
|---|---|---|---|---|
| host | string | — | ja | 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. |
| port | integer | — | ja | 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. |
| protocol | string | — | nein | How the published address is spoken to — `http`, so a consumer composes an address on that scheme. |
uses-Sockets
Die Abhängigkeits-Sockets, über die sich diese Komponente verbindet. Das Ziel jeder über einen Socket verdrahteten Verbindung muss dessen Label-Selektor erfüllen, und jede Verbindung kann in den Slots, die der Socket deklariert, eine Anbindung tragen. Einen erforderlichen Slot muss jede Verbindung füllen, die das Aggregate oder das Release über den Socket verdrahtet.
upstream
- Selektor
- component.aggrega.ai/type=server
- Injektion
- env
Dieser Socket deklariert keine Anbindungs-Slots, daher trägt eine Verbindung über ihn keine Anbindung.
guard
- Selektor
- dataplane.aggrega.ai/prompt-guard=classifier
- Injektion
- —
Dieser Socket deklariert keine Anbindungs-Slots, daher trägt eine Verbindung über ihn keine Anbindung.
Anbindungs-Slots
Benannte Bindungspunkte, an denen ein Feature an diese Komponente angebunden wird. Der Selektor eines Slots schränkt ein, welches Feature ihn füllen darf, und seine inject-Liste benennt, wie das Feature sein Material liefern darf. Ein erforderlicher Slot muss auf jeder Instanz gebunden sein, durch eine Anbindung an der Instanz oder in einem darüberliegenden Geltungsbereich, und ein sensibler Slot ist für den Umgang mit geheimem Material deklariert. Ein Feature kann auch unter einem Namen angebunden werden, den kein Slot deklariert.
Keine Anbindungs-Slots deklariert.
Zulassungsliste für Selbstinjektion
env
Beziehungen
Typisierte Kanten zu und von anderen veröffentlichten Entitäten. Eine Referenz ohne veröffentlichtes Ziel wird als unterbrochene Kante statt als Link dargestellt.
Verwendet
- verwendetverwendet Socket «upstream»
component.aggrega.ai/type=server
Deklariert keine Anbindungs-Slots.
core/ai-agent/agenta-api v1.0.0 →core/ai-agent/agenta-runner v1.0.0 →core/ai-agent/agenta-services v1.0.0 →core/ai-agent/agenta-web v1.0.0 →core/ai-agent/agenta-web-mobile v1.0.0 →core/ai-agent/dify v1.0.0 →core/ai-agent/dify v1.1.0 →core/ai-agent/dify-sandbox v1.0.0 →core/ai-agent/dify-ssrf-proxy v1.0.0 →core/ai-agent/dify-web v1.0.0 →core/ai-agent/dify-web v1.1.0 →core/ai-agent/flowise v1.0.0 →core/ai-agent/flowise v1.1.0 →core/ai-agent/google-adk v1.0.0 →core/ai-agent/google-adk v1.1.0 →core/ai-agent/langflow v1.0.0 →core/ai-agent/langflow v1.1.0 →core/ai-agent/librechat v1.0.0 →core/ai-agent/librechat v1.1.0 →core/ai-agent/librechat v1.2.0 →core/ai-agent/mastra v1.0.0 →core/ai-agent/n8n v1.0.0 →core/ai-agent/n8n v1.1.0 →core/ai-agent/open-webui v1.0.0 →core/ai-model/docker-model-runner v1.0.0 →core/ai-model/litellm v1.0.0 →core/ai-model/nemoguard-content-safety 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/tei v1.0.0 →core/ai-model/tgi v1.0.0 →core/ai-model/vllm v1.0.0 →core/ai-pipeline/argo-workflows v1.0.0 →core/ai-pipeline/temporal v1.0.0 →core/ai-tool/browser v1.0.0 →core/ai-tool/computer-use v1.0.0 →core/ai-tool/mcp v1.0.0 →core/ai-tool/mcp v1.1.0 →core/compute/keda v1.0.0 →core/compute/knative-serving v1.0.0 →core/compute/server v1.0.0 →core/compute/server v1.1.0 →core/datastore/mariadb-operator v1.0.0 →core/datastore/memcached v1.0.0 →core/datastore/mysql-operator v1.0.0 →core/datastore/redis v1.0.0 →core/datastore/valkey v1.0.0 →core/devtool/adminer v1.0.0 →core/gateway/agentgateway v1.0.0 →core/gateway/apisix v1.0.0 →core/gateway/contour v1.0.0 →core/gateway/envoy-ai-gateway-operator v1.0.0 →core/gateway/envoy-gateway v1.0.0 →core/gateway/higress v1.0.0 →core/gateway/kong v1.0.0 →core/gateway/kong-enterprise v1.0.0 →core/gateway/litellm v1.0.0 →core/gateway/traefik-hub v1.0.0 →core/gateway/tyk v1.0.0 →core/messaging/livekit-server v1.0.0 →core/messaging/livekit-sip v1.0.0 →core/messaging/nats v1.0.0 →core/observability/fluent-bit v1.0.0 →core/observability/grafana v1.0.0 →core/observability/langfuse v1.0.0 →core/observability/otel-collector v1.0.0 →core/observability/thanos-query v1.0.0 →core/observability/thanos-store v1.0.0 →core/security/cert-manager v1.0.0 →core/security/external-secrets v1.0.0 →core/security/fms-guardrails-orchestrator v1.0.0 →core/security/keycloak v1.0.0 →core/security/kong-ai-pii-service v1.0.0 →core/security/nemo-guardrails v1.0.0 →core/security/nemoguard-jailbreak-detect v1.0.0 →core/security/presidio-analyzer v1.0.0 →core/security/presidio-anonymizer v1.0.0 →core/security/sealed-secrets v1.0.0 →core/security/supertokens v1.0.0 →core/security/trustyai-guardrails-gateway v1.0.0 →core/security/trustyai-huggingface-detector v1.0.0 →core/storage/barman-cloud-plugin v1.0.0 →core/storage/k8up v1.0.0 →core/storage/kasten v1.0.0 →core/storage/kubestash v1.0.0 →core/storage/velero v1.0.0 →example/compute/db-reader v1.0.0 →example/compute/gcp-credentialed-service v1.0.0 →example/compute/greeter v1.0.0 →example/compute/service v1.0.0 →example/gateway/nginx-reviewed v1.0.0 → - verwendetverwendet Socket «guard»
dataplane.aggrega.ai/prompt-guard=classifier
Deklariert keine Anbindungs-Slots.
Verwendet von
verwendet Socket «forward_target»
verwendet Socket «scrape_target»
verwendet Socket «store»
gilt für
gilt für
gilt für
gilt für
gilt für
gilt für
gilt für
gilt für
gilt für
gilt für
implementiert
implementiert
implementiert