GitLab CI/CD中FIREBASE_TOKEN弃用，如何配置Google凭据部署？

安全阿岳

2026-7-29

在GitLab流水线中用Google凭据替换Firebase Token

1. 生成Google服务账号密钥

打开Google Cloud控制台，找到你Firebase项目对应的Cloud项目（Firebase项目自动关联Cloud项目）
进入「IAM与管理员」→「服务账号」页面
新建或选择一个服务账号，给它分配「Firebase Admin SDK管理员」权限
点击该服务账号→「密钥」→「添加密钥」→「创建新密钥」，选JSON格式下载密钥文件

2. 在GitLab配置环境变量

打开你的GitLab项目，进入「设置」→「CI/CD」→「变量」
添加变量GOOGLE_APPLICATION_CREDENTIALS_CONTENT，把下载的JSON密钥内容粘贴到值里，勾选「保护变量」和「掩码变量」

3. 修改GitLab CI脚本

替换原来依赖FIREBASE_TOKEN的部署脚本，改成用Google凭据认证：

deploy_to_firebase:
  stage: deploy
  # 用包含gcloud的镜像更方便，无需额外安装工具
  image: google/cloud-sdk:latest
  before_script:
    - npm install -g firebase-tools
    # 将环境变量中的密钥内容写入临时文件
    - echo "$GOOGLE_APPLICATION_CREDENTIALS_CONTENT" > /tmp/service-account.json
    - export GOOGLE_APPLICATION_CREDENTIALS="/tmp/service-account.json"
    # 通过gcloud获取服务账号令牌，完成Firebase CI登录
    - firebase login:ci --token "$(gcloud auth print-access-token)"
  script:
    - firebase deploy --only hosting --project 你的项目ID --non-interactive
  only:
    - main

注意事项：

把你的项目ID替换为实际的Firebase项目ID
如果坚持使用node基础镜像，需要在before_script中先安装gcloud：curl https://sdk.cloud.google.com | bash && source ~/.bashrc
部署命令中的--only hosting可根据需求调整（比如添加functions等部署目标）