instructure/dynamo-local-admin

DynamoDB Local Admin Docker镜像文档

镜像概述和主要用途

本Docker镜像集成了http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DynamoDBLocal.html%E5%92%8Chttps://github.com/aaronshaf/dynamodb-admin%E5%B7%A5%E5%85%B7%EF%BC%8C%E6%97%A8%E5%9C%A8%E4%B8%BADynamoDB%E5%BC%80%E5%8F%91%E8%80%85%E6%8F%90%E4%BE%9B%E4%BE%BF%E6%8D%B7%E7%9A%84%E6%9C%AC%E5%9C%B0%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83%E3%80%82%E9%80%9A%E8%BF%87%E8%AF%A5%E9%95%9C%E5%83%8F%EF%BC%8C%E7%94%A8%E6%88%B7%E5%8F%AF%E5%9C%A8%E6%9C%AC%E5%9C%B0%E5%BF%AB%E9%80%9F%E5%90%AF%E5%8A%A8DynamoDB%E6%9C%8D%E5%8A%A1%E5%8F%8A%E9%85%8D%E5%A5%97%E7%9A%84Web%E7%AE%A1%E7%90%86%E7%95%8C%E9%9D%A2%EF%BC%8C%E6%97%A0%E9%9C%80%E4%BE%9D%E8%B5%96AWS%E4%BA%91%E6%9C%8D%E5%8A%A1%EF%BC%8C%E7%AE%80%E5%8C%96%E5%BC%80%E5%8F%91%E4%B8%8E%E6%B5%8B%E8%AF%95%E6%B5%81%E7%A8%8B%E3%80%82

核心功能和特性

• 集成DynamoDB Local：内置AWS官方本地DynamoDB服务，支持所有DynamoDB API操作，数据存储于本地文件系统。
• Web管理界面：包含dynamodb-admin工具，提供可视化界面，支持表创建、数据增删改查、索引管理等操作。
• 智能请求代理：内置请求路由机制，自动区分DynamoDB API请求（如AWS SDK调用）和Web管理界面请求，分别代理至对应服务端口。
• 轻量化部署：单镜像封装所有依赖，无需手动配置服务间通信，一键启动即可使用。

使用场景和适用范围

• DynamoDB本地开发：适用于需要在本地编写、调试DynamoDB相关代码的开发者。
• 功能测试：可作为单元测试、集成测试的本地数据库环境，避免影响云环境数据。
• 学习与演示：供新手学习DynamoDB操作，或演示DynamoDB功能而无需AWS账号。

详细使用方法和配置说明

1. 前提条件

• 已安装Docker引擎（支持Docker Desktop或Docker Engine）。
• （可选）AWS CLI工具（用于测试DynamoDB API请求）。

2. 拉取镜像

通过Docker Hub拉取官方镜像：

bash
docker pull docker.xuanyuan.run/instructure/dynamo-local-admin

3. 基本启动方法

使用以下命令启动容器，映射容器8000端口至本地8000端口：

bash
docker run -p 8000:8000 -it --rm docker.xuanyuan.run/instructure/dynamo-local-admin

• -p 8000:8000：端口映射，本地8000端口对应容器内服务端口。
• -it：交互式运行，支持终端输出日志。
• --rm：容器停止后自动删除，避免残留容器文件。

4. 访问Web管理界面

容器启动后，通过浏览器访问以下地址打开dynamodb-admin管理界面：

http://localhost:8000

界面支持表管理、数据浏览、查询执行等功能，直观展示本地DynamoDB数据。

5. 发送DynamoDB API请求

可通过AWS SDK或AWS CLI直接向本地DynamoDB服务发送API请求，示例如下（使用AWS CLI）：

bash
# 设置AWS凭证（本地开发无需真实凭证，仅需非空值）
export AWS_ACCESS_KEY_ID=localkey
export AWS_SECRET_ACCESS_KEY=localsecret

# 列出所有表（示例API请求）
aws --region us-east-1 dynamodb --endpoint-url http://localhost:8000 list-tables

• --endpoint-url http://localhost:8000：指定本地DynamoDB服务地址。
• 本地开发无需真实AWS凭证，AWS_ACCESS_KEY_ID和AWS_SECRET_ACCESS_KEY可设为任意非空值。

6. Dinghy用户特殊配置

若使用Dinghy（Docker桌面工具，提供自动代理功能），容器已默认配置VIRTUAL_HOST和VIRTUAL_PORT环境变量，无需手动映射端口。直接通过以下地址访问管理界面：

http://dynamo.docker

注意事项

• 数据持久化：默认情况下，DynamoDB数据存储于容器内临时目录，容器删除后数据丢失。如需持久化，可通过-v参数挂载本地目录至容器内DynamoDB数据路径（默认数据路径为/var/dynamodb_local）：

  bash
  docker run -p 8000:8000 -v ./dynamodb-data:/var/dynamodb_local -it --rm docker.xuanyuan.run/instructure/dynamo-local-admin
  

• 端口冲突：若本地8000端口已被占用，可修改端口映射（如-p 9000:8000将本地9000端口映射至容器8000端口）。