positivethinkingtech/localstack

LocalStack引导容器镜像

镜像概述

该Docker镜像专为简化LocalStack容器的初始化流程而设计，旨在为项目测试提供便捷的本地AWS服务模拟环境。通过自动化配置LocalStack基础环境，帮助开发者快速搭建可用于测试的本地云服务环境，减少手动配置步骤，提升测试效率。

核心功能与特性

• 自动化引导：自动完成LocalStack容器的初始化配置，无需手动执行启动脚本
• 灵活配置：支持通过环境变量自定义LocalStack服务组合、端口映射及资源配置
• 轻量级集成：可无缝集成到现有测试流程，支持主流测试框架
• 快速部署：简化本地测试环境搭建流程，缩短项目测试准备时间

使用场景与适用范围

• 开发阶段本地功能测试，需要模拟AWS服务（如S3、SQS、DynamoDB等）
• CI/CD流水线中的集成测试环节，提供一致的本地云服务环境
• 单元测试与集成测试中需要依赖AWS服务的场景
• 教学与演示环境，快速搭建本地AWS服务模拟平台

使用方法与配置说明

基本使用（Docker Run）

bash
docker run -d \
  --name localstack-bootstrap \
  --link localstack:localstack \
  -e LOCALSTACK_HOST=localstack \
  -e LOCALSTACK_PORT=4566 \
  -e SERVICES=s3,sqs,dynamodb \
  your-image-name:latest

Docker Compose配置示例

yaml
version: '3.8'
services:
  localstack:
    image: localstack/localstack:latest
    ports:
      - "4566:4566"
    environment:
      - SERVICES=s3,sqs
      - DEBUG=1
    volumes:
      - localstack-data:/var/lib/localstack

  bootstrap:
    image: your-image-name:latest
    depends_on:
      - localstack
    environment:
      - LOCALSTACK_HOST=localstack
      - LOCALSTACK_PORT=4566
      - SERVICES=s3,sqs,dynamodb
      - INIT_SCRIPTS_PATH=/scripts
    volumes:
      - ./init-scripts:/scripts

volumes:
  localstack-data:

环境变量配置

自定义初始化脚本

将包含AWS资源创建逻辑的脚本（如Shell脚本、Python脚本）挂载到INIT_SCRIPTS_PATH指定的目录，镜像会自动按顺序执行这些脚本，完成测试环境的预置。

示例脚本（create-s3-bucket.sh）：

bash
#!/bin/sh
awslocal s3 mb s3://test-bucket
awslocal s3api put-bucket-policy --bucket test-bucket --policy '{"Version":"2012-10-17","Statement":[{"Effect":"Allow","Principal":"*","Action":"s3:*","Resource":"arn:aws:s3:::test-bucket/*"}]}'