178inaba/firestore-emulator

Firestore模拟器容器镜像

镜像概述和主要用途

该容器镜像提供了Firestore和Datastore模拟器的容器化版本，用于在本地开发和测试环境中模拟Google Cloud Firestore和Datastore服务。无需依赖云端服务，即可快速搭建本地测试环境，支持应用程序在开发阶段进行数据操作测试。

核心功能和特性

• 支持两种运行模式：Firestore原生模式和Datastore模式
• 轻量级容器化部署，简化环境配置
• 可集成到CI/CD流程（如GitHub Actions）进行自动化测试
• 支持Docker Compose配置，便于多服务协同测试
• 提供健康检查机制，确保服务可用性

使用场景和适用范围

• 本地开发环境：开发人员在本地搭建Firestore/Datastore测试环境
• 自动化测试：在CI/CD流程中（如GitHub Actions）运行单元测试和集成测试
• 多服务协同开发：通过Docker Compose与应用服务联动测试

使用方法和配置说明

基本使用（Docker Run）

console
$ docker run -d --name datastore-emulator -e DATABASE_MODE=datastore-mode -p 8080:8080 178inaba/firestore-emulator

GitHub Actions集成

在GitHub Actions工作流中配置模拟器服务：

yaml
jobs:
  test:
    runs-on: ubuntu-latest
    services:
      datastore-emulator:
        image: 178inaba/firestore-emulator
        ports:
          - "8080:8080"
        env:
          DATABASE_MODE: datastore-mode
    env:
      DATASTORE_EMULATOR_HOST: localhost:8080
    steps:
      - name: Test
        run: |
          # 替换为实际应用测试命令
          curl -f localhost:8080

Docker Compose配置

同时运行Firestore和Datastore模式的模拟器，并与应用服务协同：

yaml
services:
  firestore:
    image: 178inaba/firestore-emulator
    ports:
      - "8080:8080"
    healthcheck:
      test: ['CMD', 'curl', '-f', 'localhost:8080']

  datastore:
    image: 178inaba/firestore-emulator
    ports:
      - "8081:8080"
    environment:
      DATABASE_MODE: datastore-mode
    healthcheck:
      test: ['CMD', 'curl', '-f', 'localhost:8080']

  app:
    build: .
    environment:
      FIRESTORE_EMULATOR_HOST: firestore:8080
      DATASTORE_EMULATOR_HOST: datastore:8080
    depends_on:
      firestore:
        condition: service_healthy
      datastore:
        condition: service_healthy

环境变量配置

DATABASE_MODE

指定Firestore模拟器的运行模式，可选值：

• firestore-native（默认）：以Firestore原生模式启动
• datastore-mode：以Datastore模式启动

源码仓库

https://github.com/178inaba/gcloud-emulators