tigrisdata/kvrocks

Apache Kvrocks 镜像文档

镜像概述

Apache Kvrocks 是一款开源的分布式键值NoSQL数据库，以RocksDB作为底层存储引擎。它兼容Redis协议，结合了Redis的高性能与RocksDB的高效持久化能力，适用于需要处理大规模键值数据且对数据持久性有要求的场景。

核心功能和特性

• 分布式架构：支持集群部署，具备水平扩展能力，可应对大规模数据存储需求
• Redis协议兼容：兼容多数Redis命令，可无缝对接现有Redis客户端
• 高性能存储：基于RocksDB引擎，提供高效的读写性能和磁盘空间利用率
• 数据持久化：支持数据持久化到磁盘，确保服务重启后数据不丢失
• 多数据结构支持：支持字符串、哈希、列表、集合等多种键值数据结构

使用场景和适用范围

• 缓存系统：作为分布式缓存层，提升应用访问速度
• 实时数据存储：适用于需要高并发读写的实时数据场景（如计数器、会话存储）
• 日志与指标存储：可高效存储和查询大量时序数据或日志记录
• 分布式应用状态存储：为分布式系统提供共享状态存储支持

使用方法和配置说明

基本使用（Docker Run）

bash
# 拉取镜像（假设官方镜像名为apache/kvrocks，实际请替换为正确镜像名）
docker pull apache/kvrocks

# 运行容器
docker run -d \
  --name kvrocks \
  -p 6666:6666 \
  -v /path/to/local/data:/data \
  apache/kvrocks

Docker Compose 配置示例

yaml
version: '3'
services:
  kvrocks:
    image: apache/kvrocks
    container_name: kvrocks
    ports:
      - "6666:6666"
    volumes:
      - ./kvrocks-data:/data
    restart: always
    environment:
      - KVROCKS_PORT=6666  # 服务端口
      - KVROCKS_DATA_DIR=/data  # 数据存储目录

关键配置参数

集群部署说明

Kvrocks支持主从复制和分片集群，具体配置需通过修改配置文件实现。可通过挂载自定义配置文件进行集群配置：

bash
docker run -d \
  --name kvrocks-cluster-node \
  -p 6666:6666 \
  -v /path/to/local/config:/etc/kvrocks \
  -v /path/to/local/data:/data \
  apache/kvrocks -c /etc/kvrocks/kvrocks.conf