fsouza/fake-gcs-server

Google Cloud Storage模拟器镜像文档

镜像概述

该镜像提供Google Cloud Storage（GCS）的本地模拟服务，允许开发者在不依赖真实Google Cloud环境的情况下，在本地开发、测试和调试与GCS交互的应用程序。通过模拟GCS API接口，镜像可复现核心存储功能，降低开发依赖并加速测试流程。

核心功能与特性

• API兼容性：支持GCS核心API接口，包括桶（Bucket）管理、对象（Object）上传/下载/删除、访问控制等
• 本地运行：无需联网或Google Cloud账号，完全在本地环境运行
• 轻量级部署：容器化设计，启动快速，资源占用低
• 数据持久化：支持将模拟数据存储到本地文件系统，容器重启后数据可保留
• 可配置性：支持自定义服务端口、存储路径及日志级别
• 无成本测试：避免使用真实云服务产生的测试成本和资源消耗

使用场景

• 本地开发：开发者在本地开发阶段测试应用与GCS的交互逻辑
• 自动化测试：CI/CD流程中集成，用于自动化测试GCS相关功能模块
• 离线环境：在无网络连接的环境下调试依赖GCS的应用
• 教学演示：学习GCS API使用时，无需真实云环境即可实践

使用方法

基本运行命令

通过以下命令启动GCS模拟器容器：

bash
docker run -d -p 9023:9023 --name gcs-emulator gcr.io/google.com/cloudsdktool/cloud-sdk:emulators

注：默认暴露9023端口，可通过-p参数映射到主机端口

环境变量配置

支持通过环境变量自定义模拟器行为：

示例：自定义端口和存储路径

bash
docker run -d \
  -p 8080:8080 \
  -e PORT=8080 \
  -e STORAGE_PATH=/gcs-data \
  -v $(pwd)/gcs-data:/gcs-data \
  --name gcs-emulator gcr.io/google.com/cloudsdktool/cloud-sdk:emulators

数据持久化

通过挂载主机目录到容器内的存储路径，实现数据持久化：

bash
docker run -d \
  -p 9023:9023 \
  -v $(pwd)/local-gcs-data:/data \
  --name gcs-emulator gcr.io/google.com/cloudsdktool/cloud-sdk:emulators

应用集成示例

1. 配置应用连接模拟器

在应用中配置GCS客户端连接到本地模拟器，以Python应用为例：

python
from google.cloud import storage
from google.auth.credentials import AnonymousCredentials

# 配置客户端连接到本地模拟器
client = storage.Client(
    credentials=AnonymousCredentials(),
    project='test-project',
)
client._http_internal = client._http  # 修复模拟器连接问题
client.host = 'http://localhost:9023'  # 模拟器地址

2. 测试API交互

使用curl测试模拟器API（创建桶并上传文件）：

bash
# 创建测试桶
curl -X POST "http://localhost:9023/storage/v1/b?project=test-project" \
  -H "Content-Type: application/json" \
  -d '{"name": "my-test-bucket"}'

# 上传文件到桶
curl -X PUT "http://localhost:9023/storage/v1/b/my-test-bucket/o/test-file?uploadType=media" \
  -H "Content-Type: text/plain" \
  -d "Hello, GCS Emulator!"

注意事项

• 模拟器不支持GCS的全部高级特性（如跨区域复制、生命周期规则等），仅覆盖核心功能
• 生产环境中不可替代真实GCS服务，仅用于开发测试场景
• 数据存储路径需通过卷挂载持久化，否则容器销毁后数据将丢失

停止与清理

bash
# 停止容器
docker stop gcs-emulator

# 删除容器
docker rm gcs-emulator