leadfeeder/localstack

LocalStack-Moto 镜像文档

镜像概述

该Docker镜像整合了LocalStack与Moto（特定commit: 1095b7d94bdd46b1bb2dbff0122994baf94f2eeb），提供本地AWS服务模拟环境。通过结合LocalStack的本地服务部署能力与Moto的AWS API模拟功能，帮助开发者在无需连接真实AWS账户的情况下，进行云应用的开发、测试和调试。

核心功能与特性

• 多AWS服务模拟：支持模拟S3、EC2、Lambda、DynamoDB、SQS等多种AWS核心服务
• 本地离线开发：无需网络连接真实AWS服务，降低开发成本和依赖
• 灵活配置：可自定义启动服务列表、区域设置及调试参数
• 轻量级环境：快速启动与重置，适合频繁测试场景
• API兼容性：模拟AWS官方API行为，确保开发代码与实际环境兼容

使用场景与适用范围

• 云应用本地开发与功能调试
• CI/CD流程中的自动化测试环节
• AWS API功能验证与兼容性测试
• 团队协作时的统一开发环境构建
• AWS服务学习与演示环境搭建

使用方法与配置说明

基本运行命令

bash
docker run -d -p 4566:4566 --name localstack-moto [镜像名称]

注：需将[镜像名称]替换为实际镜像标识

环境变量配置

通过环境变量自定义服务行为，常用配置项：

带配置的启动示例：

bash
docker run -d \
  -p 4566:4566 \
  -e SERVICES="s3,lambda,dynamodb" \
  -e DEFAULT_REGION="us-west-2" \
  -e DEBUG="1" \
  --name localstack-moto [镜像名称]

访问模拟服务

服务启动后，通过http://localhost:4566访问模拟AWS API，示例：

使用AWS CLI测试S3服务：

bash
aws --endpoint-url=http://localhost:4566 s3 mb s3://test-bucket
aws --endpoint-url=http://localhost:4566 s3 ls

Docker Compose配置示例

yaml
version: '3.8'
services:
  localstack-moto:
    image: [镜像名称]
    ports:
      - "4566:4566"  # 主API端口
      - "4510-4559:4510-4559"  # 各服务独立端口
    environment:
      - SERVICES=s3,dynamodb,lambda,sqs
      - DEFAULT_REGION=us-east-1
      - DEBUG=1
      - DATA_DIR=/var/lib/localstack
    volumes:
      - ./localstack-data:/var/lib/localstack  # 数据持久化

数据持久化

通过挂载本地目录到容器内/var/lib/localstack路径，实现服务数据持久化，避免容器重启后数据丢失。