richnorth/dynalite

dynalite镜像说明

镜像概述

本镜像基于https://github.com/mhart/dynalite%E9%A1%B9%E7%9B%AE%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%98%AFAmazon DynamoDB的本地实现，专注于正确性和性能，基于LevelDB存储。它旨在尽可能接近真实DynamoDB实例的行为，适用于开发和测试场景，避免依赖云服务资源。

核心功能

• 模拟DynamoDB的HTTP接口，完全兼容AWS SDK
• 支持LevelDB持久化存储（默认使用内存存储）
• 可配置表创建、删除、更新的状态转换时间
• 支持SSL启用、最大项大小限制等参数调整
• 与真实DynamoDB实例的错误信息和限制保持一致

使用场景

• 本地开发：无需连接AWS云服务即可测试DynamoDB相关代码逻辑
• CI/CD流水线：在自动化测试中快速启动模拟服务，验证数据操作
• 离线环境：无网络时验证DynamoDB操作的正确性

配置说明

命令行参数

• --port <port>：服务监听端口（默认4567）
• --path <path>：LevelDB存储路径（默认内存，指定路径可持久化）
• --ssl：启用SSL（默认false）
• --createTableMs <ms>：表创建状态持续时间（默认500ms）
• --deleteTableMs <ms>：表删除状态持续时间（默认500ms）
• --updateTableMs <ms>：表更新状态持续时间（默认500ms）
• --maxItemSizeKb <kb>：单个项的最大大小（默认400KB）

Docker部署示例

基本运行（内存存储）

sh
docker run -p 4567:4567 richnorth/dynalite:latest

持久化存储

sh
docker run -p 4567:4567 -v ./local-db:/data richnorth/dynalite:latest --path /data

自定义端口和参数

sh
docker run -p 8080:8080 richnorth/dynalite:latest --port 8080 --createTableMs 1000

AWS SDK连接示例

javascript
const AWS = require('aws-sdk');
const dynamo = new AWS.DynamoDB({ endpoint: 'http://localhost:4567' });
dynamo.listTables((err, data) => {
  if (err) console.error(err);
  else console.log('Tables:', data.TableNames);
});