如何配置CircleCI以成功构建未公开Firebase密钥的Angular5项目？

我来给你几个实用方案，不用把敏感的配置文件提交到公开仓库也能让CircleCI顺利完成构建：

方案1：用CircleCI环境变量动态生成配置文件 #

这是最常用的方案，把Firebase凭证拆成环境变量存在CircleCI里，构建时自动生成配置文件。

具体步骤：

1. 登录CircleCI控制台，找到你的项目，进入Project Settings > Environment Variables。
2. 把firebase.config.ts里的每个敏感字段都添加为独立的环境变量，比如FIREBASE_API_KEY、FIREBASE_AUTH_DOMAIN、FIREBASE_PROJECT_ID等。
3. 在项目根目录创建一个模板文件firebase.config.template.ts，用占位符代替实际值：

export const firebaseConfig = {
  apiKey: "${FIREBASE_API_KEY}",
  authDomain: "${FIREBASE_AUTH_DOMAIN}",
  projectId: "${FIREBASE_PROJECT_ID}",
  storageBucket: "${FIREBASE_STORAGE_BUCKET}",
  messagingSenderId: "${FIREBASE_MESSAGING_SENDER_ID}",
  appId: "${FIREBASE_APP_ID}"
};

4. 修改CircleCI的配置文件.circleci/config.yml，在构建前添加生成配置文件的步骤：

jobs:
  build:
    docker:
      - image: cimg/node:18.12.0 # 替换成你项目对应的Node版本
    steps:
      - checkout
      - run:
          name: Generate firebase.config.ts
          command: envsubst < firebase.config.template.ts > src/app/firebase.config.ts # 注意路径要和你项目中的实际路径一致
      - run: npm install
      - run: npm run build

这样CircleCI构建时会自动用环境变量替换模板里的占位符，生成正确的配置文件。

方案2：使用CircleCI私有文件存储 #

如果你的配置文件结构复杂，拆分环境变量太麻烦，可以直接把firebase.config.ts上传到CircleCI的私有存储：

1. 进入CircleCI项目设置的Project Settings > Artifacts > Private Files，上传你的firebase.config.ts文件。
2. 在.circleci/config.yml里添加下载文件的步骤：

jobs:
  build:
    steps:
      - checkout
      - run:
          name: Download firebase.config.ts
          command: circleci run download file /firebase.config.ts src/app/firebase.config.ts # 目标路径要匹配项目内的位置
      - run: npm install
      - run: npm run build

这个方法适合配置内容较多的场景，不用拆分多个变量。

方案3：Git子模块（适合有私有仓库的团队） #

如果你有一个私有GitHub仓库专门存放敏感配置，可以把firebase.config.ts放在那里，作为子模块引入主项目：

1. 在主项目中添加私有子模块：

git submodule add git@github.com:your-username/private-config-repo.git src/app/private-config

2. 给CircleCI添加访问私有仓库的SSH密钥（在项目设置的SSH Keys里配置）。
3. 在.circleci/config.yml里拉取子模块并复制配置文件：

jobs:
  build:
    steps:
      - checkout
      - run: git submodule update --init --recursive
      - run: cp src/app/private-config/firebase.config.ts src/app/firebase.config.ts
      - run: npm install
      - run: npm run build

不过这个方法需要维护额外的私有仓库，更适合团队协作场景。

关键注意事项 #

• 一定要确保firebase.config.ts在你的.gitignore文件里，防止不小心提交到公开仓库：

# .gitignore
src/app/firebase.config.ts

• 本地测试时，可以手动设置环境变量生成配置文件，验证构建是否正常：

export FIREBASE_API_KEY="your-actual-key"
envsubst < firebase.config.template.ts > src/app/firebase.config.ts
npm run build

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