apachepulsar/s3mock

adobe/s3mock (2018年7月9日构建版本)

镜像概述

本镜像为adobe/S3Mock项目（https://github.com/adobe/S3Mock%EF%BC%89%E7%9A%842018%E5%B9%B47%E6%9C%889%E6%97%A5%E6%9E%84%E5%BB%BA%E7%89%88%E6%9C%AC%E3%80%82S3Mock%E6%98%AF%E4%B8%80%E4%B8%AA%E8%BD%BB%E9%87%8F%E7%BA%A7%E7%9A%84Amazon S3模拟服务，旨在为本地开发和测试环境提供S3 API模拟功能，帮助开发人员在不依赖真实AWS S3服务的情况下验证应用与S3的交互逻辑。

核心功能与特性

• S3 API模拟：支持常见S3操作，包括创建/删除存储桶、上传/下载对象、列出对象、删除对象等核心API
• 本地数据存储：模拟数据存储在本地文件系统，便于测试数据管理和清理
• 无AWS依赖：无需真实AWS账户和网络连接，适合离线开发和测试场景
• 轻量级部署：通过Docker容器快速启动，资源占用低，易于集成到开发和测试流程

使用场景

• 本地开发环境：开发人员在本地调试依赖S3的应用功能，避免频繁访问真实S3服务
• 自动化测试：在CI/CD流程中作为测试环境依赖，验证应用与S3交互的正确性
• 单元测试/集成测试：为依赖S3的代码编写测试用例时提供可控的模拟环境

使用方法与配置说明

基本运行命令

通过以下命令启动S3Mock容器：

bash
docker run -p 9090:9090 -p 9191:9191 adobe/s3mock:20180709

• -p 9090:9090：映射HTTP端口，用于S3 API的HTTP访问
• -p 9191:9191：映射HTTPS端口，用于S3 API的HTTPS访问（可选）

环境变量配置

S3Mock支持通过环境变量自定义配置，常用参数如下：

• S3MOCK_PORT：设置HTTP服务端口（默认值：9090）
• S3MOCK_HTTPS_PORT：设置HTTPS服务端口（默认值：9191）
• S3MOCK_DATA_DIRECTORY：指定数据存储目录（默认使用容器内临时目录）
• S3MOCK_INITIAL_BUCKETS：启动时自动创建的存储桶列表，多个桶用逗号分隔（如"bucket1,bucket2"）

高级配置示例

指定数据存储目录并预创建存储桶：

bash
docker run -d \
  -p 9090:9090 \
  -e S3MOCK_DATA_DIRECTORY=/s3data \
  -e S3MOCK_INITIAL_BUCKETS=dev-bucket,test-bucket \
  -v /local/path/to/s3data:/s3data \
  --name s3mock \
  adobe/s3mock:20180709

服务验证

服务启动后，可通过以下方式验证：

1. 访问健康检查端点：http://localhost:9090/health，返回状态为UP表示服务正常
2. 使用AWS CLI测试（需配置endpoint-url）：

   bash
   # 创建存储桶
   aws s3 --endpoint-url http://localhost:9090 mb s3://my-test-bucket
   
   # 列出存储桶
   aws s3 --endpoint-url http://localhost:9090 ls
   
   # 上传文件
   aws s3 --endpoint-url http://localhost:9090 cp local-file.txt s3://my-test-bucket/