Component
core/datastore/etcd
etcd, a distributed, strongly-consistent key-value store. This component runs a single-node etcd for development and lightweight coordination, holding its data on a persistent volume. It serves the v3 client API over HTTP with no authentication, suited to in-cluster consumers that need a simple consistent key-value store or configuration backend. Provider- agnostic: the same component is implemented by a Helm Recipe (synthesized manifests on Kubernetes) and a Compose Recipe (local development). Exports its host and client port to consumers via the uses topology. etcd serves its own metrics in the Prometheus format at /metrics on its client port, on by default, and every Recipe publishes that address as `metrics_endpoint`.
Provenance
- Empreinte du contenu
- sha256:51cfc70f66981b6278f11ca14b45c4c912aeb97b5866fcfb82b2b4649a5a4b3b
- Publié
- 2026-11-10T10:10:41Z
- 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:88b6b34aef79360e69c480a245d63d7cdb961295b03cd87069a700d79b5d5a8e
Référence à cette version
oci://hub.aggrega.ai/component/core/datastore/etcd: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 |
|---|---|---|---|---|
| name | string | node1 | non | etcd member name (ETCD_NAME). Names the single node in the initial cluster. |
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 |
|---|---|---|---|---|
| client_port | integer (min 1024, max 65535) | 2379 | non | Client API port consumers connect to. Most operators should omit this and let the Recipe assign the default (2379). |
| peer_port | integer (min 1024, max 65535) | 2380 | non | Peer port used for intra-cluster communication. Most operators should omit this and let the Recipe assign the default (2380). |
| engine_version | string | v3.5.32 | non | etcd version (the etcd image tag). |
| compute | object | — | non | — |
| storage | object | — | non | — |
| auto_compaction_retention | string | 1 | non | Auto-compaction retention for the key-value history (ETCD_AUTO_COMPACTION_RETENTION). Defaults to 1 hour of history; without periodic compaction the backend grows unbounded and eventually trips the storage quota, after which etcd accepts only reads. Realized on the synthesized Helm and Compose targets. |
| quota_backend_bytes | string | — | non | Backend storage quota in bytes (ETCD_QUOTA_BACKEND_BYTES). Omit to use the etcd default. When the backend database exceeds this size etcd raises a no-space alarm and accepts only reads until the history is compacted and the store defragmented. Realized on the synthesized Helm and Compose targets. |
| 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 client API. A consumer that watches or writes keys dials this name together with `port`. |
| port | integer | — | oui | TCP port that Service accepts client API requests on. It carries the client port an operator set, never the peer port, which is for members talking to each other. |
| protocol | string | — | non | How the published address is spoken to — `http`, the scheme a client composes its endpoint list on. |
| metrics_endpoint | string | — | non | The full address Prometheus scrapes this component's metrics at — scheme, host, port and path, `http://<host>:<port>/metrics` on the client port. Empty where the component serves none reachable. |
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.
Aucun emplacement d’attache déclaré.
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 « backend »
utilise le socket « cache »
utilise le socket « queue »
utilise le socket « backend »
utilise le socket « cache »
utilise le socket « queue »
utilise le socket « backend »
utilise le socket « backend »
utilise le socket « cache »
utilise le socket « queue »
utilise le socket « backend »
utilise le socket « cache »
utilise le socket « queue »
utilise le socket « backend »
utilise le socket « cache »
utilise le socket « queue »
utilise le socket « backend »
utilise le socket « cache »
utilise le socket « backend »
utilise le socket « cache »
utilise le socket « backend »
utilise le socket « cache »
utilise le socket « backend »
utilise le socket « cache »
utilise le socket « backend »
utilise le socket « cache »
utilise le socket « backend »
utilise le socket « cache »
utilise le socket « backend »
utilise le socket « cache »
utilise le socket « state_store »
utilise le socket « checkpointer_db »
utilise le socket « checkpointer_db »
utilise le socket « backend »
utilise le socket « backend »
utilise le socket « backend »
utilise le socket « storage »
utilise le socket « metadata_store »
utilise le socket « target_datastore »
utilise le socket « backend »
utilise le socket « databases »
utilise le socket « etcd »
utilise le socket « backend »
utilise le socket « backend »
utilise le socket « cache »
utilise le socket « state_store »
utilise le socket « forward_target »
utilise le socket « backend »
utilise le socket « cache »
utilise le socket « chunk_cache »
utilise le socket « scrape_target »
utilise le socket « backend »
utilise le socket « backend »
utilise le socket « database »
s’applique à
s’applique à
s’applique à
implémente
implémente