DynamoDB Local Admin Docker镜像文档

镜像概述和主要用途

本Docker镜像集成了DynamoDB Local和dynamodb-admin工具，旨在为DynamoDB开发者提供便捷的本地开发环境。通过该镜像，用户可在本地快速启动DynamoDB服务及配套的Web管理界面，无需依赖AWS云服务，简化开发与测试流程。

核心功能和特性

• 集成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 instructure/dynamo-local-admin

3. 基本启动方法

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

bash
docker run -p 8000:8000 -it --rm 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环境变量，无需手动映射端口。直接通过以下地址访问管理界面：

[***]

注意事项

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

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

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