firebase-app-hosting-basics

Next.js や Angular のアプリを、サーバー側描画ごと載せるときです。

扱う範囲は、デプロイ、apphosting.yaml の設定、秘密の値の管理、GitHub との CI/CD、そして課金の前提です。

★従量課金でないと使えません

本文の冒頭に太字で書かれています。

重要。App Hosting を使うには、Firebase のプロジェクトが Blaze（従量課金）の契約である必要がある。

無料の範囲では動きません。ここを知らずに進めると、途中で止まります。本文には契約を変更する管理画面の URL まで書かれています。

Hosting との線が引いてある

同じ公開元の firebase-hosting-basics と同じ比較表が、こちらにも入っています。

両方のスキルに同じ表が入っているのは良い作りです。どちらから読んでも、間違った側にいることに気づけます。

「git push で配る」が売りです

App Hosting 側の特徴として挙げられているのが、設定不要で git push から自動で配信する流れです。

Hosting は「ビルドと配信を自分で制御したい人向け」と書かれています。こちらは逆に握らない代わりに手間が減る側です。

ただし本文の推奨は手元からの deploy

比較表では git push が特徴に挙がっていますが、手順の節で多くの人に勧めているのは手元のソースからの配信です。GitHub と連携した自動配信は「より進んだ人向けで、App Hosting を使うのに必須ではない」と書かれています。

1. firebase.jsonapphosting の塊（backendId・rootDir・ignore）を書く
2. apphosting.yaml作るか直す（書き方は同梱の設定資料）
3. バックエンド無ければ apphosting:backends:create で作る（--backend・--primary-region・--root-dir）
4. 秘密の値要るならバックエンドを作ったあとに apphosting:secrets:set で登録し、secrets:grantaccess で読む権限を与える
5. 配信npx -y firebase-tools@latest deploy

バックエンドがあるかは apphosting:backends:list で確かめます。1 つの地域にはバックエンドが 10 個までで、上限に当たったら us-east4 のように --primary-region を変えよ、とあります。

秘密の値の管理が入っている

説明文に明示されています。apphosting.yaml で環境変数と秘密の値を扱います。

SSR のアプリは、サーバー側で API の鍵を使います。クライアントに出してはいけない値を扱うので、ここが独立した項目になっているのは妥当です。

除外が説明文に書いてある

従来の静的なウェブホスティング、Auth、Firestore、Crashlytics、Xcode には使うな。

リポジトリの 13 件のうち 6 件が、説明文で互いを除外しています（2026-10-23 確認。スキルが呼ばれないときの直し方）。

静的なサイトなら別物です

firebase-hosting-basics のほうが軽く、無料の範囲で動きます。

従量課金にできないなら使えません

前提です。

対応する枠組みでないなら合いません

Next.js と Angular が挙げられています。

ビルドの過程を細かく制御したいなら向きません

自動化されている代わりに、握れる部分が減ります。

CLI の導入やログインは別です

firebase-basics が先です。

解析で見つかった記述

SKILL.md の解析では、シェルコマンドを実行する記述とパッケージを導入する記述が見つかっています。同梱ファイルは 3 件で、CLI の命令、apphosting.yaml の設定、手元での試し方（エミュレータ）の資料です（2026-10-23 確認）。

費用が発生する

同梱の設定資料によると、配信は Cloud Run のサービスで動きます。minInstances は既定で 0 で、1 以上にすると起動待ちは無くなる代わりに常に温めておくことになります。

入れる前の確かめ方はスキルを入れる前に確認することにあります。

契約の変更を促される

本文に管理画面の URL が書かれています。組織の支払い方法を紐付ける操作です。規程を先に確認してください。

秘密の値を扱う

apphosting.yaml に環境変数と秘密の参照を書きます。秘密は Cloud Secret Manager に置き、apphosting:secrets:set で作る、と同梱の設定資料にあります。値そのものをリポジトリに入れないでください。

本文の例は、値を printf '%s' '<value>' で secrets:set --data-file - --force に流し込む形です。値がコマンドの文字列に入るので、シェルの履歴に残る環境では後で消すか、対話の入力で渡すほうが安全です。

手元の .env* は配信に上がらない、と同梱の設定資料にあります。要る変数や秘密は apphosting.yaml に書いておかないと、配信先で足りなくなります。

push が配信の引き金になる

GitHub と連携すると、push が配信の引き金になります。意図しない枝からの配信が起きないよう、対象の枝を確認してください。

SSR は攻撃面が増える

静的な配信と違い、サーバー側でコードが動きます。依存の更新を怠らないでください。

ライセンス

Apache-2.0。再配布や商用利用の前に公開元の表記を確認してください。

無料で使えますか

使えません。従量課金（Blaze）の契約が前提だと、本文の冒頭に書かれています。

静的なサイトでよければ firebase-hosting-basics が軽く済みます。

Next.js 以外も使えますか

Angular が挙げられています。説明文は「Next.js、Angular」と名指ししています。

他の枠組みについては本文に記載がないので、公開元の最新の案内を確認してください。

Hosting とどちらを選びますか

SSR や ISR が要るかで決まります。要るならこちら、静的なら Hosting です。

両方のスキルに同じ比較表が入っているので、どちらから読んでも判断できます。

秘密の値はどこに置きますか

apphosting.yaml で参照します。値そのものではなく参照です。

SSR のアプリはサーバー側で鍵を使うので、クライアントに出る値と出ない値を分けてください。

git push で自動配信されますか

連携すればされます。GitHub と連携すると、push を引き金に配信されます。

ただし本文が多くの人に勧めているのは手元からの deploy で、GitHub との連携は上級者向け・必須ではないと書かれています。

意図しない枝から配信されないよう、対象を確認してください。

対応しているエージェントはどれですか

公開元はこのファイルでは明記していません。同じ公開元の firebase-basics は Claude Code を含む 6 つの実行環境を名指ししています。

当サイトは公開元がそのスキルに明記しているものだけを表示する方針なので、このスキルのページには「記載なし」と出ます（指標の意味と限界）。