S3#

一个 L2 适配器，使用 AWS 通用运行时 (CRT) 将 KV cache 对象存储为 S3 对象。支持 AWS S3、S3 Express One Zone 以及任何兼容 S3 的端点（MinIO、Ceph RGW 等）。

必填字段：

  • s3_endpoint: 存储桶 URL -- 可以是 "s3://<bucket>" 或纯主机名形式（用于非 AWS 端点）。

  • s3_region: AWS 区域字符串（例如 "us-west-2"）。

可选字段：

  • s3_num_io_threads (int, default 64): CRT I/O 线程数。

  • s3_prefer_http2 (bool, default true): 通过 ALPN 协商 HTTP/2。

  • s3_enable_s3express (bool, default false): 为 S3 Express 单可用区存储桶启用 S3 Express 签名。

  • disable_tls (bool, default false): 在指向普通 HTTP 端点时绕过 TLS（例如本地 MinIO）。

  • aws_access_key_id / aws_secret_access_key （字符串）：静态凭证；若两者均省略，则使用 AWS 默认凭证提供链（环境变量、EC2 实例配置等）。

  • max_capacity_gb (浮点数，默认 0.0)：由 get_usage() 使用的总容量。值为 0 时禁用总逐出（usage_fraction == -1.0）。

配置示例：

# AWS S3 with default credentials
--l2-adapter '{"type": "s3", "s3_endpoint": "s3://my-bucket", "s3_region": "us-west-2"}'

# Static credentials, HTTP/2 disabled
--l2-adapter '{"type": "s3", "s3_endpoint": "s3://my-bucket", "s3_region": "us-west-2", "s3_prefer_http2": false, "aws_access_key_id": "AKIA...", "aws_secret_access_key": "..."}'

# Local MinIO over plain HTTP
--l2-adapter '{"type": "s3", "s3_endpoint": "minio.local:9000", "s3_region": "us-east-1", "disable_tls": true, "aws_access_key_id": "minio", "aws_secret_access_key": "minio123"}'