公式の Firebase 拡張機能は、Firebase コンソール、Firebase CLI(コマンドライン インターフェース)を使用して、または自動生成された SDK を使用してインストール(および管理)できます。
各インストール方法でサポートされるアクションの違いを必ず確認してください。
拡張機能のインストールや管理を行うには、オーナーまたは編集者、あるいは Firebase 管理者のいずれかのロールが割り当てられている必要があります。
拡張機能をインストールするには、プロジェクトが Blaze(従量課金制)プランを利用している必要があります。拡張機能のインストールは無料ですが、Firebase サービス、または Cloud Secret Manager などのクラウド サービスの使用に対しては、使用量がサービスの無料枠を超えた場合に請求されることがあります。
始める前に
まだ行っていない場合は、Firebase をプロジェクトに追加し、Firebase プロジェクトを Blaze(従量課金制)プランにアップグレードします。
ステップ 1: 拡張機能の詳細情報を表示する
この手順は省略可能ですが、行うことを強くおすすめします。
Firebase Extension をインストールする前に、次のような拡張機能の詳細情報を確認することをおすすめします。
- 拡張機能の仕組み、プリインストール タスク、拡張機能の詳細
- 一般的な識別情報と説明
- 拡張機能のタスクに請求先アカウントが必要かどうか
- 動作に必要な Google サービス(API)とアクセスロール
- 拡張機能用に作成されたリソース(関数など)
- ユーザー構成可能なパラメータの説明
拡張機能の詳細情報を表示するには:
Extensions Hub で公式の Firebase 拡張機能をご覧ください。
拡張機能のカードをクリックすると、次のことができます。
拡張機能の詳細情報を表示する。
Firebase Extensions ソース リポジトリで拡張機能のソースコードへのリンクを見つける。
この詳細情報は、拡張機能の拡張機能ディレクトリにある
README
で確認できます。
ステップ 2: 拡張機能をインストールする
インストール中に、拡張機能の基本仕様(有効になる API、作成されるリソース、付与されるアクセス権など)を確認するよう求められます。課金の要件があれば、通知されます。また、拡張機能の構成可能なパラメータの値を指定するよう求められます。
Extensions Hub で公式の Firebase 拡張機能をブラウジングします。
拡張機能のカードをクリックし、拡張機能の詳細情報を確認して、特定の使用手順やプリインストール タスクを確認します。
[インストール] をクリックし、画面の指示に沿って拡張機能をインストールします。
ステップ 3: インストール後の設定を完了する
拡張機能によっては、使用する前に行っておかなければならない必須の手順があるものや、オプションの手順があるものがあります。それらの手順は、Firebase コンソールの Extensions ダッシュボードに表示されるインストール後の詳細ページで確認できます(インストール後、ターミナルにダッシュボードへのリンクが表示されます)。
それらの手順は、拡張機能のソース ディレクトリにある POSTINSTALL.md
ファイルでも確認できます。
Firebase リソースを作成する
Firebase リソース(Cloud Firestore コレクション、Realtime Database パス、Cloud Storage バケット)を使用するように拡張機能が構成されていて、それらのリソースがまだ存在していない場合は、拡張機能を使用する前にそれらを作成してください。
Eventarc イベント ハンドラを作成する
拡張機能の中には、実行中に重要なイベントが発生すると Eventarc に公開されるものがあります。拡張機能がイベントを公開するものであり、インストール時にイベントを有効にした場合、独自のカスタム ロジックを使用してこれらのイベントに応答する関数を作成できます。これは、たとえば、長時間実行タスクが完了したときにユーザーに通知する場合や、拡張機能の出力を後処理する場合に役立ちます。
公開するイベント(ある場合)のリストについては、拡張機能のドキュメントをご覧ください。 例については、Run Payments with Stripe 拡張機能のイベントタイプをご覧ください。
Eventarc イベント ハンドラの詳細については、カスタム イベント トリガーをご覧ください。
複数の拡張機能インスタンスをインストールする
同じプロジェクトに同じ拡張機能を複数回インストールできます。インストールされたインスタンスごとに、カスタマイズされた独自の設定と独自の拡張機能リソースを設定できます。インストールされた各インスタンスは、プロジェクト内で一意のインスタンス ID を使用して識別し、参照します。
拡張機能のインスタンスを追加でインストールするたびに、インスタンス ID を確認または編集するよう求められます。
次のステップ
Firebase コンソールで、インストールした拡張機能の詳細と構成を表示する。
インストールした拡張機能のアクティビティをモニタリングする。これには、拡張機能の健全性、使用状況、ログの確認が含まれます。
Firebase コンソールを使用して、インストールした拡張機能を管理します。Firebase の公式拡張機能の場合は、拡張機能の再構成、アンインストール、最新バージョンへの更新ができます。
すべてのプロジェクトのベスト プラクティスとして、プロジェクトの予算アラートを設定し、Firebase コンソールで[使用量と請求額] ダッシュボードをモニタリングする。