如何将含Firestore与Functions的Firebase模拟器Docker化

仓库结构 #

按需求搭建backend仓库的目录结构：

backend/
├── docker-compose.yml
├── firebase.json
├── functions/
│   ├── index.js
│   ├── package.json
│   └── package-lock.json
└── Dockerfile

编写Functions服务的Dockerfile #

该镜像负责构建云函数并启动Functions模拟器：

# 选用Firebase Functions支持的Node.js LTS版本（示例用18）
FROM node:18-alpine

WORKDIR /app

# 全局安装Firebase CLI
RUN npm install -g firebase-tools

# 先复制依赖配置文件，利用Docker缓存优化构建速度
COPY functions/package*.json ./functions/
RUN cd functions && npm install

# 复制云函数代码与Firebase全局配置
COPY functions/ ./functions/
COPY firebase.json ./

# 指定GCP项目ID，需与其他模拟器服务保持一致
ENV GCP_PROJECT=your-project-id

# 启动Functions模拟器，仅运行functions服务
CMD ["firebase", "emulators:start", "--only", "functions", "--project", "$GCP_PROJECT"]

编写Firebase全局配置文件（firebase.json） #

统一配置所有模拟器的端口与关联关系：

{
  "emulators": {
    "functions": {
      "port": 5001
    },
    "firestore": {
      "port": 8080
    },
    "auth": {
      "port": 9099
    },
    "ui": {
      "enabled": true,
      "port": 4000
    },
    "singleProjectMode": true
  }
}

编写docker-compose.yml #

通过Docker Compose将Auth/Firestore模拟器与Functions服务整合到同一网络，确保服务间互通：

version: '3.8'

services:
  firebase-core-emulators:
    image: spine3/firebase-emulator
    ports:
      - "9000:9000"
      - "8080:8080"
      - "4000:4000"
      - "9099:9099"
      - "8085:8085"
      - "9199:9199"
    environment:
      - GCP_PROJECT=your-project-id
      - ENABLE_UI=true
    networks:
      - firebase-local
    volumes:
      # 共享firebase配置，保持配置一致性
      - ./firebase.json:/firebase.json

  firebase-functions:
    build: .
    ports:
      - "5001:5001"
    environment:
      - GCP_PROJECT=your-project-id
      # 通过Docker服务名访问其他模拟器，无需localhost
      - FIRESTORE_EMULATOR_HOST=firebase-core-emulators:8080
      - AUTH_EMULATOR_HOST=firebase-core-emulators:9099
      - FUNCTIONS_EMULATOR=true
    networks:
      - firebase-local
    volumes:
      # 挂载本地functions目录，实现开发时热更新
      - ./functions:/app/functions
      - ./firebase.json:/app/firebase.json
    depends_on:
      - firebase-core-emulators

networks:
  firebase-local:
    driver: bridge

配置云函数连接到本地模拟器 #

在functions/index.js中添加环境判断，确保本地运行时自动连接模拟器：

const functions = require("firebase-functions");
const admin = require("firebase-admin");

admin.initializeApp();

// 本地模拟器环境下配置连接
if (process.env.FUNCTIONS_EMULATOR) {
  admin.firestore().settings({
    host: process.env.FIRESTORE_EMULATOR_HOST,
    ssl: false
  });
  admin.auth().useEmulator(`http://${process.env.AUTH_EMULATOR_HOST}`);
}

// 示例云函数
exports.testFunction = functions.https.onRequest((req, res) => {
  res.send("Functions模拟器已正常运行");
});

启动与验证 #

1. 进入backend目录，执行命令：

   docker-compose up --build
   

2. 打开浏览器访问http://localhost:4000，在Firebase模拟器UI中可看到Auth、Firestore、Functions三个服务均已启动。
3. 测试云函数：访问http://localhost:5001/your-project-id/us-central1/testFunction，返回"Functions模拟器已正常运行"则配置成功。
4. 开发时修改云函数代码，由于挂载了本地目录，Functions模拟器会自动重载代码，无需重启容器。

内容的提问来源于stack exchange，提问作者Andriy