storytel/gcp-firestore-emulator

Google Cloud Firestore 模拟器

镜像概述和主要用途

一个轻量级容器，仅包含Google Cloud SDK中的https://cloud.google.com/firestore/docs%E6%A8%A1%E6%8B%9F%E5%99%A8%EF%BC%8C%E7%94%A8%E4%BA%8E%E5%9C%A8%E6%9C%AC%E5%9C%B0%E7%8E%AF%E5%A2%83%E4%B8%AD%E5%BC%80%E5%8F%91%E5%92%8C%E6%B5%8B%E8%AF%95Firestore%E5%BA%94%E7%94%A8%EF%BC%8C%E6%97%A0%E9%9C%80%E8%BF%9E%E6%8E%A5%E5%AE%9E%E9%99%85%E7%9A%84Google Cloud Firestore服务。

核心功能和特性

• 轻量级设计：仅包含Firestore模拟器核心组件，减少镜像体积
• 命令行配置：支持通过命令行参数灵活配置模拟器运行参数
• 本地开发支持：提供本地Firestore环境，加速开发和测试流程

使用场景和适用范围

• 本地开发Firestore应用时模拟数据库环境
• 单元测试和集成测试中验证Firestore交互逻辑
• 无需访问Google Cloud平台即可进行Firestore功能调试

使用方法和配置说明

基本执行方式

可直接通过命令行参数配置模拟器运行选项。

查看帮助信息

bash
docker run --rm docker.xuanyuan.run/storytel/gcp-firestore-emulator --help

执行后将显示以下选项说明：

Usage: cloud-firestore-emulator [options] <ignored>
  Options:
    --help
       打印使用帮助并退出
       默认值: false
    --host
       本地绑定地址
       默认值: localhost
    --licenses
       打印开源依赖和许可证信息后退出
       默认值: false
    --port
       本地监听端口
       默认值: 8080
    --rules
       Cloud Firestore规则文件路径
    --version
       打印版本信息并退出
       默认值: false

部署示例

基本运行示例

后台运行模拟器并映射端口8259：

bash
docker run -d -p 8259:8259 docker.xuanyuan.run/storytel/gcp-firestore-emulator --host=0.0.0.0 --port=8259

• -d：后台运行容器
• -p 8259:8259：将容器内8259端口映射到主机8259端口
• --host=0.0.0.0：允许外部访问模拟器
• --port=8259：设置模拟器监听端口为8259

指定Firestore规则文件

bash
docker run -d -p 8080:8080 -v $(pwd)/firestore.rules:/rules/firestore.rules docker.xuanyuan.run/storytel/gcp-firestore-emulator --host=0.0.0.0 --rules=/rules/firestore.rules

• -v $(pwd)/firestore.rules:/rules/firestore.rules：挂载本地Firestore规则文件到容器内