saidsef/aws-dynamodb-local

Docker DynamoDB Local

镜像概述和主要用途

Docker DynamoDB Local是一个用于本地部署AWS DynamoDB的Docker镜像，旨在为开发和测试提供本地DynamoDB环境，避免依赖AWS云服务，降低开发测试成本，提高开发效率。该镜像基于OpenJDK 8构建，包含DynamoDB Local组件，可快速在本地环境启动DynamoDB服务。

核心功能和特性

• 本地部署：无需依赖AWS云服务，可在本地环境独立运行DynamoDB服务
• 轻量高效：基于OpenJDK 8构建，体积小巧，启动快速
• 完整兼容：提供与AWS DynamoDB一致的API接口，支持DynamoDB的核心功能
• 组件组成：
  • OpenJDK v8
  • AWS DynamoDB Local

使用场景和适用范围

• 开发环境：开发人员在本地开发DynamoDB相关应用时，无需连接AWS云服务
• 测试环境：自动化测试、集成测试中使用，确保测试环境一致性
• 离线场景：在无网络或需要离线工作的环境中使用DynamoDB
• 教学和演示：学习DynamoDB功能或进行技术演示时使用

详细使用方法和配置说明

Kubernetes部署

可通过以下命令部署到Kubernetes集群：

bash
kubectl apply -f deployment/

或通过ArgoCD部署：

bash
kubectl apply -f argocd/argocd-application.yml

部署后，可通过以下命令验证服务（需替换pod-ip为实际Pod IP）：

shell
aws --endpoint-url=http://pod-ip dynamodb list-tables --region local

Docker部署

通过Docker直接运行镜像：

shell
docker run -d -p 8000:8000 saidsef/aws-dynamodb-local

• -d：后台运行容器
• -p 8000:8000：将容器的8000端口映射到主机的8000端口，DynamoDB服务默认监听8000端口

使用示例

创建数据表

使用AWS CLI创建DynamoDB表（需确保本地已安装AWS CLI）：

shell
aws dynamodb create-table \
  --table-name TableName  \
  --attribute-definitions \
    AttributeName=id,AttributeType=S --key-schema \
    AttributeName=id,KeyType=HASH \
  --provisioned-throughput ReadCapacityUnits=2,WriteCapacityUnits=2 \
  --endpoint-url http://localhost:8000

• --endpoint-url http://localhost:8000：指定本地DynamoDB服务地址
• TableName：替换为实际表名
• id：主键属性名，类型为字符串(S)
• 读写吞吐量设置为2（本地环境不实际限制吞吐量，仅作API兼容）

SDK配置

在应用程序中使用AWS SDK连接本地DynamoDB时，需配置客户端端点：

shell
region: 'localhost',
endpoint: 'http://localhost:8000'

（具体配置方式因SDK语言不同略有差异，以上为配置示例）