gcloud-firestore-emulator Docker镜像文档

镜像概述

p0security/gcloud-firestore-emulator是一个封装了Google Cloud Firestore模拟器的Docker镜像，用于在本地环境中快速部署和运行Firestore模拟服务。该镜像允许开发者在不依赖真实Google Cloud Firestore服务的情况下，进行离线开发、测试和验证Firestore数据库交互逻辑。

核心功能与特性

• 本地Firestore模拟：在Docker容器中运行Firestore服务，模拟真实Firestore数据库环境
• 端口自定义：支持通过环境变量配置服务监听端口，灵活适配本地开发需求
• 轻量部署：无需手动安装gcloud SDK及Firestore模拟器，直接通过Docker启动
• 跨平台兼容：支持linux/amd64平台，可集成到各类开发环境和CI/CD流程

使用场景

• 本地应用开发：开发者在本地构建依赖Firestore的应用时，使用模拟器验证数据读写、查询等操作
• 自动化测试：在单元测试、集成测试中部署模拟器，确保测试环境独立于外部云服务
• 团队协作：统一团队开发环境，避免因本地Firestore模拟器版本或配置差异导致的问题

使用方法

基本启动命令

通过以下命令启动Firestore模拟器容器：

bash
docker run -d --publish 8085:8085 --env PORT=8085 --platform linux/amd64 p0security/gcloud-firestore-emulator:latest

命令参数说明

• -d：后台模式运行容器
• --publish 8085:8085：端口映射，将容器内8085端口映射到主机8085端口（主机端口:容器端口）
• --env PORT=8085：设置环境变量，指定模拟器在容器内监听的端口（需与容器端口保持一致）
• --platform linux/amd64：指定容器运行平台为linux/amd64
• p0security/gcloud-firestore-emulator:latest：Docker镜像名称及标签（latest为最新版本）

自定义端口配置

如需使用非默认端口（如8086），修改环境变量和端口映射即可：

bash
docker run -d --publish 8086:8086 --env PORT=8086 --platform linux/amd64 p0security/gcloud-firestore-emulator:latest

配置参数说明