tenzer/dynalite

tenzer/dynalite

镜像概述和主要用途

tenzer/dynalite是一个基于Alpine Linux的最小化Docker镜像，内置Dynalite工具。Dynalite是一款Node.js服务器，旨在模拟AWS DynamoDB的功能，可用于测试环境或其他需要使用DynamoDB但无需在AWS中搭建实际环境的场景。该镜像体积轻量，部署便捷，适合本地开发、单元测试或CI/CD流程中快速构建DynamoDB模拟服务。

核心功能和特性

轻量基础

• 基于Alpine Linux构建，镜像体积小，资源占用低，启动速度快。

DynamoDB模拟

• 内置Dynalite，可准确模拟AWS DynamoDB的核心API和行为，支持创建表、插入数据、查询等常见操作。

数据持久化

• 镜像默认配置了卷挂载路径/var/lib/dynalite，容器重启后数据不会丢失，确保数据持久性。

灵活配置

• dynalite已集成到容器的ENTRYPOINT中，可通过命令参数直接传递Dynalite的额外配置（如端口、存储路径等）。

使用场景和适用范围

测试环境

• 开发或单元测试：无需依赖AWS账户，本地即可模拟DynamoDB进行功能测试。
• 集成测试：在CI/CD流程中快速部署模拟服务，验证应用与DynamoDB的交互逻辑。

本地开发

• 开发者无需配置AWS CLI或访问远程DynamoDB实例，直接在本地启动容器即可进行开发调试。

离线环境

• 在无网络或无法访问AWS的环境中，仍可使用DynamoDB相关功能。

使用方法和配置说明

基本使用（docker run）

启动Dynalite容器，默认端口为4567，数据存储在/var/lib/dynalite：

bash
docker run -d \
  --name dynalite \
  -p 4567:4567 \
  -v dynalite-data:/var/lib/dynalite \
  tenzer/dynalite

• -p 4567:4567：映射容器端口4567到主机，Dynalite默认监听此端口。
• -v dynalite-data:/var/lib/dynalite：创建命名卷dynalite-data挂载到容器的数据目录，确保数据持久化。

传递Dynalite参数

可通过命令参数自定义Dynalite配置，例如修改端口或存储路径：

bash
# 自定义端口为8000，存储路径为/data
docker run -d \
  --name dynalite-custom \
  -p 8000:8000 \
  -v dynalite-data:/data \
  tenzer/dynalite --port 8000 --path /data

Dynalite支持的参数可参考其官方文档：https://github.com/mhart/dynalite%E3%80%82

docker-compose配置示例

创建docker-compose.yml文件，简化多服务协同部署：

yaml
version: '3'
services:
  dynalite:
    image: tenzer/dynalite
    ports:
      - "4567:4567"
    volumes:
      - dynalite-data:/var/lib/dynalite
    restart: unless-stopped

volumes:
  dynalite-data:

启动服务：

bash
docker-compose up -d

数据持久化说明

容器内的/var/lib/dynalite目录已配置为卷挂载点，建议通过-v参数挂载命名卷或本地目录，避免容器删除后数据丢失。若无需持久化数据，可省略-v参数。

参考链接

• https://github.com/mhart/dynalite