分布式事务性键值数据库镜像文档

镜像概述

本镜像提供一个分布式事务性键值数据库的运行环境。该数据库采用分布式架构设计，支持事务ACID特性，以键值对形式组织数据，适用于需要在分布式系统中实现高一致性、高可用数据存储的场景。

核心功能和特性

• 分布式架构：支持多节点集群部署，数据自动分片与复制，提升系统吞吐量与容错能力。
• 事务支持：提供完整的ACID事务保证，支持分布式事务协调，确保跨节点数据操作的一致性。
• 键值数据模型：采用简单高效的键值存储结构，支持键的范围查询、前缀匹配等操作。
• 高可用性：通过多副本机制实现数据冗余，节点故障时自动切换，保障服务持续可用。
• 可扩展性：支持动态扩容，新节点加入时自动负载均衡，无需中断服务。
• 数据持久化：采用日志与快照结合的持久化策略，确保数据不丢失。

使用场景和适用范围

• 分布式系统数据存储：作为微服务架构中的共享数据层，存储服务间交互的核心业务数据。
• 事务性业务场景：适用于***交易、订单处理、库存管理等需要严格事务保证的业务。
• 高并发读写场景：支持高吞吐量的键值读写操作，满足实时数据访问需求。
• 跨地域部署：支持多区域集群部署，降低数据访问延迟，提升全球用户体验。

使用方法和配置说明

获取镜像

通过Docker Hub或私有仓库拉取镜像：

bash
docker pull [镜像仓库地址]/distributed-tx-kvdb:latest

基本使用（单节点模式）

启动命令

bash
docker run -d \
  --name tx-kvdb-node1 \
  -p 2379:2379 \
  -v /data/kvdb/node1:/var/lib/kvdb \
  -e NODE_NAME=node1 \
  -e LISTEN_ADDR=0.0.0.0:2379 \
  -e TRANSACTION_ISOLATION=READ_COMMITTED \
  [镜像仓库地址]/distributed-tx-kvdb:latest

参数说明

• -p 2379:2379：映射容器端口到主机，2379为默认客户端通信端口。
• -v /data/kvdb/node1:/var/lib/kvdb：挂载主机目录作为数据持久化存储路径。
• NODE_NAME：节点名称，用于集群识别（单节点模式可省略）。
• LISTEN_ADDR：节点监听地址，默认0.0.0.0:2379。
• TRANSACTION_ISOLATION：事务隔离级别，可选值：READ_UNCOMMITTED、READ_COMMITTED（默认）、REPEATABLE_READ、SERIALIZABLE。

集群模式部署（docker-compose示例）

创建docker-compose.yml文件：

yaml
version: '3'
services:
  node1:
    image: [镜像仓库地址]/distributed-tx-kvdb:latest
    container_name: tx-kvdb-node1
    ports:
      - "2379:2379"
      - "2380:2380"  # 集群通信端口
    volumes:
      - ./data/node1:/var/lib/kvdb
    environment:
      - NODE_NAME=node1
      - LISTEN_ADDR=0.0.0.0:2379
      - CLUSTER_LISTEN_ADDR=0.0.0.0:2380
      - CLUSTER_NODES=node1:2380,node2:2380,node3:2380
      - INITIAL_CLUSTER_STATE=new  # 首次启动为new，后续为existing

  node2:
    image: [镜像仓库地址]/distributed-tx-kvdb:latest
    container_name: tx-kvdb-node2
    ports:
      - "2381:2379"
      - "2382:2380"
    volumes:
      - ./data/node2:/var/lib/kvdb
    environment:
      - NODE_NAME=node2
      - LISTEN_ADDR=0.0.0.0:2379
      - CLUSTER_LISTEN_ADDR=0.0.0.0:2380
      - CLUSTER_NODES=node1:2380,node2:2380,node3:2380
      - INITIAL_CLUSTER_STATE=new

  node3:
    image: [镜像仓库地址]/distributed-tx-kvdb:latest
    container_name: tx-kvdb-node3
    ports:
      - "2383:2379"
      - "2384:2380"
    volumes:
      - ./data/node3:/var/lib/kvdb
    environment:
      - NODE_NAME=node3
      - LISTEN_ADDR=0.0.0.0:2379
      - CLUSTER_LISTEN_ADDR=0.0.0.0:2380
      - CLUSTER_NODES=node1:2380,node2:2380,node3:2380
      - INITIAL_CLUSTER_STATE=new

启动集群：

bash
docker-compose up -d

配置参数说明