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
- 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.0Paramètres du développeur
Valeurs que le développeur définit dans l’Aggregate.
| Nom | Type | Valeur par défaut | Obligatoire | Description |
|---|---|---|---|---|
| user | string | nats_client | non | Client 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.
| Nom | Type | Valeur par défaut | Obligatoire | Description |
|---|---|---|---|---|
| port | integer (min 1024, max 65535) | 4222 | non | Client listen port. Most operators should omit this and let the Recipe assign the default (4222). |
| monitoring_port | integer (min 1024, max 65535) | 8222 | non | HTTP 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_version | string | 2.11-alpine | non | NATS container image tag. Selects the image tag on container targets; the chart-backed realization pins its own image tag. |
| source_version | string | — | non | Version 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. |
| compute | object | — | non | — |
| overrides | object (open) | — | non | Provider-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.
| Nom | Type | Valeur par défaut | Obligatoire | Description |
|---|---|---|---|---|
| host | string | — | oui | In-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`. |
| port | integer | — | oui | TCP port the server accepts client connections on. It carries the client port an operator set, never the monitoring port. |
| protocol | string | — | non | Wire 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.
| Emplacement | Sélecteur | Obligatoire | Injection | Sensible | Description |
|---|---|---|---|---|---|
| password | feature.aggrega.ai/kind=secret | non | env | oui | Optional 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
utilise le socket « media_server »
utilise le socket « target_messaging »
utilise le socket « upstream »
utilise le socket « media_server »
utilise le socket « forward_target »
utilise le socket « scrape_target »
utilise le socket « store »
s’applique à
s’applique à
s’applique à
s’applique à
s’applique à
s’applique à
s’applique à
implémente
implémente
implémente