node-20.1-firebase-pnpm 镜像文档

镜像概述

本镜像基于官方Node.js 20.1版本构建，预集成Firebase CLI工具与pnpm包管理器，旨在为Firebase应用开发提供一站式运行环境。通过整合Node.js运行时、Firebase部署工具及高效包管理能力，简化开发至部署的全流程，适合个人开发者及团队在本地开发、CI/CD流水线或容器化部署场景中使用。

核心功能与特性

基础环境

• Node.js 20.1：提供稳定的JavaScript运行时环境，支持ES模块及最新语言特性
• 系统依赖：包含Node.js生态所需基础系统库，确保工具链兼容性

集成工具

• Firebase CLI：完整支持Firebase功能（如部署、模拟器、远程配置管理等），版本与Node.js 20.1兼容
• pnpm：高效的Node.js包管理器，支持工作区、依赖缓存，提升依赖安装速度与磁盘空间利用率

镜像特性

• 轻量级基础：基于官方Node.js镜像构建，优化层缓存，减少镜像体积
• 即开即用：无需额外安装依赖，拉取后可直接执行Firebase/pnpm命令
• 环境隔离：容器化环境避免开发环境冲突，确保团队协作一致性

使用场景与适用范围

适用场景

• Firebase应用开发：本地开发Firebase Functions、Hosting、Realtime Database等服务
• CI/CD流水线：集成到GitHub Actions、GitLab CI等平台，自动化测试、构建与部署
• 多环境管理：通过环境变量配置，支持开发/测试/生产环境的快速切换部署
• 依赖一致性验证：利用pnpm的确定性依赖解析，确保团队成员依赖版本一致

适用用户

• 前端/全栈开发者（Firebase生态用户）
• 需要容器化Firebase工作流的团队
• 追求高效依赖管理的Node.js项目开发者

使用方法与配置说明

镜像拉取

docker pull [镜像仓库地址]/node-20.1-firebase-pnpm:latest

基本使用

交互式终端

启动容器并进入交互式终端，用于手动执行命令：

docker run -it --rm \
  -v $(pwd):/app \  # 挂载本地项目目录至容器内/app
  -w /app \          # 设置工作目录为/app
  [镜像仓库地址]/node-20.1-firebase-pnpm:latest \
  /bin/bash

执行Firebase命令

直接执行Firebase CLI命令（如部署Hosting）：

docker run --rm \
  -v $(pwd):/app \
  -w /app \
  -e FIREBASE_TOKEN="your-firebase-token" \  # 非交互式认证（可选）
  [镜像仓库地址]/node-20.1-firebase-pnpm:latest \
  firebase deploy --only hosting

执行pnpm命令

使用pnpm安装依赖或运行脚本：

# 安装项目依赖
docker run --rm \
  -v $(pwd):/app \
  -w /app \
  [镜像仓库地址]/node-20.1-firebase-pnpm:latest \
  pnpm install

# 运行项目构建脚本
docker run --rm \
  -v $(pwd):/app \
  -w /app \
  [镜像仓库地址]/node-20.1-firebase-pnpm:latest \
  pnpm run build

环境变量配置

持久化配置

如需保存Firebase配置或pnpm缓存，可挂载对应目录：

docker run -it --rm \
  -v $(pwd):/app \
  -v firebase-config:/root/.firebase \  # 持久化Firebase配置
  -v pnpm-store:/root/.pnpm-store \     # 持久化pnpm缓存
  [镜像仓库地址]/node-20.1-firebase-pnpm:latest \
  /bin/bash

部署示例

docker-compose配置

创建docker-compose.yml简化本地开发流程：

version: '3'
services:
  firebase-dev:
    image: [镜像仓库地址]/node-20.1-firebase-pnpm:latest
    volumes:
      - ./:/app
      - firebase-config:/root/.firebase
      - pnpm-store:/root/.pnpm-store
    working_dir: /app
    environment:
      - NODE_ENV=development
      # 如需非交互式部署，添加FIREBASE_TOKEN
      # - FIREBASE_TOKEN=your-token-here
    tty: true  # 保持终端连接

volumes:
  firebase-config:
  pnpm-store:

启动服务：

docker-compose up -d
docker-compose exec firebase-dev /bin/bash  # 进入容器终端

CI/CD集成（GitHub Actions示例）

在.github/workflows/deploy.yml中使用镜像执行自动化部署：

name: Deploy to Firebase
on:
  push:
    branches: [ main ]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      
      - name: Run with firebase-pnpm image
        uses: docker://[镜像仓库地址]/node-20.1-firebase-pnpm:latest
        with:
          args: |
            pnpm install && \
            pnpm run build && \
            firebase deploy --only hosting --token ${{ secrets.FIREBASE_TOKEN }}
        env:
          FIREBASE_TOKEN: ${{ secrets.FIREBASE_TOKEN }}