Google Cloud Spanner Emulator Docker镜像

1. 镜像概述与主要用途

本镜像基于***Google Cloud Spanner Emulator构建，提供本地环境下的Spanner服务模拟能力。主要用于开发和测试阶段，无需连接实际Google Cloud Spanner服务即可模拟Spanner数据库的核心功能，降低依赖云资源的开发成本并提升测试效率。

2. 核心功能与特性

• 兼容性：完整包装Spanner Emulator，确保功能与***实现一致。
• 启动自动配置：支持通过环境变量配置，启动时自动创建Spanner实例（必选）和数据库（可选），简化手动操作流程。
• 轻量级本地部署：无需复杂的云服务配置，可在本地环境快速启动，资源占用低。

3. 使用场景与适用范围

• 应用开发环境：本地开发需要与Spanner交互的应用程序时，用于验证数据模型设计、SQL语句执行等逻辑。
• 自动化测试：在单元测试、集成测试中模拟Spanner服务，确保测试环境独立于实际云资源，提升测试稳定性。
• 演示与原型验证：快速搭建Spanner模拟环境，用于功能演示或原型验证，无需实际云服务账号。

4. 使用方法与配置说明

4.1 基本运行命令

通过docker run命令启动镜像，需通过环境变量指定必要参数。示例如下：

docker run \
  --env SPANNER_PROJECT_ID=my-project \
  --env SPANNER_INSTANCE_ID=my-instance \
  --env SPANNER_DATABASE_ID=my-db \
  -p 9010:9010 -p 9020:9020 \
  roryq/spanner-emulator:latest

端口说明：

• 9010：gRPC服务端口（Spanner客户端默认连接端口）
• 9020：HTTP管理端口

4.2 Docker Compose配置示例

在多容器应用中集成时，可通过docker-compose.yml配置：

version: '3.8'
services:
  spanner-emulator:
    image: roryq/spanner-emulator:latest
    environment:
      SPANNER_PROJECT_ID: "test-project"
      SPANNER_INSTANCE_ID: "test-instance"
      SPANNER_DATABASE_ID: "test-db"  # 可选，不设置则仅创建实例
    ports:
      - "9010:9010"
      - "9020:9020"
    restart: unless-stopped

5. 环境变量配置说明