roryq/spanner-emulator

Google Cloud Spanner Emulator Docker镜像

1. 镜像概述与主要用途

本镜像基于官方https://github.com/GoogleCloudPlatform/cloud-spanner-emulator%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%8F%90%E4%BE%9B%E6%9C%AC%E5%9C%B0%E7%8E%AF%E5%A2%83%E4%B8%8B%E7%9A%84Spanner%E6%9C%8D%E5%8A%A1%E6%A8%A1%E6%8B%9F%E8%83%BD%E5%8A%9B%E3%80%82%E4%B8%BB%E8%A6%81%E7%94%A8%E4%BA%8E%E5%BC%80%E5%8F%91%E5%92%8C%E6%B5%8B%E8%AF%95%E9%98%B6%E6%AE%B5%EF%BC%8C%E6%97%A0%E9%9C%80%E8%BF%9E%E6%8E%A5%E5%AE%9E%E9%99%85Google Cloud Spanner服务即可模拟Spanner数据库的核心功能，降低依赖云资源的开发成本并提升测试效率。

2. 核心功能与特性

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

3. 使用场景与适用范围

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

4. 使用方法与配置说明

4.1 基本运行命令

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

bash
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配置：

yaml
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. 环境变量配置说明