markglh/initialised-localstack

初始化LocalStack镜像

本镜像扩展了https://github.com/localstack/localstack%E6%8F%90%E4%BE%9B%E7%9A%84%E9%BB%98%E8%AE%A4%E9%95%9C%E5%83%8F%E5%8A%9F%E8%83%BD%EF%BC%8C%E5%B8%AE%E5%8A%A9%E7%94%A8%E6%88%B7%E5%9C%A8%E6%9C%AC%E5%9C%B0%E8%BF%90%E8%A1%8CAWS%E6%9C%8D%E5%8A%A1%E8%BF%9B%E8%A1%8C%E6%B5%8B%E8%AF%95%E6%97%B6%EF%BC%8C%E8%87%AA%E5%8A%A8%E5%AE%8C%E6%88%90%E6%9C%8D%E5%8A%A1%E5%88%9D%E5%A7%8B%E5%8C%96%E9%85%8D%E7%BD%AE%E3%80%82

核心功能

• 支持通过CloudFormation模板或awslocal命令脚本初始化Kinesis流、SQS队列、DynamoDB表等AWS服务
• 镜像版本与localstack版本对应（如0.7.4版本拉取localstack 0.7.4）
• 以初始化脚本作为健康检查，确保服务完全就绪后再标记为健康，可控制Docker Compose中的启动顺序
• 支持运行时覆盖模板或脚本（挂载卷替换/opt/bootstrap/templates或/opt/bootstrap/scripts目录）

使用场景

适用于需要在本地模拟AWS服务的开发测试场景，例如：

• 本地验证Kinesis流数据处理逻辑
• 测试SQS队列消息收发功能
• 开发DynamoDB表结构及查询逻辑

配置说明

环境变量

• SERVICES/LOCALSTACK_SERVICES：指定要启用的AWS服务（如kinesis,dynamodb,cloudwatch）
• DEFAULT_REGION：设置默认AWS区域（默认us-east-1）
• HOSTNAME/HOSTNAME_EXTERNAL：设置LocalStack的主机名（默认localhost）
• USE_SSL：是否启用SSL（默认true）

Docker Compose示例

yaml
version: "2.3"

services:
  localstack:
    image: markglh/initialised-localstack:latest
    environment:
      - "SERVICES=${LOCALSTACK_SERVICES:-kinesis,dynamodb,cloudwatch,cloudformation}"
      - "DEFAULT_REGION=${AWS_REGION:-us-east-1}"
      - "HOSTNAME=${LOCALSTACK_HOSTNAME:-localhost}"
      - "HOSTNAME_EXTERNAL=${LOCALSTACK_HOSTNAME_EXTERNAL:-localhost}"
      - "USE_SSL=true"
      #- "DATA_DIR=${LOCALSTACK_DATA_DIR:-/tmp/localstack/data}" # 取消注释以持久化数据
    volumes:
      - ./templates:/opt/bootstrap/templates
    ports:
      - "4567-4582:4567-4582"
      - "8080:8080"

  some-service:
    image: myorg/some-service
    depends_on:
      localstack:
        condition: service_healthy

示例查询

使用AWS CLI指定LocalStack端点查询服务：

bash
aws --endpoint-url=https://localhost:4568 kinesis --profile=personal --no-verify-ssl list-streams