oittaa/gcp-storage-emulator

Google Cloud Storage 本地模拟器

镜像概述和主要用途

该镜像提供Google Cloud Storage API的本地模拟功能。由于Google目前尚未像Cloud Datastore那样提供官方的Cloud Storage模拟器，此镜像作为存根模拟器，使开发者能够在不连接生产Storage API的情况下进行本地开发和测试。

注意：这是一个开发中的项目，仅支持API的有限子集。

核心功能和特性

• 本地API模拟：模拟Google Cloud Storage API的基本功能，支持桶（bucket）和对象（blob）的基本操作
• 文件系统存储：使用容器内/storage目录存储模拟数据，支持主机目录挂载以持久化数据
• 端口配置：通过PORT环境变量控制服务端口，默认值为8080
• 轻量级部署：可通过Docker快速部署，无需复杂配置

使用场景和适用范围

• 本地开发环境：在开发阶段模拟Cloud Storage服务，避免依赖生产环境
• 单元测试和集成测试：为与Cloud Storage交互的代码提供本地测试环境
• CI/CD流程：在持续集成过程中提供本地存储服务模拟，加速测试流程

使用方法和配置说明

基本部署

使用以下命令启动模拟器容器：

bash
docker run -d \
  -p 8080:8080 \
  --name gcp-storage-emulator \
  -v "$(pwd)/cloudstorage":/storage \
  oittaa/gcp-storage-emulator

参数说明：

• -p 8080:8080：将容器的8080端口映射到主机的8080端口
• --name gcp-storage-emulator：指定容器名称
• -v "$(pwd)/cloudstorage":/storage：将主机当前目录下的cloudstorage目录挂载到容器的/storage目录，用于持久化存储数据

环境变量配置

使用示例

Python客户端示例

创建测试文件emulator-test.py：

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

BUCKET = "test-bucket"

client = storage.Client(
    credentials=AnonymousCredentials(),
    project="test",
)
bucket = client.bucket(BUCKET)
bucket = client.create_bucket(bucket)
blob = bucket.blob("blob1")
blob.upload_from_string("test1")
blob = bucket.blob("blob2")
blob.upload_from_string("test2")
for blob in bucket.list_blobs():
    content = blob.download_as_bytes()
    print("Blob [{}]: {}".format(blob.name, content))

运行测试

设置环境变量指向模拟器，然后执行测试脚本：

bash
export STORAGE_EMULATOR_HOST=http://localhost:8080
python3 emulator-test.py

项目地址

!https://github.com/oittaa/gcp-storage-emulator/workflows/CI/badge.svg

https://github.com/oittaa/gcp-storage-emulator/