ローカルで出来たfirebase deployがGitHub Actionsでできない際に確認すべきこと

Posted at 2025-04-04

はじめに

firebaseでのnpm run buildとfirebase deployをローカル環境上では通せた状況で、GitHub Actionsを使った自動デプロイの際にfirebaseのデプロイを試みていたのですが何回も詰まってしまいました。

この記事では備忘録として、実際に起きた事例を書き起こしながら「どうすればデプロイできたか」を書いていきます。

今回の前提

ローカル環境でnpm run buildとfirebase deployを叩いたときにPassできること
GitHub Actions上でnpm run installとnpm run buildの自動デプロイまではできるようになっていること

最初に出たエラー / インストール周り

GitHub Actions上でfirebase deployの処理を回したところFailureとなりました。
エラーメッセージには以下のような文言が書かれていました。

/home/runner/work/_temp/0895dc39-d86e-46bb-af20-09cc466de998.sh: 
line 1: firebase: command not found

どうやらfirebaseのコマンドが見つからないことが原因のようです。

エラーへの対策

※こちらの記事に記載されていた方法を参考にしました。

コードを見返してみたところ、firebaseのインストールを経ずにいきなりfirebase deployをしていたことが原因でした。

そのため、上記の記事をもとにyamlファイルを次のように修正し、firebase-toolsをインストールする工程を加えました。

deploy.yaml

    - name: install
        run: npm install && npm install -g firebase-tools

すると最初に詰まっていたfirebase: command not foundのエラーは解消されました。無事にインストールは出来たようです。

次に出たエラー / 環境変数周り

firebaseをインストールした後にデプロイを試してみましたが再度エラーが出ました。

Error changing to directory firebase: Error: ENOENT: 
no such file or directory, chdir '(アプリのパス)' -> 'firebase'

その際の解消法として下記の記事を参考にしました。

考えられる原因としては作成したアプリでは.envファイルとして設定していたfirebaseの環境変数がGitHub Actions上で反映されていないことのようでした。

なので、yamlファイルのbuildの段階で環境変数の記載を加えることにしました。
また、firebaseのデプロイの際にはfirebase tokenも必要なため、これらを双方加えることにしました。

deploy.yaml

jobs:
  build:
    name: Build
    runs-on: ubuntu-latest
    # 環境変数を加えた部分①
    env:
      VITE_FIREBASE_API_KEY: ${{ secrets.VITE_FIREBASE_API_KEY }}
      VITE_FIREBASE_AUTH_DOMAIN: ${{ secrets.VITE_FIREBASE_AUTH_DOMAIN }}
      VITE_FIREBASE_PROJECT_ID: ${{ secrets.VITE_FIREBASE_PROJECT_ID }}
      VITE_FIREBASE_STORAGE_BUCKET: ${{ secrets.VITE_FIREBASE_STORAGE_BUCKET }}
      VITE_FIREBASE_MESSAGING_SENDER_ID: ${{ secrets.VITE_FIREBASE_MESSAGING_SENDER_ID }}
      VITE_FIREBASE_APP_ID: ${{ secrets.VITE_FIREBASE_APP_ID }}
    steps:
      - name: checkout
        uses: actions/checkout@v4

      - name: setup-node
        uses: actions/setup-node@v4
        with:
          node-version: "20"
          cache: npm

      - name: install
        run: npm install && npm install -g firebase-tools

      - name: build
        run: npm run build
        env:
          VITE_SUPABASE_URL: ${{secrets.SUPABASE_URL}}
          VITE_SUPABASE_ANON_KEY: ${{secrets.SUPABASE_ANON_KEY}}

    # 環境変数を加えた部分②
      - name: firebase deploy
        run: firebase deploy --token $FIREBASE_TOKEN
        env:
          FIREBASE_TOKEN: ${{ secrets.FIREBASE_TOKEN }}