bobik/firebase-jq

Firebase工具与jq CI专用Docker镜像

镜像概述

本Docker镜像集成了Firebase官方工具集和jq JSON处理器，旨在为CI（持续集成）环境提供开箱即用的 Firebase 项目管理和 JSON 数据处理能力。通过预安装核心依赖，简化CI流程中Firebase相关操作的配置步骤，提高自动化部署和测试效率。

核心功能和特性

• Firebase工具集成：包含完整的firebase-cli，支持Firebase项目部署、函数管理、数据库操作、认证配置等核心功能
• jq JSON处理：内置jq工具，可高效解析、过滤和转换JSON数据，适用于处理CI流程中的配置文件、API响应等
• CI环境优化：精简镜像体积，预配置常用CI环境依赖，支持非交互式操作
• 版本稳定性：基于官方Node.js镜像构建，确保Firebase工具和jq版本的稳定性与兼容性

使用场景和适用范围

• 自动化部署Firebase项目（如Hosting、Functions、Realtime Database等）
• CI流程中处理JSON格式的配置文件或API响应数据
• 批量操作Firebase资源（如用户管理、规则配置更新）
• 集成到GitHub Actions、GitLab CI/CD、Jenkins等主流CI/CD平台

使用方法和配置说明

基本使用（Docker Run）

bash
# 查看Firebase版本
docker run --rm your-image-name firebase --version

# 查看jq版本
docker run --rm your-image-name jq --version

# 执行Firebase部署（需挂载Firebase配置文件）
docker run --rm -v $(pwd):/app -w /app your-image-name firebase deploy --token "$FIREBASE_TOKEN"

CI配置示例（GitHub Actions）

yaml
name: Deploy to Firebase
on:
  push:
    branches: [ main ]
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Use Firebase/jq CI image
        uses: docker://your-image-name
        with:
          args: firebase deploy --token ${{ secrets.FIREBASE_TOKEN }}

关键配置参数

• Firebase认证：通过环境变量FIREBASE_TOKEN传入Firebase访问令牌（可通过firebase login:ci生成）
• 工作目录：建议通过-w /app指定工作目录，并挂载项目代码到/app
• jq使用示例：处理Firebase配置文件

  bash
  # 从firebase.json中提取 Hosting 配置
  docker run --rm -v $(pwd):/app -w /app your-image-name jq '.hosting' firebase.json
  

注意事项

• 确保CI环境中已配置Firebase访问令牌（FIREBASE_TOKEN）并赋予足够权限
• 对于私有Firebase项目，需提前在CI环境中配置项目访问权限
• 如需使用特定版本的Firebase工具或jq，可通过Dockerfile自定义构建