Ta strona została przetłumaczona maszynowo. Przeczytaj oryginał w języku angielskim.

Component

core/messaging/nats

A NATS messaging server for pub-sub, request-reply, and queueing. In this lean shape NATS routes subjects in memory with no durable persistence (JetStream file storage is not enabled), so the component renders as a stateless workload rather than a stateful one and declares no storage. Authentication is off by default; when a credential is attached to the optional password slot, each Recipe enables user/password authentication and wires the credential through the credential subsystem. Provider-agnostic: the same component is implemented by a Helm Recipe (Workload synthesis to native Kubernetes resources) and a Compose Recipe (local development). Exports its host and client port to consumers via the uses topology. On Kubernetes there are two realizations and the Manifest chooses between them. `nats` synthesizes the server as a workload and fetches nothing, so it is the one to reach for where the build must complete with no chart repository reachable. `nats-chart` renders the product's own Helm chart, which additionally carries a sidecar that reloads the server configuration in place, start-up, readiness and liveness probes against the monitoring endpoint, and a drain-then-shut-down sequence that lets connected clients move off before the pod goes away — and it is the realization that honours `monitoring_port`, so reach for it where a chart repository is reachable at build time.

Pochodzenie

OficjalnyPodpisano tożsamością podpisującą, którą ten katalog uznaje za oficjalnego wydawcę.
Skrót zawartości
sha256:6442f87145c50476deb4c047562136eece91faa7a3ebc101d7ec4458916f1e5e
Opublikowano
2026-11-10T10:12:28Z
Tożsamość podpisująca
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

Podpis

  • Oficjalnyapplication/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:90bd8f7234f43e27af901a28509adea5872dc136a2a8965ba80f287a2ee77ce2

Referencja w tej wersji

oci://hub.aggrega.ai/component/core/messaging/nats:1.0.0

Parametry dewelopera

Wartości ustawiane przez dewelopera w encji Aggregate.

NazwaTypWartość domyślnaWymaganeOpis
userstringnats_clientnieClient user provisioned for authenticated connections. Used only when a password credential is attached to the optional password slot; ignored when the server runs without authentication.

Wymiarowanie przez operatora

Wymiarowanie infrastruktury, które operator dostraja dla każdego środowiska.

NazwaTypWartość domyślnaWymaganeOpis
portinteger (min 1024, max 65535)4222nieClient listen port. Most operators should omit this and let the Recipe assign the default (4222).
monitoring_portinteger (min 1024, max 65535)8222nieHTTP monitoring endpoint port. Most operators should omit this and let the Recipe assign the default (8222). Read by the chart-backed realization, which serves the endpoint and aims its probes at it; the workload-synthesis and Compose realizations expose no monitoring endpoint and ignore it.
engine_versionstring2.11-alpinenieNATS container image tag. Selects the image tag on container targets; the chart-backed realization pins its own image tag.
source_versionstring—nieVersion of the Helm chart the chart-backed realization pulls. Read only by that realization; the workload-synthesis and Compose realizations pull no source artifact and ignore it. Changing it away from the Recipe's default does not guarantee value-mapping compatibility with the new chart.
computeobject—nie—
overridesobject (open)—nieProvider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads.

Kontrakt wyjściowy

Wartości, które ten komponent publikuje konsumentom za pośrednictwem topologii uses.

NazwaTypWartość domyślnaWymaganeOpis
hoststring—takIn-cluster DNS name of the Service fronting the server. A publisher or subscriber puts this name in its client's server list together with `port`.
portinteger—takTCP port the server accepts client connections on. It carries the client port an operator set, never the monitoring port.
protocolstring—nieWire protocol the published address speaks — `nats`, which is what a consumer selects a client library for.

Gniazda uses

Gniazda zależności, przez które łączy się ten komponent. Cel każdego połączenia poprowadzonego przez gniazdo musi spełniać jego selektor etykiet, a każde połączenie może przenosić dołączenie w slotach deklarowanych przez gniazdo. Wymagany slot musi wypełnić każde połączenie, które encja Aggregate lub encja Release prowadzi przez gniazdo.

Nie zadeklarowano gniazd uses.

Sloty dołączania

Nazwane punkty wiązania, w których encja Feature dołącza się do tego komponentu. Selektor slotu ogranicza, która encja Feature może go wypełnić, a jego lista inject określa, jak można dostarczyć materiał encji Feature. Wymagany slot musi być powiązany w każdej instancji, przez dołączenie w instancji lub w zakresie nad nią, a slot wrażliwy jest zadeklarowany do obsługi materiału tajnego. Encja Feature może również dołączyć się pod nazwą, której nie deklaruje żaden slot.

SlotSelektorWymaganeWstrzykiwanieWrażliweOpis
passwordfeature.aggrega.ai/kind=secretnieenvtakOptional server authentication credential. When attached, enables NATS user/password authentication and supplies the password; unattached, the server runs without authentication.

Lista dozwolonych samowstrzyknięć

env

Relacje

Typowane krawędzie do innych opublikowanych encji i od nich. Odwołanie bez opublikowanego celu jest renderowane jako przerwana krawędź, a nie jako łącze.

Używa

Ta encja nie używa niczego z katalogu.

Używane przez

Dokumentacja pojęcia Component →

Katalog Aggrega — otwarty indeks komponentów, funkcji, receptur oraz wtyczek, które je renderują.

Zbudowano przy użyciu wspólnego systemu projektowego Aggrega.

Prywatność