Firebase と GitHub の連携は、ほとんどの場合「GitHub Actions が Firebase CLI を動かして Firebase Hosting に公開する」構成を指します。Firebase CLI の firebase init hosting:github を1回実行すれば、サービスアカウントの作成、GitHub Secrets への登録、ワークフローの生成(本番用は選んだ場合のみ)までが終わります。ただし、生成されるファイルは 2026年9月23日の Node 20 削除に追いついておらず、付与されるロールも静的サイトには広すぎます。この記事では、生成物の中身を firebase-tools のソースで確かめたうえで、直すべき箇所、鍵を置かない認証、GitHub Actions を使わない App Hosting の連携までを順に扱います。GitHub Actions そのものの基礎はGitHub Actionsとは?できること・使い方と最初のワークフロー、料金と上限で解説しています。
まとめ:Firebase と GitHub を連携するときの判断
- 静的サイト・SPA なら Firebase Hosting + GitHub Actions。
firebase init hosting:githubがプレビュー用(プルリクエスト)のワークフローを作り、本番への自動デプロイを選べば本番用(main への push)も加えて2本になる。 - 生成された YAML は
actions/checkout@v4(Node 20 向け)のままなので v5 以降へ上げる。デプロイ用のFirebaseExtended/action-hosting-deploy@v0は v0.11.0 で Node 24 化済み。 - 自動で作られるサービスアカウントには Hosting 以外のロールも付く(Authentication 管理者・Cloud Functions 開発者など6つ)。Hosting だけなら外してよいロールを確認する。
- チームの本番リポジトリは Workload Identity Federation(WIF)で鍵を置かない。このときデプロイアクションは JSON 鍵が必須なので、
firebase-toolsを直接実行する。 - Next.js 13.5 以降・Angular 18.2 以降の SSR は App Hosting の GitHub 連携。ライブブランチへの push で自動ロールアウトされ、GitHub Actions は不要。
Firebase と GitHub Actions の役割の違い|連携方式は3つ
「firebase vs github actions」で検索されることがありますが、両者は同じ役割を奪い合う製品ではありません。Firebase Hosting は Web アプリの公開先、GitHub Actions は push やプルリクエストを合図に処理を走らせる実行基盤です。比べるべきなのは「GitHub のリポジトリから Firebase へ、どの経路で公開するか」で、選択肢は次の3つに分かれます。
| 経路 | 動く場所 | 向く対象 | プレビューURL |
|---|---|---|---|
| Hosting + GitHub Actions | GitHub のランナー | 静的サイト・SPA | PR ごとに自動発行 |
| App Hosting の GitHub 連携 | Google Cloud 側のビルド | Next.js・Angular の SSR | なし(ロールアウト単位) |
| 手元から firebase deploy | 開発者の PC | 個人の検証 | 手動で channel:deploy |
手元からの firebase deploy でも公開はできます。GitHub 側に寄せる理由は2つで、公開手順がリポジトリに残って担当者に依存しなくなることと、マージ前のプレビューURLをレビュー担当に渡せることです。ビルドや自動テストを公開の前に通す構成はGitHub Actionsでビルド・自動テストを設定する方法と同じワークフローにデプロイの手順を足す形になります。Hosting と App Hosting の選定そのものはFirebase Hostingとは|静的とSPA配信の仕組みとApp Hostingとの選定基準で比べています。
firebase init hosting:github で連携を作る手順
手作業で鍵を作る前に、まず CLI の連携コマンドを使います。公式手順は Firebase Hosting の GitHub 連携ドキュメントにあり、ここではその裏で何が作られるかを firebase-tools のソース(github.ts)で確かめた結果も併せて書きます。
Firebase CLI の導入と Hosting の初期化
firebase-tools の最新は 2026年10月22日公開の v15.34.1 です。グローバルに入れてログインし、Hosting を初期化したディレクトリで GitHub 連携を実行します。
npm install -g firebase-tools
firebase login
firebase init hosting
firebase init hosting:github
途中でブラウザが開き、GitHub の認可を求められます。続けて連携先のリポジトリ(your-org/your-repo の形式)、ビルドコマンド、本番デプロイに使うブランチを聞かれます。ブランチはリポジトリの既定ブランチが初期値です。
GitHub 連携の生成物:サービスアカウント・Secret・ワークフロー
- サービスアカウント:名前は
github-action-<リポジトリの数値ID>。JSON 鍵も同時に作られる。 - GitHub の Secret:鍵をリポジトリの公開鍵で暗号化して登録する。名前は
FIREBASE_SERVICE_ACCOUNT_にプロジェクトIDを付けたもので、ハイフンはアンダースコアに置き換えて大文字にする(my-app-prodならFIREBASE_SERVICE_ACCOUNT_MY_APP_PROD)。 - ワークフロー:
.github/workflows/firebase-hosting-pull-request.yml(プレビュー用)。本番への自動デプロイを選ぶとfirebase-hosting-merge.yml(本番用)も作られる。
ワークフローはまだローカルにあるだけです。ブランチを切ってコミットし、プルリクエストを出せば、そのプルリクエスト自体で最初のプレビューデプロイが走ります。
連携用サービスアカウントの6ロールと静的 Hosting 向けの権限削減
作られたサービスアカウントには、ソース上で次の6ロールが付与されます。コメントに付与理由が書かれているので併記します。
| ロール | ソース上の付与理由 |
|---|---|
| roles/firebasehosting.admin | プレビューチャネルへのデプロイ |
| roles/firebaseauth.admin | プレビューURLを Auth の承認済みドメインへ追加 |
| roles/serviceusage.serviceUsageConsumer | 同上(承認済みドメインの追加) |
| roles/serviceusage.apiKeysViewer | CLI のデプロイ |
| roles/run.viewer | Cloud Run への rewrites を使う場合 |
| roles/cloudfunctions.developer | Web Frameworks のプレビュー |
Firebase Authentication を使わない静的サイトに firebaseauth.admin を持たせる理由はありません。鍵が漏れたときに Auth のユーザーを操作できる権限まで一緒に渡ることになるため、Auth を使わない・Cloud Run や Cloud Functions に rewrites していないなら、Google Cloud コンソールの IAM で該当ロールを外します。外したあとはプレビューと本番のデプロイを1回ずつ流し、権限不足のエラーが出ないことを確かめてください。
生成されたワークフローの中身と Node 24 向けの修正
生成される YAML は actions/checkout@v4 と FirebaseExtended/action-hosting-deploy@v0 を参照します。GitHub は 2026年9月23日に Node 20 をランナーから削除し、JavaScript アクションはすべて Node 24 で動くようになりました。一時的な回避策だった ACTIONS_ALLOW_USE_UNSECURE_NODE_VERSION も使えません。runs.using: node20 のまま止まっている版を参照していると、作者が想定していない Node で実行されることになります。
Node 20 削除で版を上げる必要があるアクション
各アクションの action.yml を版ごとに確認した結果です(2026年10月28日時点)。
| アクション | Node 20 の版 | Node 24 の版 | 最新 |
|---|---|---|---|
| actions/checkout | v4 | v5 以降 | v7.0.1 |
| FirebaseExtended/action-hosting-deploy | v0.10.0 まで | v0.11.0・v0 | v0.11.0 |
| google-github-actions/auth | v2 | v3 | v3.0.0 |
action-hosting-deploy は 2026年6月25日の v0.11.0 で実行環境を Node 24 に上げ、v0 タグも同じコミットを指しています。@v0 で参照していれば何もしなくてよく、@v0.10.0 やコミットSHAに固定している場合だけ更新が要ります。setup-node など他のアクションの移行点はactions/setup-nodeとは|v7.1の入力・キャッシュ設定とv4からの移行点にまとめています。
本番用ワークフロー:main への push と live チャネルへの公開
アクションを Node 24 対応版に更新し、npm のビルド手順を追加した例です。package-lock.json と build スクリプトがあるプロジェクトを前提とし、ビルド不要の静的HTMLでは npm のステップを削除します。アプリのビルドに使う Node.js の版はアクション内部の実行環境とは別なので、必要に応じて setup-node で指定します。Secret 名は自分のプロジェクトIDに合わせます。
name: Deploy to Firebase Hosting on merge
on:
push:
branches:
- main
jobs:
build_and_deploy:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v7
- run: npm ci && npm run build
- uses: FirebaseExtended/action-hosting-deploy@v0
with:
repoToken: ${{ secrets.GITHUB_TOKEN }}
firebaseServiceAccount: ${{ secrets.FIREBASE_SERVICE_ACCOUNT_MY_APP_PROD }}
channelId: live
projectId: my-app-prod
channelId: live が本番公開の指定です。ビルドの出力先(dist/ や build/)は firebase.json の hosting.public と一致させます。ここがずれていると、デプロイは成功するのに古いファイルや空のページが公開されます。
プレビュー用ワークフロー:フォーク PR の実行除外
name: Deploy to Firebase Hosting on PR
on: pull_request
permissions:
checks: write
contents: read
pull-requests: write
jobs:
build_and_preview:
if: ${{ github.event.pull_request.head.repo.full_name == github.repository }}
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v7
- run: npm ci && npm run build
- uses: FirebaseExtended/action-hosting-deploy@v0
with:
repoToken: ${{ secrets.GITHUB_TOKEN }}
firebaseServiceAccount: ${{ secrets.FIREBASE_SERVICE_ACCOUNT_MY_APP_PROD }}
projectId: my-app-prod
生成物には if の条件が入っており、フォークからのプルリクエストではジョブが実行されません。pull_request イベントではフォークからの実行に Secrets が渡らないためです。OSS で外部の PR にもプレビューを出したくて pull_request_target に切り替える例がありますが、このイベントはベース側のコンテキストで動作します。そこでフォークのコードをチェックアウトして実行すると、ベース側の Secrets が漏れる危険があります。actions/checkout は v7.0.0(2026年6月18日)から、pull_request_target と workflow_run でフォークの PR をチェックアウトすることを既定で拒否します。外部 PR のプレビューは、メンテナがブランチを取り込んでから出す運用のほうが安全です。
action-hosting-deploy の入力と出力
「firebaseextended/action-hosting-deploy@v0」の設定では、入力の必須項目・既定値と、後続ステップで使える出力を確認します。action.yml の定義をそのまま表にしました。
| 入力 | 必須 | 既定値 | 用途 |
|---|---|---|---|
| firebaseServiceAccount | 必須 | なし | サービスアカウントの JSON |
| repoToken | 任意 | なし | PR へのコメント投稿 |
| projectId | 任意 | .firebaserc | 公開先のプロジェクト |
| channelId | 任意 | PR・ブランチ単位で自動 | live で本番 |
| expires | 任意 | 7d | プレビューの有効期間 |
| target | 任意 | 全ターゲット | 複数サイトの絞り込み |
| entryPoint | 任意 | . | firebase.json の位置 |
| firebaseToolsVersion | 任意 | latest | CLI の版固定 |
| disableComment | 任意 | false | PR コメントを止める |
| force | 任意 | false | –force を付ける |
出力は urls・details_url・expire_time・expire_time_formatted の4つで、後続ステップで E2E テストを当てるときにプレビューURLを受け取れます。expires は 公式ドキュメントのとおり最長30日で、期限になるとプレビューURLが無効になり、チャネルとそのリリースは24時間以内の削除対象になります。プレビューチャネル自体は公式にベータ扱いです。
運用上の判断は2つあります。firebaseToolsVersion の既定は latest なので、CLI の更新でデプロイが壊れた日に原因を追いにくくなります。本番用だけでも 15.34.1 のように固定しておくと切り分けが早くなります。force: true は確認プロンプトを自動で承認するため、Functions の削除を伴う構成では付けないでください。同じ設定を複数のリポジトリで使い回すなら、共通部分をReusable Workflowsの使い方|GitHub Actionsのworkflow_call・secrets・outputsと上限の形で切り出せます。
鍵を置かない Workload Identity Federation 構成
サービスアカウントの JSON 鍵は既定では有効期限がなく、有効な鍵が漏れると第三者がそのアカウントの権限を使えます。組織ポリシーによる期限設定や、鍵の無効化・削除は可能です。Workload Identity Federation(WIF)は、GitHub Actions が発行する OIDC トークンを Google Cloud が検証し、その場限りのアクセストークンを払い出す仕組みです。鍵の保管もローテーションも要りません。個人の検証なら JSON 鍵で足ります。複数人が触る本番リポジトリは WIF に移す、というのがこの記事の線引きです。
Google Cloud の WIF プールとプロバイダの作成
google-github-actions/auth の README の手順を Firebase のプロジェクトに当てはめました。デプロイ用サービスアカウント [email protected] が未作成なら、先に gcloud iam service-accounts create deployer --project=my-app-prod を実行します。プロジェクトID・プロジェクト番号・組織名・リポジトリ名は実際の値に置き換え、プロバイダには属性条件を付けて自分の組織以外からの認証を拒否します。
gcloud iam workload-identity-pools create "github" \
--project="my-app-prod" --location="global" \
--display-name="GitHub Actions Pool"
gcloud iam workload-identity-pools providers create-oidc "my-repo" \
--project="my-app-prod" --location="global" \
--workload-identity-pool="github" \
--attribute-mapping="google.subject=assertion.sub,attribute.repository=assertion.repository,attribute.repository_owner=assertion.repository_owner" \
--attribute-condition="assertion.repository_owner == 'your-org'" \
--issuer-uri="https://token.actions.githubusercontent.com"
gcloud iam service-accounts add-iam-policy-binding \
"[email protected]" \
--project="my-app-prod" \
--role="roles/iam.workloadIdentityUser" \
--member="principalSet://iam.googleapis.com/projects/123456789/locations/global/workloadIdentityPools/github/attribute.repository/your-org/your-repo"
3つ目のコマンドで、特定のリポジトリだけがこのサービスアカウントを借りられるようにしています。借りる側のサービスアカウントには、前章で確認した Hosting 用のロールだけを付けます。README は、サービスアカウントを挟まずプールに直接権限を与える方式を推奨としていますが、同時に「すべての Google Cloud リソースが principalSet に対応しているわけではない」「トークンの寿命は最長10分」と注記しています。Firebase のデプロイで使う API が principalSet に対応しているかを確かめるまでは、サービスアカウント経由で組むのが確実です。
WIF ワークフローでの firebase-tools の直接実行
action-hosting-deploy は firebaseServiceAccount を必須入力として受け取り、その文字列を一時ファイルに書き出して認証に使う実装です(src/index.ts)。WIF では JSON 鍵が存在しないので、認証は auth アクションに任せ、デプロイは CLI で行います。
name: Deploy to Firebase Hosting (WIF)
on:
push:
branches:
- main
permissions:
contents: read
id-token: write
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v7
- run: npm ci && npm run build
- uses: google-github-actions/auth@v3
with:
workload_identity_provider: projects/123456789/locations/global/workloadIdentityPools/github/providers/my-repo
service_account: [email protected]
- run: npx [email protected] deploy --only hosting --project my-app-prod
id-token: write が無いと OIDC トークンを発行できず、auth のステップで失敗します。auth が作る資格情報ファイル gha-creds-*.json は $GITHUB_WORKSPACE に書き出されるので、checkout は auth より前に置きます。このファイルは Git の管理対象から外し、Hosting の公開ディレクトリをリポジトリのルートにしている場合は hosting.ignore にも同じパターンを入れてください。
同一リポジトリ内の PR に WIF でプレビューを出すなら、トリガーを on: pull_request に変え、ジョブに if: ${{ github.event.pull_request.head.repo.full_name == github.repository }} を足したうえで、最後の行を npx [email protected] hosting:channel:deploy pr-${{ github.event.number }} --expires 7d --project my-app-prod にします。URL の PR コメントは自前で投稿するので、permissions に pull-requests: write も加えます。firebase login:ci で作るトークン(--token)は firebase-tools 15.34.1 でも非推奨の警告が出るため採用しません。CI で WIF を使ったときの認証エラーの実例はFirebase CLIとは|firebase-tools 15系の認証とデプロイ運用で扱っています。
App Hosting の GitHub 連携を選ぶ場面
Next.js や Angular をサーバーサイドで描画するなら、Hosting + GitHub Actions ではなく App Hosting を検討します。App Hosting のスタートガイドによると、対象は Next.js 13.5.x 以降と Angular 18.2.x 以降で、従量課金の Blaze プランが必要です。
- 連携の仕方:Firebase コンソールでバックエンドを作るときに GitHub のリポジトリを接続し、ライブブランチ(通常は main)を選ぶ。ワークフローファイルも Secrets も作らない。
- デプロイの契機:自動ロールアウトが有効なら、ライブブランチに push するたびにビルドとロールアウトが走る。結果は GitHub のチェックにも出る。
- 無駄なビルドを止める:ロールアウトの管理ドキュメントのとおり、Settings > Rollouts > Rollout triggers で Required Paths を指定すると、そのパス以外だけを変えたコミットはビルドが SKIPPED になる。モノレポで README だけ直した commit まで本番に流れるのを防げる。
- 手動・別ブランチ:
firebase apphosting:rollouts:create BACKEND_ID --git-branch BRANCH_NAMEで任意のブランチからロールアウトできる。
App Hosting には PR ごとのプレビューURLがありません。レビュー段階で実画面を配りたい要件が強い SPA は、Hosting + GitHub Actions のままが向いています。逆に、SSR のために Cloud Functions と rewrites を組み合わせている Hosting 構成は、App Hosting に移すと上の6ロールのような権限の管理ごと手放せます。
CI/CD の設計をチームで引き継げる形に整えたい場合は、弊社のDevOps・CI/CD導入支援でワークフローと権限の設計からお手伝いしています。
デプロイが失敗するときの切り分け
連携直後の失敗は、認証・権限・ビルド出力の3つでほぼ説明できます。ジョブのログでは action-hosting-deploy か firebase deploy のステップを開くと、CLI のエラー行がそのまま読めます。
| 症状 | まず疑う箇所 |
|---|---|
| Input required and not supplied: firebaseServiceAccount | Secret 名の綴り・フォーク PR |
| HTTP 403・Permission denied | 外しすぎたロール |
| 公開先が別プロジェクト | projectId と .firebaserc |
| 公開されたが中身が古い・空 | hosting.public とビルド出力 |
| auth ステップで失敗(WIF) | id-token: write・属性条件 |
順番は「誰として実行しているか(認証)」「その主体に Hosting の権限があるか(権限)」「何を公開したか(ビルド出力)」です。ロールを絞った直後に 403 が出たら、付与理由の表に戻って必要なロールを1つずつ足し戻します。ローカルで同じ構成を再現して確かめたいときは、Firebase Local Emulator Suiteとは|ローカル再現の構成とCI組み込みの手順が使えます。
よくある質問
Firebase と GitHub Actions はどちらを使うべきですか?
どちらか一方を選ぶものではありません。Firebase Hosting が公開先、GitHub Actions が公開を自動で実行する仕組みで、組み合わせて使います。SSR のアプリなら、GitHub Actions を使わずに App Hosting の GitHub 連携で公開する方法もあります。
FirebaseExtended/action-hosting-deploy@v0 は今も使えますか?
使えます。v0 タグは 2026年6月25日の v0.11.0 と同じコミットを指し、Node 24 で動きます。@v0.10.0 以前に固定している場合は Node 20 向けのままなので更新してください。
FIREBASE_SERVICE_ACCOUNT の Secret はどこで作られますか?
firebase init hosting:github が自動で作り、FIREBASE_SERVICE_ACCOUNT_ にプロジェクトIDを大文字・アンダースコアにしたものを付けた名前で登録します。手動で作る場合は、Google Cloud の IAM でサービスアカウントの鍵(JSON)を発行し、リポジトリの Settings > Secrets and variables > Actions に中身を貼ります。
プレビューURLはいつ消えますか?
この記事のデプロイアクションでは、既定で最後のデプロイから7日後が期限となり、再デプロイのたびに期限が更新されます。expires で最長30日まで延ばせます。同じ PR に追加の commit を push すると、URL は変わらず中身だけが更新されます。
GitHub Actions の無料枠でデプロイできますか?
パブリックリポジトリの標準ランナーは無料です。プライベートリポジトリは Free プランで月2,000分の枠があり、枠に収まるかは、各ジョブの実行時間と月間実行回数、同じアカウントで動く他のワークフローの使用量で判断します。超過時の単価はGitHub Actionsの料金|2026年改定後の分単価・無料枠とコスト削減の判断基準で確認できます。