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

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.

Provenance

OfficielSigné par une identité de signature que ce catalogue reconnaît comme éditeur officiel.
Empreinte du contenu
sha256:6442f87145c50476deb4c047562136eece91faa7a3ebc101d7ec4458916f1e5e
Publié
2026-11-10T10:12:28Z
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:90bd8f7234f43e27af901a28509adea5872dc136a2a8965ba80f287a2ee77ce2

Référence à cette version

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

Paramètres du développeur

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

NomTypeValeur par défautObligatoireDescription
userstringnats_clientnonClient 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.

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)4222nonClient listen port. Most operators should omit this and let the Recipe assign the default (4222).
monitoring_portinteger (min 1024, max 65535)8222nonHTTP 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-alpinenonNATS container image tag. Selects the image tag on container targets; the chart-backed realization pins its own image tag.
source_versionstring—nonVersion 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—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 server. A publisher or subscriber puts this name in its client's server list together with `port`.
portinteger—ouiTCP port the server accepts client connections on. It carries the client port an operator set, never the monitoring port.
protocolstring—nonWire protocol the published address speaks — `nats`, which is what a consumer selects a client library for.

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.

Aucun socket uses déclaré.

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.

EmplacementSélecteurObligatoireInjectionSensibleDescription
passwordfeature.aggrega.ai/kind=secretnonenvouiOptional server authentication credential. When attached, enables NATS user/password authentication and supplies the password; unattached, the server runs without authentication.

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

Cette entité n’utilise rien du catalogue.

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é