evalphobia/fake_sqs

fake_sqs Docker镜像文档

镜像概述

fake_sqs Docker镜像是一个本地模拟的AWS SQS（Simple Queue Service）服务器，旨在为开发和测试环境提供轻量级、无需依赖真实AWS服务的消息队列模拟服务。通过该镜像，开发者可以在本地环境中快速搭建SQS兼容的队列服务，进行应用程序的集成测试和功能验证。

核心功能与特性

• AWS SQS兼容：实现了AWS SQS的核心API，支持标准队列操作（创建队列、发送消息、接收消息、删除消息等）
• 轻量级部署：基于Ruby构建，镜像体积小，启动速度快
• 无需云服务依赖：本地运行，不产生AWS服务费用，适合离线开发和测试
• 可配置性：支持通过环境变量自定义端口、队列存储路径等参数
• 持久化支持：可配置消息持久化，确保测试过程中消息不丢失

使用场景

• 应用开发：本地开发阶段模拟SQS服务，避免频繁调用AWS API
• 集成测试：自动化测试环境中提供可靠的SQS模拟服务，确保测试可重复性
• CI/CD流程：在持续集成/持续部署管道中作为测试依赖服务
• 离线开发：无网络环境下仍能进行涉及SQS队列的功能开发

使用方法

基本运行

通过以下命令启动fake_sqs服务：

bash
docker run -d -p 4568:4568 --name fake-sqs evalphobia/fake_sqs

服务将在本地4568端口启动，可通过http://localhost:4568访问。

Docker Compose配置

在docker-compose.yml中集成fake_sqs：

yaml
version: '3'
services:
  fake-sqs:
    image: evalphobia/fake_sqs
    ports:
      - "4568:4568"
    environment:
      - PORT=4568
      - QUEUE_PATH=/var/fake_sqs/queues
    volumes:
      - ./fake_sqs_data:/var/fake_sqs/queues

启动服务：

bash
docker-compose up -d

验证服务

使用AWS CLI验证服务是否正常运行（需配置endpoint-url指向本地服务）：

bash
aws sqs create-queue --queue-name test-queue --endpoint-url http://localhost:4568

配置参数

环境变量

持久化配置

通过挂载卷到QUEUE_PATH指定的目录，可以实现队列数据的持久化：

bash
docker run -d -p 4568:4568 -v ./fake_sqs_data:/var/fake_sqs --name fake-sqs evalphobia/fake_sqs

与应用集成

在应用中配置SQS客户端指向本地fake_sqs服务：

• Python (boto3):

  python
  import boto3
  sqs = boto3.client(
      'sqs',
      region_name='us-east-1',
      endpoint_url='http://localhost:4568',
      aws_access_key_id='access_key',
      aws_secret_access_key='secret_key'
  )
  

• Java (AWS SDK):

  java
  AmazonSQS sqs = AmazonSQSClientBuilder.standard()
      .withEndpointConfiguration(new EndpointConfiguration("http://localhost:4568", "us-east-1"))
      .withCredentials(new AWSStaticCredentialsProvider(new BasicAWSCredentials("access_key", "secret_key")))
      .build();