拡張機能のインストールや管理を行うには、オーナーまたは編集者、あるいは Firebase 管理者のいずれかのロールが割り当てられている必要があります。
プロジェクトにインストールされている拡張機能インスタンスを一覧表示する
インストールした拡張機能のすべてのインスタンスを一覧表示できます。
拡張機能リストコマンドを実行します。
firebase ext:list --project=projectId-or-alias
インストールされている拡張機能インスタンスの詳細と設定を表示する
Firebase コンソールの Firebase Extensions ダッシュボードに移動します。
インストールした拡張機能インスタンスのカードの [管理] をクリックします。
インストールされている拡張機能インスタンスをモニタリングする
Firebase コンソールでは、インストールされている拡張機能のアクティビティをモニタリングできます(正常性、使用状況、ログの確認など)。
予算アラートを設定する
予算アラートの設定は、一般的に推奨されています。プロジェクトで他の関係者のコードを実行する場合は特に重要です。
Firebase プロジェクトの予算アラートを設定します。
拡張機能によって作成された関数を表示する
Firebase コンソールの Functions ダッシュボードに移動します。
[ダッシュボード] タブに、Firebase Extensions の関数が表示されます(プロジェクト用にデプロイした他の関数も表示されます)。
拡張機能によって作成された関数には、
ext-extension-instance-id-functionName
という形式の名前が付けられています。例:
ext-awesome-task-simplifier-onUserCreate
拡張機能によって作成された Cloud Scheduler ジョブを表示する
Google Cloud コンソールでプロジェクトの Cloud Scheduler ページを開きます。
ジョブリストに、Firebase Extensions の Cloud Scheduler ジョブが表示されます(プロジェクト用に作成した他のジョブも表示されます)。
拡張機能によって作成されたジョブには、
firebase-ext-extension-instance-id-functionName
という形式の名前が付けられています。例:
firebase-ext-awesome-task-simplifier-doTask
拡張機能によってキューに入れられた Cloud Tasks の表示と管理
拡張機能の中には、Cloud Tasks を使用して実行時間の長いタスクを実行するものがあります。最も一般的なのは、拡張機能のライフサイクルのさまざまな時点(インストール、再構成、アップグレード後)で実行される処理タスクです。
通常、これらのタスクは、ユーザーの操作を介さずに自動的に実行されて完了します。ただし、拡張機能のキューに入れられたタスクを手動で管理する必要がある場合(キューの一時停止や、開始前のタスクのキューからの削除など)は、次の手順を行います。
Firebase コンソールの [拡張機能] セクションで、拡張機能インスタンスの詳細ページを開きます。
詳細ページで [API とリソース] セクションを開きます。この拡張機能で Cloud Tasks を使用している場合は、1 つ以上のエントリを含む [Cloud Tasks キュー] セクションが表示されます。
管理するキューの [キューを表示] をクリックします。Google Cloud コンソールの [キューの詳細] ページが開き、キューに入れられたタスクの表示、キューの一時停止、キューからのタスクの削除などを行うことができます。Cloud Tasks ドキュメントのキューとタスクの管理をご覧ください。
拡張機能によって作成された Cloud Secret Manager のシークレットの表示
Google Cloud コンソールでプロジェクトの [Secret Manager] ページを開きます。
シークレットのリストに、Firebase Extensions 用に作成されたシークレットが表示されます(このプロジェクト用に作成した他のシークレットも表示されます)。
拡張機能によって作成されたシークレットには、
ext-extension-instance-id-paramnName
という形式の名前が付けられています。例:
ext-awesome-task-simplifier-API_KEY
シークレットにはキー
firebase-extensions-managed
のラベルが付けられています。Firebase によるシークレットの管理を停止する場合を除き、このラベルは削除しないでください。
インストールされている拡張機能が正常かどうかを確認する
関数のすべてのエラー(Firebase Extensions によって作成されたものを含む)は、コンソールで確認できます。
Functions ダッシュボードの [正常性] タブに、プロジェクト内のすべての関数のエラーとパフォーマンス情報の概要が表示されます。
特定の拡張機能の情報を表示するには、ページの上部にあるフィルタを使用して、関数を選択します。
インストールされている拡張機能の実行頻度を確認する
Functions ダッシュボードの [ダッシュボード] タブで、確認する Firebase Extension の特定の関数を見つけます。
エントリの右端にある
(オーバーフロー メニュー)をクリックし、[使用状況の詳細な統計情報] を選択します。表示される Google Cloud コンソールで、関数のさまざまな呼び出しにドリルダウンできます。ソースコードを調べることもできます。
拡張機能のログを表示する
プロジェクトをデバッグするときや、Firebase にバグレポートを送信するときは、プロジェクトで実行されている関数のログを表示すると便利です。
Functions ダッシュボードの [ログ] タブで、ページの上部にあるフィルタを使用して、拡張機能によって作成された関数を選択します。
インストールされている拡張機能インスタンスを最新バージョンに更新する
拡張機能のインストール済みインスタンスを最新のリリース バージョンに更新できます。インストール済みのインスタンスが、テスト、プロジェクト、アプリのワークフローでアクティブに実行または設定されているために、更新が必要になることがあります。
インスタンスを更新すると、新しいバージョンのソースコードとファイルを使用するように、インスタンスの拡張機能固有のリソースとロジックがすべて上書きされます。拡張機能のインスタンス ID とサービス アカウントは変更されません。
更新プロセス中に、新しいバージョンの変更点が通知され、新しいパラメータの値を指定できます。
Firebase Extensions ダッシュボードに移動し、インストールされている拡張機能インスタンスのカードの [管理] をクリックします。
右上の [拡張機能を更新] をクリックします。
拡張機能に新しいバージョンがない場合、詳細ページに更新ボタンは表示されません。
アップデートの新機能を確認し、必要に応じて拡張機能を構成します。
[拡張機能を更新] をクリックします。
インストールされている拡張機能インスタンスを再設定する
インストール済みの拡張機能インスタンスのユーザー設定パラメータの値を変更できます。これらの新しい値は、インスタンスの今後のトリガーで使用されます。拡張機能によってすでに作成されたアーティファクトや構造要素(保存された画像や既存の Storage バケットなど)は変更されません。
Firebase Extensions ダッシュボードに移動し、インストールされている拡張機能インスタンスのカードの [管理] をクリックします。
右上の [拡張機能を再構成] をクリックします。
画面上の指示に従って、拡張機能のパラメータ値を再構成します。
[保存] をクリックします。
拡張機能インスタンスをアンインストールする
Firebase プロジェクトから拡張機能のインスタンスをアンインストールできます。この操作により、サービス アカウントと、その拡張機能のインスタンス用に作成されたすべてのリソース(関数のセットなど)が削除されます。ただし、以下は削除されません。
拡張機能によって作成されたアーティファクト(保存された画像など)。
データベース インスタンスや Cloud Storage バケットなど、プロジェクト内の他のリソース。このような他のリソースを拡張機能が操作していた場合でも、拡張機能固有ではないため、拡張機能をアンインストールしても削除されません。
拡張機能をアンインストールする方法は次のとおりです。
Firebase Extensions ダッシュボードに移動し、インストールされている拡張機能インスタンスのカードの [管理] をクリックします。
画面の下部にある [拡張機能をアンインストールする] をクリックします。
削除する内容を確認し、[拡張機能をアンインストールする] をクリックして削除を確定します。