zenoss/gcloud-emulator

Google Cloud服务模拟器Docker镜像

镜像概述

本Docker镜像提供Google Cloud服务的本地模拟器环境，旨在支持开发者在无真实云资源依赖的情况下，进行Google Cloud相关应用的开发、测试及验证。通过容器化封装，该镜像可快速部署于本地开发环境、CI/CD流水线或离线场景，降低对真实云服务的依赖成本，同时确保开发与测试过程的一致性和隔离性。

核心功能与特性

• 多服务模拟支持：集成多种Google Cloud核心服务模拟器，包括但不限于Firestore、BigQuery、Pub/Sub、Datastore、Storage等。
• 本地网络隔离：模拟器运行于容器内部网络，与外部真实云服务完全隔离，避免测试数据污染生产环境。
• 数据持久化：支持通过卷挂载实现模拟服务数据的本地持久化，便于重复测试场景复现。
• 灵活配置：可通过环境变量或配置文件自定义模拟服务的端口、数据存储路径、日志级别等参数。
• 轻量级部署：基于精简基础镜像构建，启动快速，资源占用低，适合本地开发及CI/CD环境集成。

使用场景

• 本地开发调试：开发者在本地开发阶段模拟Google Cloud服务，验证应用与云服务的交互逻辑（如数据读写、消息发布订阅等）。
• 自动化测试：在单元测试、集成测试中集成模拟器，确保测试流程不依赖外部云服务，提升测试稳定性和执行效率。
• CI/CD流水线集成：在CI/CD流程中临时启动模拟器，完成应用构建后的自动化测试，避免真实云资源开销。
• 离线开发：在无网络或网络受限环境下，通过模拟器继续开发与云服务相关的功能模块。

使用方法

基本运行命令

通过以下命令启动默认配置的Google Cloud服务模拟器：

bash
docker run -d \
  --name gcloud-emulator \
  -p 8080:8080 \  # 默认服务端口映射
  gcr.io/google.com/cloudsdktool/cloud-sdk:emulators  # 示例镜像地址，具体以实际为准

指定模拟服务

通过SERVICES环境变量指定需模拟的Google Cloud服务（多个服务用逗号分隔）：

bash
docker run -d \
  --name gcloud-emulator \
  -e "SERVICES=firestore,pubsub,bigquery" \  # 模拟Firestore、Pub/Sub、BigQuery服务
  -p 8080:8080 \  # Firestore默认端口
  -p 8085:8085 \  # Pub/Sub默认端口
  -p 9050:9050 \  # BigQuery默认端口
  gcr.io/google.com/cloudsdktool/cloud-sdk:emulators

数据持久化配置

通过卷挂载实现模拟服务数据的持久化存储（避免容器重启后数据丢失）：

bash
docker run -d \
  --name gcloud-emulator \
  -e "SERVICES=firestore" \
  -p 8080:8080 \
  -v ./emulator-data:/emulator/data \  # 本地目录./emulator-data映射至容器内数据目录
  gcr.io/google.com/cloudsdktool/cloud-sdk:emulators

docker-compose配置示例

创建docker-compose.yml文件，集成模拟器至多服务开发环境：

yaml
version: '3.8'
services:
  gcloud-emulator:
    image: gcr.io/google.com/cloudsdktool/cloud-sdk:emulators
    container_name: gcloud-emulator
    environment:
      - SERVICES=firestore,pubsub
      - LOG_LEVEL=info  # 日志级别：debug/info/warn/error
    ports:
      - "8080:8080"  # Firestore端口
      - "8085:8085"  # Pub/Sub端口
    volumes:
      - ./emulator-data:/emulator/data  # 数据持久化
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

配置参数

环境变量

端口映射说明

不同Google Cloud服务模拟器默认端口如下（可通过环境变量PORT_<SERVICE>自定义，例如PORT_FIRESTORE=9000）：

注意事项

1. 功能局限性：模拟器旨在模拟核心服务交互逻辑，部分高级特性（如跨区域复制、权限策略等）可能与真实Google Cloud服务存在差异，生产环境需使用真实云服务验证。
2. 端口冲突：若本地已有服务占用模拟器默认端口，需通过-p参数映射至其他端口，并确保应用配置中使用映射后的端口。
3. 数据安全：模拟器数据仅用于本地测试，请勿存储敏感信息，持久化目录需做好本地权限控制。
4. 镜像更新：建议定期更新镜像以获取最新的服务模拟功能及安全补丁。