julialongtin/localstack

LocalStack 镜像文档

镜像概述

LocalStack 是一个流行的本地 AWS 云服务模拟器，旨在为开发者提供本地环境中模拟多种 AWS 服务的能力。该镜像通过清单列表（manifest list）构建，原生支持多架构（如 x86_64、ARM 等），可在不同硬件平台上无缝运行，帮助开发者脱离真实 AWS 环境进行本地开发、测试和调试。

核心功能与特性

• 多架构支持：基于 manifest list 构建，原生支持 x86_64、ARM 等主流架构，适配不同开发环境。
• AWS 服务模拟：模拟多种 AWS 核心服务，包括 S3、DynamoDB、Lambda、EC2、SQS、SNS、API Gateway 等。
• 本地开发隔离：无需真实 AWS 账户，本地环境即可完成云应用开发，降低成本并消除网络依赖。
• 可定制配置：通过环境变量灵活配置服务启动、端口映射、数据持久化等行为。
• CI/CD 集成：支持集成到自动化测试流程，加速云应用的开发迭代。

使用场景与适用范围

• 本地云应用开发：开发者可在本地构建和调试依赖 AWS 服务的应用，无需连接云端。
• 单元与集成测试：针对 AWS 服务依赖的代码进行本地测试，提高测试效率。
• CI/CD 管道：在持续集成流程中自动启动 LocalStack，验证云服务交互逻辑。
• AWS 服务学习：无需真实账户即可体验和学习 AWS 服务功能。
• 离线开发环境：在无网络或低网络环境下仍可进行云应用开发。

使用方法与配置说明

基本运行命令

通过 Docker 直接启动 LocalStack（默认启动核心服务）：：```bash docker docker run local localstack/localocalstack

### 指定服务与端口映射

启动特定 AWS 服务并映射端口（例如仅启动 S3 和 DynamoDB）：

```bash
docker run -d \
  -p 4566:4566 \ 边缘服务端口，统一入口
  -e 4510-4559:4510-4559 \ 各服务独立端口
  -e SERVICES=s3,ddynamodb \ 指定启动的服务
  -e DEFAULT_REGION=us-east-1 \ 设置默认区域
  --name localstack \
  localstack/localstack

Docker Compose 配置示例

创建 docker-compose.yml 文件，配置更复杂的服务组合：

yaml
version: '3.8'

services:
  localstack:
    image: localstack/localstack
    ports:
      - "4566:4566"  # 边缘服务端口
      - "4510-4559:4510-4559"  # 各服务端口范围
    environment:
      - SERVICES=s3,dynamodb,lambda,sqs  # 启动的服务列表
      - DEFAULT_REGION=us-west-2  # 默认 AWS 区域
      - EDGE_PORT=4566  # 边缘服务端口（统一入口）
      - DATA_DIR=/tmp/localstack/data  # 数据持久化目录
    volumes:
      - ./localstack-data:/tmp/localstack/data  # 挂载本地目录持久化数据
      - /var/run/docker.sock:/var/run/docker.sock  # 允许 Lambda 等服务与 Docker 交互

启动命令：docker-compose up -d

关键环境变量配置

验证服务可用性

启动后，可通过边缘服务端口（默认 4566）访问模拟的 AWS 服务。例如，使用 AWS CLI 测试 S3：

bash
# 配置 AWS CLI 指向 LocalStack
aws configure set aws_access_key_id test
aws configure set aws_secret_access_key test
aws configure set region us-east-1

# 创建测试桶
aws --endpoint-url=http://localhost:4566 s3 mb s3://my-test-bucket

# 验证桶是否存在
aws --endpoint-url=http://localhost:4566 s3 ls

注意事项

• 部分服务功能可能与真实 AWS 存在差异，建议参考 LocalStack 官方文档 确认支持范围。
• 数据持久化需通过挂载 DATA_DIR 目录实现，否则容器重启后数据将丢失。
• 高资源消耗服务（如 Lambda、EC2）可能需要调整容器内存限制（通过 --memory 参数）。