motoserver/moto

Moto 官方Docker镜像

概述

Moto项目的官方Docker镜像，用于部署Moto Server。Moto是一款开源工具，核心功能是提供本地内存中的AWS服务模拟环境，帮助开发者在不依赖真实AWS账户的情况下，测试与AWS SDK的交互逻辑。该镜像轻量高效，可快速启动本地AWS模拟服务，适用于开发、测试及CI/CD场景。

核心功能与特性

• 本地AWS服务模拟：无需连接真实AWS环境，在本地提供S3、EC2、Lambda等多种AWS服务的API模拟实现
• 内存数据存储：所有模拟数据存储在内存中，测试结束后自动清除，确保测试环境隔离性
• AWS SDK兼容：完全兼容AWS SDK标准调用方式，无需修改现有代码即可切换测试环境
• 轻量级部署：基于Docker容器化设计，启动速度快，资源占用低，支持跨平台运行
• 多服务覆盖：支持超过30种AWS核心服务模拟，满足各类云服务交互测试需求

使用场景

• 开发环境调试：本地验证AWS SDK代码逻辑，无需访问真实云服务
• 自动化测试集成：嵌入CI/CD流程，实现AWS相关功能的自动化测试
• 离线功能验证：在无网络环境下测试AWS服务依赖的应用功能
• 成本控制：避免因测试产生真实AWS资源费用，降低开发成本

使用方法

基本运行命令

通过以下命令启动默认配置的Moto Server（监听5000端口）：

bash
docker run -p 5000:5000 docker.xuanyuan.run/motoserver/moto

自定义配置

指定端口与地址

通过环境变量自定义服务监听端口和绑定地址：

bash
docker run -p 8080:8080 -e MOTO_PORT=8080 -e MOTO_HOST=0.0.0.0 docker.xuanyuan.run/motoserver/moto

数据持久化配置

默认使用内存存储，如需持久化数据可配置文件后端：

bash
docker run -p 5000:5000 \
  -v $(pwd)/moto-data:/data \
  -e MOTO_BACKEND=file \
  -e MOTO_FILE_PATH=/data \
  docker.xuanyuan.run/motoserver/moto

Docker Compose配置

创建docker-compose.yml文件整合服务配置：

yaml
version: '3'
services:
  moto:
    image: docker.xuanyuan.run/motoserver/moto
    ports:
      - "5000:5000"
    environment:
      - MOTO_PORT=5000
      - MOTO_REGION=us-west-2
    # 可选：持久化数据卷
    # volumes:
    #   - ./moto-data:/data

启动服务：

bash
docker-compose up -d

服务验证

服务启动后，通过健康检查接口验证运行状态：

bash
curl http://localhost:5000/health  # 返回"OK"表示服务正常

配置参数

官方文档

完整使用说明请参考：Moto Docker部署文档