kfirbar/localstack

LocalStack SQS 模拟服务镜像

镜像概述

该镜像基于localstack/localstack:0.10.1.2构建，专注于模拟AWS SQS（Simple Queue Service）服务。通过预设环境变量配置，提供开箱即用的本地SQS服务模拟能力，无需依赖真实AWS环境，适用于开发、测试阶段的功能验证和集成测试。

核心功能与特性

• SQS服务模拟：默认启用AWS SQS服务模拟，支持队列创建、消息发送/接收等核心操作
• 区域配置：预设默认AWS区域为us-east-1，无需额外配置
• 调试支持：启用调试模式（DEBUG=1），提供详细日志输出，便于问题排查
• 数据持久化：数据存储路径设为/tmp/localstack/data，支持容器内数据临时保存
• SSL加密：默认启用SSL（USE_SSL=1），确保服务通信安全

使用场景

• 本地开发环境中测试SQS相关功能，无需连接真实AWS账号
• 单元测试和集成测试阶段，模拟SQS队列行为，验证消息处理逻辑
• 演示或教学场景，展示SQS服务使用流程，无需AWS资源

使用方法

基本运行命令

通过docker run直接启动容器：

bash
docker run -d -p 4566:4566 --name localstack-sqs your-image-name

说明：LocalStack默认使用4566端口提供服务，需映射该端口到宿主机

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  localstack-sqs:
    image: your-image-name
    ports:
      - "4566:4566"  # LocalStack主服务端口
    environment:
      # 可在此覆盖默认环境变量
      # SERVICES: sqs,sns  # 如需添加其他服务
      # DEFAULT_REGION: us-west-2  # 如需修改区域
    volumes:
      - localstack-data:/tmp/localstack/data  # 可选：持久化数据到宿主机

volumes:
  localstack-data:

启动命令：docker-compose up -d

配置说明

环境变量参数

服务访问

容器启动后，可通过https://localhost:4566访问SQS服务，使用AWS SDK时需配置端点覆盖：

python
# AWS SDK for Python (boto3)示例
import boto3
from botocore.config import Config

config = Config(
    region_name='us-east-1',
    signature_version='v4',
    retries={
        'max_attempts': 10,
        'mode': 'standard'
    }
)

sqs = boto3.client(
    'sqs',
    endpoint_url='https://localhost:4566',
    config=config
)

# 创建队列示例
response = sqs.create_queue(QueueName='test-queue')
print(response['QueueUrl'])