oldmantaiter/goaws

本地AWS SQS/SNS模拟服务镜像

镜像概述

本镜像为p4tin/goaws的克隆版本，提供本地AWS SQS（简单队列服务）和SNS（简单通知服务）的模拟实现。旨在帮助开发者在本地环境中测试和开发依赖AWS消息服务的应用程序，无需连接真实的AWS云服务，降低开发测试成本并提高效率。

核心功能与特性

• AWS服务模拟：支持SQS队列创建、删除、发送/接收消息，SNS主题管理、订阅及消息发布等核心操作
• 本地独立运行：无需依赖AWS账户或网络连接，可在本地环境快速部署和启动
• API兼容性：提供与AWS SQS/SNS官方API兼容的接口，应用程序可无缝切换测试环境
• 轻量级设计：基于Go语言开发，资源占用低，启动速度快，适合本地开发和CI/CD场景
• 无状态服务：默认提供内存级消息存储，支持快速重置测试环境

使用场景

• 本地应用开发：开发者在本地开发依赖AWS消息队列/通知的应用时，无需配置真实AWS资源
• 集成测试：在CI/CD流程中作为测试环境组件，验证应用程序与消息服务的交互逻辑
• 功能验证：快速验证队列/主题创建、消息收发、订阅分发等业务功能
• 学习与演示：作为AWS SQS/SNS服务的本地学习工具，降低云服务学习门槛

使用方法

基本部署

通过Docker命令快速启动服务：

bash
docker run -d -p 4100:4100 --name local-aws-mq [镜像名称]

注：[镜像名称]需替换为实际拉取的Docker镜像标签

服务启动后，可通过http://localhost:4100访问模拟的AWS SQS/SNS服务端点。

应用配置示例

在应用程序中配置AWS客户端时，指定服务端点为本地地址即可使用模拟服务：

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客户端指向本地模拟服务
sqs = boto3.client(
    'sqs',
    endpoint_url='http://localhost:4100',
    config=config
)

# 创建测试队列
queue = sqs.create_queue(QueueName='test-queue')

自定义配置

如需修改默认配置（如服务端口、数据持久化等），可通过以下方式实现：

• 端口映射：通过-p <本地端口>:4100自定义服务访问端口
• 配置文件挂载：挂载自定义配置文件（如config.yaml）到容器/app/config目录（具体配置项参考p4tin/goaws官方文档）

注意事项

• 本镜像功能与p4tin/goaws保持一致，详细API支持情况可参考原项目文档
• 仅适用于开发和测试环境，不提供数据持久化和高可用性保障，请勿用于生产环境
• 默认使用内存存储消息，容器重启后所有队列和消息数据将丢失