amazon/dynamodb-local

DynamoDB local 镜像文档

1. 镜像概述与主要用途

DynamoDB local 是 DynamoDB 的本地可下载版本，允许开发人员在自己的开发环境中运行 DynamoDB 实例，用于开发和测试应用程序，无需依赖 AWS 云服务。

2. 核心功能与特性

• Docker 化部署：镜像内置所有依赖和必要配置，可快速启动本地 DynamoDB 实例。
• 离线运行：无需互联网连接即可使用，适合本地开发环境。
• API 兼容性：与现有 DynamoDB API 调用完全兼容，无需修改应用代码。
• 零成本：无预配置吞吐量、数据存储或数据传输费用。
• CI/CD 集成：可无缝集成到容器化构建流程和持续集成测试中。

3. 使用场景与适用范围

• 应用开发：本地开发环境中构建依赖 DynamoDB 的应用程序。
• 测试验证：进行单元测试、集成测试，验证数据操作逻辑。
• CI/CD 流程：作为持续集成/持续部署流程的一部分，自动化测试环节。

4. 使用方法与配置说明

4.1 基本运行命令

通过以下命令快速启动 DynamoDB local 容器：

bash
docker run -p 8000:8000 amazon/dynamodb-local

• -p 8000:8000：将容器的 8000 端口映射到主机的 8000 端口，DynamoDB local 默认通过 8000 端口提供服务。

4.2 访问与交互

容器启动后，可通过 http://localhost:8000 访问本地 DynamoDB 实例，使用 AWS SDK 或 DynamoDB API 进行数据操作（与云端 DynamoDB API 兼容）。

4.3 配置选项

详细配置说明可参考 AWS 官方文档：DynamoDB Local 使用说明。

4.4 环境变量注意事项

• AWS_ACCESS_KEY_ID：对于 DynamoDB local 2.0.0 及更高版本，该环境变量的值仅允许包含字母（A–Z、a–z）和数字（0–9）。

5. 参考资源

• 示例应用：https://github.com/aws-samples/aws-sam-java-rest%EF%BC%88%E6%BC%94%E7%A4%BA%E5%A6%82%E4%BD%95%E4%BD%BF%E7%94%A8 DynamoDB local 进行测试）。
• 官方文档：AWS DynamoDB Local 文档。