shopify/bigtable-emulator

Bigtable模拟器Docker镜像

镜像概述

本镜像包含Google Cloud Bigtable的内存Go实现模拟器，用于本地开发和集成测试场景，不可用于生产环境。它是Google Cloud SDK中Bigtable模拟器的轻量级替代方案（大小<17MB），解决了在每个开发或CI环境安装完整SDK的麻烦，还支持启动时自动创建所需的表和列族。

核心功能

• 内存模拟Bigtable服务，无需连接真实云服务
• 轻量级镜像（<17MB），快速部署
• 支持启动时通过参数配置表和列族
• 适用于本地开发调试和CI环境的集成测试

使用场景

• 本地开发Bigtable相关应用时模拟服务
• 集成测试中替代真实Bigtable服务，确保测试环境隔离
• CI/CD流水线中快速部署测试所需的Bigtable模拟环境

配置说明

基本启动命令

bash
docker run -d -p 9035:9035 shopify/bigtable-emulator

启动时配置表和列族

使用-cf参数指定需要创建的表和列族，格式为<实例名>.<表名>.<列族名>，多个用逗号分隔：

bash
docker run -d -p 9035:9035 shopify/bigtable-emulator -cf dev.records.data,dev.records.metadata

连接到模拟器

需要设置环境变量BIGTABLE_EMULATOR_HOST为模拟器地址（如localhost:9035），然后通过客户端连接：

go
import (
  "cloud.google.com/go/bigtable"
  "context"
  "golang.org/x/oauth2"
  "google.golang.org/api/option"
)

type devTokenSource struct{}

func (devTokenSource) Token() (*oauth2.Token, error) {
  return new(oauth2.Token), nil
}

func NewDevBigTableClient() (*bigtable.Client, error) {
  ctx := context.Background()
  project := "dev"
  instance := "dev"
  return bigtable.NewClient(
    ctx, 
    project, 
    instance,
    option.WithTokenSource(&devTokenSource{}),
  )
}

许可证

本软件遵循MIT许可证（详见LICENSE文件）。