jensvogt/awsmock

awsmock 镜像文档

镜像概述和主要用途

awsmock是一款高性能、持久化的AWS模拟工具，采用C++开发，支持多种AWS服务的本地模拟。它提供可选的MongoDB持久化层或内存数据库模式，可模拟AWS服务的核心功能，适用于本地开发、测试和CI/CD流程，帮助开发者在无需连接真实AWS环境的情况下验证应用功能。

核心功能和特性

支持的AWS服务

• S3：模拟Amazon Simple Storage Service，支持对象存储、桶管理等操作
• SQS：模拟Amazon Simple Queue Service，支持标准队列和FIFO队列的消息收发
• SNS：模拟Amazon Simple Notification Service，支持基于主题的发布/订阅（当前仅支持SQS端点）
• Lambda：模拟Amazon Lambda服务，支持函数创建、部署和测试
• Cognito：模拟Amazon Cognito身份服务
• DynamoDB：模拟Amazon Dynamo数据库服务
• Transfer：模拟Amazon Transfer Family，支持FTP协议（FTPS/SFTP暂不支持），文件自动存储至S3传输桶
• SecretsManager：模拟Amazon Secrets Manager，管理数据库凭证、API密钥等敏感信息
• KMS：模拟Amazon Key Management Service，支持密钥创建和管理
• API Gateway：模拟Amazon API Gateway，支持REST、HTTP和WebSocket API的创建与管理
• Applications：应用服务模块，支持Java、C#、C++、Python等应用的部署与管理（打包为JAR或ZIP文件）

技术特性

• 高性能架构：基于C++开发，处理AWS命令响应高效
• 灵活的存储模式：支持MongoDB持久化层（数据持久存储）或内存数据库模式（适用于测试容器，服务停止后数据丢失）
• 标准端口兼容：默认监听4566端口接收AWS命令
• 模块控制工具：提供awsmockctl命令行工具，支持模块启停、重启及内部配置管理

使用场景和适用范围

• 本地开发环境：在本地模拟AWS服务，避免依赖真实AWS账户和资源
• 集成测试验证：验证应用与AWS服务的集成逻辑，确保功能正确性
• CI/CD流程集成：作为测试容器嵌入自动化测试 pipeline，加速测试迭代
• 培训与演示：在无AWS权限的环境中学习AWS服务操作，降低演示成本

详细使用方法和配置说明

从源码构建（可选）

最低系统要求

• 编译器：GCC 4.9+ 或 Clang 3.3+
• 依赖库：Boost v1.88+、MongoDB C/C++驱动、libcurl、libz、libssl、lib***、libarchive、libmagic
• 内存：至少4GB RAM

构建步骤

1. 安装CMake及构建工具，确保已添加至环境变量
2. 克隆源码：

   bash
   git clone https://github.com/jensvogt/awsmock.git
   cd awsmock
   

3. 构建项目：

   bash
   cmake . -DCMAKE_BUILD_TYPE=Debug -DCMAKE_PREFIX_PATH=<安装路径>
   cmake --build . --config=Debug
   

4. 安装可执行文件、库及手册页：

   bash
   cmake --install . --config=Debug
   

5. 启动服务管理器：

   bash
   awsmockmgr --deamon --loglevel debug
   

使用Docker镜像（推荐）

前提条件

已安装Docker环境

基本使用流程

1. 拉取镜像：

   bash
   docker pull docker.xuanyuan.run/jensvogt/awsmock:latest
   

2. 启动容器（默认端口映射）：

   bash
   docker run -p 4566:4566 -p 4567:4567 -p 8080:8080 docker.xuanyuan.run/jensvogt/aws-mock:latest
   

   说明：此命令启动容器并映射端口4566（AWS命令端口）、4567和8080，默认使用内存数据库模式（容器停止后数据丢失）。

配置MongoDB持久化

若需持久化存储，可连接外部MongoDB容器。容器内/usr/local/share/awsmock/docker目录提供示例docker-compose配置，使用方法：

bash
cd /usr/local/share/awsmock/docker
docker-compose up

注意：需单独配置MongoDB的远程访问权限，可参考MongoDB远程连接配置指南。

示例

awsmock提供各服务模块的示例脚本，位于安装目录下的/usr/share/awsmock或/usr/local/share/awsmock（依安装路径而定），每个服务模块对应独立目录（如s3、sqs）。示例脚本需依赖jq工具（JSON处理），Linux可通过系统包管理器安装，Windows可从https://jqlang.github.io/jq/download/%E8%8E%B7%E5%8F%96%E3%80%82

运行示例（以S3创建桶为例）：

bash
cd /usr/local/share/awsmock/s3
./create-bucket.sh