Component
core/datastore/memcached
A Memcached in-memory key-value cache. Non-persistent by design: entries live in memory and are not durably stored, so the component renders as a stateless workload rather than a stateful one and declares no storage. Realized by a Helm Recipe (Workload synthesis to native Kubernetes resources), a Compose Recipe (local development), on Amazon ElastiCache and on Google Cloud Memorystore for Memcached. Exports its host and port to consumers via the uses topology. Reach for terraform/memcached-elasticache, or cloudformation/memcached-elasticache in a CloudFormation stack, where the cache is an ElastiCache service in the operator's AWS account; each halts naming each value ElastiCache cannot apply, and takes infra.engine_version as a full version ElastiCache offers, such as 1.6.22. Reach for terraform/memcached-memorystore where the cache is a Memorystore instance in the operator's Google Cloud project, whose VPC network has a private services access connection: one node, its address published, with no TLS and no authentication. Google is deprecating that service, which it shuts down on January 31, 2029. Encrypted client connections are an operator setting, `infra.client_tls`, off by default. Turned on, the cache serves TLS alone on its port and publishes `protocol` `memcached-tls`, so a consumer reading `protocol` learns that it must connect over TLS. On Kubernetes the server presents the Secret attached to the `server_certificate` slot, mounted as files, and asks no client for a certificate; ElastiCache presents a certificate AWS issues; the Compose and Memorystore realizations refuse the setting by name.
출처
- 콘텐츠 다이제스트
- sha256:a5e291f6d6b700bd97ba6c44d3c742e267b8e96552fb51763d9c2138225f389e
- 게시일
- 2026-11-10T10:10:48Z
- 서명 ID
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
서명
- 공식application/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:502454f8d9cd8280fa6c62043b00dc21c1134dc6503944e6d5d28305eb284630
이 버전의 참조
oci://hub.aggrega.ai/component/core/datastore/memcached:1.0.0개발자 매개변수
개발자가 Aggregate에서 설정하는 값입니다.
| 이름 | 타입 | 기본값 | 필수 | 설명 |
|---|---|---|---|---|
| user | string | cache | 아니요 | SASL authentication username. No realization reads it, since every one halts on an attached password. |
| memory_limit | integer (min 1) | — | 아니요 | Maximum memory for item storage, in megabytes (the memcached -m flag). Omit to use the memcached default (64). ElastiCache fixes it by the node type, so its realizations halt on it. Memorystore sets the limit to the node's memory, so terraform/memcached-memorystore sizes the node by it, 1024 to 262144 in whole GB, 1024 when omitted. |
| max_connections | integer (min 1) | — | 아니요 | Maximum number of simultaneous connections (the memcached -c flag). Omit to use the memcached default (1024). ElastiCache and Memorystore fix it at 65000, so their realizations halt on it. |
| threads | integer (min 1) | — | 아니요 | Number of worker threads (the memcached -t flag). Omit to use the memcached default (4). ElastiCache sets it by the node type, so its realizations halt on it. Memorystore sets the thread count to the node's vCPUs, so terraform/memcached-memorystore sizes the node by it, 1 to 32, 1 when omitted. |
| max_item_size | string | — | 아니요 | Maximum size of a single item (the memcached -I flag, e.g. 1m). Omit to use the memcached default (1m). ElastiCache takes it as a parameter, a whole multiple of 512k, and Memorystore too, up to 128m. |
운영자 사이징
운영자가 환경별로 조정하는 인프라 사이징입니다.
| 이름 | 타입 | 기본값 | 필수 | 설명 |
|---|---|---|---|---|
| port | integer (min 1024, max 65535) | 11211 | 아니요 | Server listen port. Most operators should omit this and let the Recipe assign the default (11211). Memorystore serves 11211 alone, so terraform/memcached-memorystore halts on any other value. |
| client_tls | boolean | false | 아니요 | Serve client connections over TLS alone. Off by default, which serves plaintext and renders exactly as a cache without the setting. On, the server serves TLS on `port`, presents the certificate attached to `server_certificate` (required while this is on), requests no client certificate, and the published `protocol` is `memcached-tls`. Served by the `memcached` Kubernetes realization; the Compose realization refuses it. On ElastiCache it turns on the service's in-transit encryption, from Memcached 1.6.12, whose certificate AWS issues and clients trust without a `server_ca`. Memorystore offers no encryption in transit, so its realization refuses it. |
| engine_version | string | 1.6-alpine | 아니요 | Memcached container image tag. Selects the image tag on container targets. The ElastiCache realizations read the version number the value begins with as the engine version, which ElastiCache takes in full, so the default halts there and the Release sets a version it offers, such as 1.6.22. Memorystore runs 1.5.16 and 1.6.15, the one release of each line it offers, so terraform/memcached-memorystore reads 1.6, the default's, as 1.6.15. |
| replicas | integer (min 1) | 1 | 아니요 | Number of cache nodes the cache runs; on ElastiCache, the cluster's node count. Memorystore gives each node an address of its own, and this component publishes one, so terraform/memcached-memorystore runs one node and halts above 1. |
| compute | object | — | 아니요 | — |
| overrides | object (open) | — | 아니요 | Provider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads. |
출력 계약
이 컴포넌트가 uses 토폴로지를 통해 소비자에게 게시하는 값입니다.
| 이름 | 타입 | 기본값 | 필수 | 설명 |
|---|---|---|---|---|
| host | string | — | 예 | Address a consumer puts in its client's server list, together with `port`: the in-cluster DNS name of the Service fronting the cache on Kubernetes, and on ElastiCache a pointer string Terraform or CloudFormation resolves to the cluster's configuration endpoint, on Memorystore a pointer Terraform resolves to the node's address, or the DNS name the Release sets in infra.overrides.host instead, so a consumer on another target receives an address it can resolve. |
| port | integer | — | 예 | TCP port the cache accepts connections on. It follows the port an operator set in the Release, or the one port the service serves on Memorystore, so a consumer reads it rather than assuming 11211. |
| protocol | string | — | 아니요 | Wire protocol the published address speaks — `memcached`, which is what a consumer selects a client for, while `infra.client_tls` is off, and `memcached-tls` while it is on, when the address accepts TLS connections alone. A client that reads only `host` and `port` reads this key too to learn that TLS is required: a plaintext client reaching a TLS listener fails its handshake and exchanges no command. |
uses 소켓
이 컴포넌트가 연결에 사용하는 의존성 소켓입니다. 소켓을 통해 배선되는 모든 연결의 대상은 해당 소켓의 레이블 셀렉터를 충족해야 하며, 각 연결은 소켓이 선언한 슬롯에 첨부를 전달할 수 있습니다. 필수 슬롯은 Aggregate 또는 Release가 해당 소켓을 통해 배선하는 각 연결이 채워야 합니다.
선언된 uses 소켓이 없습니다.
첨부 슬롯
Feature가 이 컴포넌트에 첨부되는 이름 있는 바인딩 지점입니다. 슬롯의 셀렉터는 어떤 Feature가 슬롯을 채울 수 있는지를 제한하고, 슬롯의 inject 목록은 Feature의 자료를 어떻게 전달할 수 있는지를 지정합니다. 필수 슬롯은 인스턴스의 첨부 또는 그 위 범위의 첨부를 통해 모든 인스턴스에서 바인딩되어야 하며, 민감 슬롯은 비밀 자료를 처리하도록 선언됩니다. Feature는 어떤 슬롯도 선언하지 않은 이름으로 첨부될 수도 있습니다.
| 슬롯 | 셀렉터 | 필수 | 주입 | 민감 | 설명 |
|---|---|---|---|---|---|
| password | feature.aggrega.ai/kind=secret | 아니요 | env | 예 | Optional cache authentication credential. Every realization halts on an attachment, since none can enforce it: the memcached image the Kubernetes and Compose realizations run authenticates only through SASL over the binary protocol or an ASCII authentication file, which the catalog's Memcached clients do not use, and neither ElastiCache nor Memorystore for Memcached offers Memcached authentication. Unattached, the cache runs without authentication. |
| server_certificate | feature.aggrega.ai/kind=secret | 아니요 | file | 예 | Optional certificate the cache presents to its clients while infra.client_tls is true: a Secret holding tls.crt, the certificate followed by any intermediate certificates, and tls.key, its private key, the two keys a kubernetes.io/tls Secret holds. The certificate names every address a client dials: the published host, and its namespace-qualified forms where clients in other namespaces connect. Mounted as files, so attach a Feature that names an existing Secret, such as core/referenced-secret. Required by the Kubernetes realization while client_tls is true; a build halts on it attached while client_tls is false. ElastiCache presents a certificate AWS issues and Memorystore serves no TLS, so their realizations halt on any attachment here. |
자체 주입 허용 목록
env
관계
게시된 다른 엔터티와 주고받는 타입 지정 에지입니다. 게시된 대상이 없는 참조는 링크가 아닌 끊어진 에지로 표시됩니다.
사용함
이 엔터티는 카탈로그의 어떤 것도 사용하지 않습니다.
사용됨
소켓 «backend» 사용
소켓 «cache» 사용
소켓 «queue» 사용
소켓 «backend» 사용
소켓 «cache» 사용
소켓 «queue» 사용
소켓 «backend» 사용
소켓 «backend» 사용
소켓 «cache» 사용
소켓 «queue» 사용
소켓 «backend» 사용
소켓 «cache» 사용
소켓 «queue» 사용
소켓 «backend» 사용
소켓 «cache» 사용
소켓 «queue» 사용
소켓 «backend» 사용
소켓 «cache» 사용
소켓 «backend» 사용
소켓 «cache» 사용
소켓 «backend» 사용
소켓 «cache» 사용
소켓 «backend» 사용
소켓 «cache» 사용
소켓 «backend» 사용
소켓 «cache» 사용
소켓 «backend» 사용
소켓 «cache» 사용
소켓 «backend» 사용
소켓 «cache» 사용
소켓 «state_store» 사용
소켓 «checkpointer_db» 사용
소켓 «checkpointer_db» 사용
소켓 «backend» 사용
소켓 «backend» 사용
소켓 «backend» 사용
소켓 «storage» 사용
소켓 «metadata_store» 사용
소켓 «target_datastore» 사용
소켓 «cache_store» 사용
소켓 «cache» 사용
소켓 «cache» 사용
소켓 «cache_store» 사용
소켓 «upstream» 사용
소켓 «cache» 사용
소켓 «cache_store» 사용
소켓 «cache» 사용
소켓 «state_store» 사용
소켓 «state_store» 사용
소켓 «forward_target» 사용
소켓 «backend» 사용
소켓 «cache» 사용
소켓 «chunk_cache» 사용
소켓 «scrape_target» 사용
소켓 «store» 사용
소켓 «backend» 사용
적용 대상
적용 대상
적용 대상
적용 대상
적용 대상
적용 대상
적용 대상
구현
구현
구현
구현
구현