kraynezero/aws-dynamodb-local

AWS DynamoDB Local镜像

https://github.com/dhsu/docker-localdev/tree/master/aws-dynamodb-local

镜像概述

本镜像用于在本地运行AWS DynamoDB Local，采用“共享DB”模式（所有区域和凭据共用同一组表），服务暴露于8000端口，帮助开发者在本地环境快速搭建DynamoDB测试环境。

核心功能

1. 运行AWS DynamoDB Local服务，支持共享DB模式；
2. 暴露8000端口供本地客户端访问；
3. 支持通过挂载目录初始化表结构与数据：
   • 执行.sh脚本（可使用环境变量$DYNAMO_ENDPOINT_URL指向本地服务）；
   • 加载.json格式的表定义文件（符合AWS DynamoDB创建表的请求语法）。

使用场景

• 开发者本地测试DynamoDB应用逻辑，无需依赖AWS云服务；
• 快速验证表结构设计、数据操作及业务流程；
• 团队协作时统一本地测试环境配置。

配置说明

初始化数据

将包含初始化文件的主机目录挂载到容器的/bootstrap路径，镜像启动时自动执行初始化：

• .sh脚本示例：

  bash
  #!/bin/bash
  aws dynamodb create-table \
    --table-name mytable \
    --attribute-definitions AttributeName=id,AttributeType=S \
    --key-schema AttributeName=id,KeyType=HASH \
    --provisioned-throughput ReadCapacityUnits=5,WriteCapacityUnits=5 \
    --endpoint-url $DYNAMO_ENDPOINT_URL
  

• .json表定义示例：

  json
  {
    "TableName": "mytable",
    "KeySchema": [{"AttributeName": "id", "KeyType": "HASH"}],
    "AttributeDefinitions": [{"AttributeName": "id", "AttributeType": "S"}],
    "ProvisionedThroughput": {"ReadCapacityUnits":5,"WriteCapacityUnits":5}
  }
  

部署示例

Docker Run命令

bash
docker run -v /本地路径/bootstrap:/bootstrap -p 8000:8000 kraynezero/aws-dynamodb-local