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`.
Provenienza
- Digest del contenuto
- sha256:51cfc70f66981b6278f11ca14b45c4c912aeb97b5866fcfb82b2b4649a5a4b3b
- Pubblicato
- 2026-11-10T10:10:41Z
- Identità di firma
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
Firma
- Ufficialeapplication/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
Riferimento a questa versione
oci://hub.aggrega.ai/component/core/datastore/etcd:1.0.0Parametri dello sviluppatore
Valori che lo sviluppatore imposta nell’Aggregate.
| Nome | Tipo | Predefinito | Obbligatorio | Descrizione |
|---|---|---|---|---|
| name | string | node1 | no | etcd member name (ETCD_NAME). Names the single node in the initial cluster. |
Dimensionamento dell’operatore
Dimensionamento dell’infrastruttura che l’operatore regola per ogni ambiente.
| Nome | Tipo | Predefinito | Obbligatorio | Descrizione |
|---|---|---|---|---|
| client_port | integer (min 1024, max 65535) | 2379 | no | 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 | no | 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 | no | etcd version (the etcd image tag). |
| compute | object | — | no | — |
| storage | object | — | no | — |
| auto_compaction_retention | string | 1 | no | 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 | — | no | 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) | — | no | Provider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads. |
Contratto di output
Valori che questo componente pubblica verso i consumatori attraverso la topologia uses.
| Nome | Tipo | Predefinito | Obbligatorio | Descrizione |
|---|---|---|---|---|
| host | string | — | sì | 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 | — | sì | 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 | — | no | How the published address is spoken to — `http`, the scheme a client composes its endpoint list on. |
| metrics_endpoint | string | — | no | 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. |
Socket uses
I socket di dipendenza attraverso cui questo componente si connette. La destinazione di ogni connessione collegata attraverso un socket deve soddisfare il suo selettore di etichette, e ogni connessione può portare un aggancio negli slot che il socket dichiara. Uno slot obbligatorio deve essere riempito da ogni connessione che l’Aggregate o la Release collega attraverso il socket.
Nessun socket uses dichiarato.
Slot di aggancio
Punti di associazione con nome in cui una Feature si aggancia a questo componente. Il selettore di uno slot limita quale Feature può riempirlo e la sua lista inject indica come può essere consegnato il materiale della Feature. Uno slot obbligatorio deve essere associato su ogni istanza, da un aggancio sull’istanza o a un ambito superiore, e uno slot sensibile è dichiarato per gestire materiale segreto. Una Feature può anche agganciarsi con un nome che nessuno slot dichiara.
Nessuno slot di aggancio dichiarato.
Elenco consentito di auto-iniezione
env
Relazioni
Archi tipizzati da e verso altre entità pubblicate. Un riferimento senza una destinazione pubblicata viene mostrato come arco interrotto anziché come link.
Usa
Questa entità non usa nulla del catalogo.
Usato da
usa il socket «backend»
usa il socket «cache»
usa il socket «queue»
usa il socket «backend»
usa il socket «cache»
usa il socket «queue»
usa il socket «backend»
usa il socket «backend»
usa il socket «cache»
usa il socket «queue»
usa il socket «backend»
usa il socket «cache»
usa il socket «queue»
usa il socket «backend»
usa il socket «cache»
usa il socket «queue»
usa il socket «backend»
usa il socket «cache»
usa il socket «backend»
usa il socket «cache»
usa il socket «backend»
usa il socket «cache»
usa il socket «backend»
usa il socket «cache»
usa il socket «backend»
usa il socket «cache»
usa il socket «backend»
usa il socket «cache»
usa il socket «backend»
usa il socket «cache»
usa il socket «state_store»
usa il socket «checkpointer_db»
usa il socket «checkpointer_db»
usa il socket «backend»
usa il socket «backend»
usa il socket «backend»
usa il socket «storage»
usa il socket «metadata_store»
usa il socket «target_datastore»
usa il socket «backend»
usa il socket «databases»
usa il socket «etcd»
usa il socket «backend»
usa il socket «backend»
usa il socket «cache»
usa il socket «state_store»
usa il socket «forward_target»
usa il socket «backend»
usa il socket «cache»
usa il socket «chunk_cache»
usa il socket «scrape_target»
usa il socket «backend»
usa il socket «backend»
usa il socket «database»
si applica a
si applica a
si applica a
implementa
implementa