如何在Docker容器启动时自动创建DynamoDB Local表

阿华AIGC实验室

2026-5-12

最优方案：基于官方镜像的自定义初始化脚本

Hey there! 针对你想用DynamoDB Local容器启动时自动创建表的需求，业内最常用也最灵活的方案是基于官方amazon/dynamodb-local镜像，搭配自定义初始化脚本——完全不需要重新构建镜像就能适配表结构的变更，完美匹配你不想重复构建镜像的诉求。下面我给你详细拆解实现步骤：

核心思路

我们不需要重新构建包含AWS CLI的镜像，而是直接在官方镜像的基础上，通过挂载初始化脚本和表结构JSON文件，让容器启动时先执行初始化逻辑（创建表），再启动DynamoDB Local服务。这种方式既保留了官方镜像的更新便利性，又能灵活调整表结构。

步骤1：准备表结构JSON文件

创建一个init-tables目录，把每个表的结构定义成独立的JSON文件（单文件单表更易维护）。示例user-table.json内容如下：

{
  "TableName": "User",
  "KeySchema": [
    { "AttributeName": "userId", "KeyType": "HASH" }
  ],
  "AttributeDefinitions": [
    { "AttributeName": "userId", "AttributeType": "S" }
  ],
  "ProvisionedThroughput": {
    "ReadCapacityUnits": 5,
    "WriteCapacityUnits": 5
  }
}

步骤2：编写初始化脚本

创建init-dynamodb.sh脚本，完成以下几件事：

安装依赖（AWS CLI、jq，用于表名判断）
遍历所有表结构文件，判断表是否已存在，不存在则创建
启动DynamoDB Local服务

脚本内容：

#!/bin/sh

# 安装必要依赖（适配官方镜像的Alpine系统）
apk add --no-cache python3 py3-pip jq
pip install awscli

# 遍历初始化目录下的所有JSON表结构文件
for TABLE_FILE in /init-tables/*.json; do
    # 从JSON中提取表名
    TABLE_NAME=$(jq -r '.TableName' "$TABLE_FILE")
    echo "Checking status of table: $TABLE_NAME"

    # 判断表是否已存在，不存在则创建
    if ! aws dynamodb describe-table \
        --endpoint-url http://localhost:8000 \
        --region us-east-1 \
        --table-name "$TABLE_NAME" > /dev/null 2>&1; then
        echo "Creating table $TABLE_NAME..."
        aws dynamodb create-table \
            --endpoint-url http://localhost:8000 \
            --region us-east-1 \
            --cli-input-json "file://$TABLE_FILE"
        echo "Table $TABLE_NAME created successfully!"
    else
        echo "Table $TABLE_NAME already exists, skipping creation."
    fi
done

# 启动DynamoDB Local（保留官方默认参数，可根据需求调整）
exec java -jar DynamoDBLocal.jar -sharedDb -dbPath /data

步骤3：用Docker Compose启动服务

推荐用Docker Compose来管理，配置更清晰且易维护。创建docker-compose.yml：

version: '3.8'
services:
  dynamodb-local:
    image: amazon/dynamodb-local:latest
    container_name: dynamodb-local
    ports:
      - "8000:8000"
    volumes:
      # 挂载表结构目录
      - ./init-tables:/init-tables
      # 挂载初始化脚本
      - ./init-dynamodb.sh:/init-dynamodb.sh
      # 挂载数据卷持久化数据（可选，避免重启丢失数据）
      - dynamodb-data:/data
    # 替换默认entrypoint，先执行初始化脚本
    entrypoint: ["/bin/sh", "/init-dynamodb.sh"]
volumes:
  dynamodb-data:

使用方式

把init-tables目录、init-dynamodb.sh和docker-compose.yml放在同一目录下
执行docker-compose up -d启动容器
新增表时，只需要在init-tables目录添加新的JSON文件，重启容器即可（docker-compose restart dynamodb-local）