Firebase Summit で発表されたすべての情報をご覧ください。Firebase を使用してアプリ開発を加速し、自信を持ってアプリを実行する方法を紹介しています。詳細

インストールされているFirebaseExtensionsを管理する

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

拡張機能をインストールまたは管理するには、所有者、編集者、またはFirebase 管理者 のいずれかの役割が割り当てられている必要があります。

プロジェクトにインストールされている拡張機能のインスタンスを一覧表示する

インストールした拡張機能のすべてのインスタンスを一覧表示できます。

extensions-list コマンドを実行します。

firebase ext:list --project=projectId-or-alias

インストールされた拡張インスタンスを監視する

Firebase コンソールでは、正常性、使用状況、ログのチェックなど、インストールされた拡張機能のアクティビティを監視できます。

予算アラートを設定する

一般に、予算アラートを設定することは良い方法ですが、別のパーティのコードがプロジェクトで実行されることを信頼している場合は、アラートが特に重要になる場合があります。

Firebase プロジェクトの予算アラートを設定していることを確認してください。

拡張機能によって作成されたビュー関数

  1. Firebase コンソールのFunctions ダッシュボードに移動します。

  2. [ダッシュボード] タブでは、Firebase Extensions の関数を (プロジェクトにデプロイした他の関数と共に) 表示できます。

    拡張機能によって作成された関数には、 ext- extension-instance-id - functionNameの形式の名前があります。

    例: ext-awesome-task-simplifier-onUserCreate

拡張機能によって作成された Cloud Scheduler ジョブを表示する

  1. Google Cloud Console でプロジェクトのCloud Schedulerページを開きます。

  2. [ジョブ] リストでは、Firebase Extensions からの Cloud Scheduler ジョブを (プロジェクト用に作成した他のジョブと共に) 表示できます。

    拡張機能によって作成されたジョブには、次の形式の名前があります: firebase-ext- extension-instance-id - functionName

    例: firebase-ext-awesome-task-simplifier-doTask

拡張機能によってキューに入れられた Cloud Tasks の表示と管理

一部の拡張機能は、 Cloud Tasksを使用して実行時間の長いタスクを実行します。最も一般的なタスクは、拡張機能のライフサイクルのさまざまな時点 (インストール、再構成、アップグレード後) で実行される処理タスクです。

通常、これらのタスクは、ユーザーの介入なしで自動的に実行および完了します。ただし、キューを一時停止したり、まだ開始されていないタスクをキューから削除したりするなど、拡張機能のキューに入れられたタスクを手動で管理する必要がある場合は、次の手順に従います。

  1. Firebase コンソールの [拡張機能] セクションで、拡張機能インスタンスの詳細ページを開きます。

  2. 詳細ページで、 API とリソースセクションを開きます。拡張機能が Cloud Tasks を使用する場合、 Cloud Task キューセクションに 1 つ以上のエントリが表示されます。

  3. 管理するキューの[キューを表示]をクリックします。これにより、Google Cloud Console の [キューの詳細] ページが開きます。ここから、キューに入れられたタスクを表示したり、キューを一時停止したり、キューからタスクを削除したりできます。 Cloud Tasks ドキュメントのキューとタスクの管理をご覧ください。

拡張機能によって作成された Cloud Secret Manager シークレットを表示する

  1. Google Cloud Console でプロジェクトのSecret Managerページを開きます。

  2. シークレット リストでは、Firebase 拡張機能用に作成されたシークレットを (プロジェクト用に作成した他のシークレットと一緒に) 表示できます。

    拡張機能によって作成されたシークレットには、次の形式の名前があります: ext- extension-instance-id - paramnName

    例: ext-awesome-task-simplifier-API_KEY

    シークレットはキーfirebase-extensions-managedでラベル付けされます。 Firebase によるシークレットの管理を停止する場合を除き、このラベルを削除しないでください。

インストールされた拡張機能が正常かどうかを確認する

コンソールで関数 (Firebase Extensions によって作成されたものを含む) からのすべてのエラーを確認できます。

  1. Functions ダッシュボードの [ Health ] タブでは、プロジェクト内のすべての関数のエラーの概要とパフォーマンス情報を表示できます。

  2. 特定の拡張機能の情報を表示するには、ページ上部のフィルターを使用して特定の機能を選択します。

インストールされた拡張機能が実行されている頻度を確認する

  1. Functions ダッシュボード の [ダッシュボード] タブで、確認する Firebase 拡張機能の特定の関数を見つけます。

  2. エントリの右端にある [ ] (オーバーフロー メニュー) をクリックし、[詳細な使用統計] を選択します。

  3. 表示された Google Cloud Console では、関数のさまざまな呼び出しにドリルダウンし、そのソース コードを調べることもできます。

拡張機能のログを表示する

プロジェクトをデバッグしようとしている場合、または Firebase にバグ レポートを送信しようとしている場合は、プロジェクトで実行されている関数のログを表示すると便利です。

関数ダッシュボードの [ログ] タブで、ページの上部にあるフィルターを使用して、拡張機能によって作成された関数を選択します。

インストールされている拡張インスタンスを最新バージョンに更新する

拡張機能のインストール済みインスタンスを最新リリース バージョンに更新できます。インスタンスが既にアクティブに実行されているか、テスト、プロジェクト、またはアプリのワークフローでセットアップされているため、インストール済みのインスタンスを更新する必要がある場合があります。

インスタンスを更新すると、インスタンスのすべての拡張機能固有のリソースとロジックが上書きされ、新しいバージョンのソース コードとファイルが使用されます。拡張機能のインスタンス ID とサービス アカウントは変更されません。

更新プロセス中に、新しいバージョンの変更が通知され、新しいパラメーターの値を指定できるようになります。

  1. 拡張機能マニフェストの拡張機能インスタンスを最新バージョンに更新するには、拡張機能更新コマンドを実行します。

    firebase ext:update extensionInstanceId

    特定のバージョンに更新するには、更新先のバージョンを指定します。

    firebase ext:update extensionInstanceId versionNumber
  2. 次に、マニフェストの拡張機能を Firebase プロジェクトにデプロイするには、次を実行します:

    firebase deploy --only extensions --project=projectId-or-alias

インストールされた拡張インスタンスを再構成する

インストールされた拡張インスタンスのユーザー構成パラメーターの値を変更できます。これらの新しい値は、インスタンスの将来のトリガーで使用されますが、拡張機能によって作成された以前のアーティファクトまたは構造要素 (保存された画像や既存のストレージ バケットなど) はすべて変更されません。

  1. 拡張機能マニフェストで拡張機能を対話的に再構成するには、拡張機能構成コマンドを実行します。

    firebase ext:configure extensionInstanceId
  2. 次に、マニフェストの拡張機能を Firebase プロジェクトにデプロイするには、次を実行します:

    firebase deploy --only extensions --project=projectId-or-alias

拡張インスタンスをアンインストールする

Firebase プロジェクトから拡張機能のインスタンスをアンインストールできます。このアクションにより、Firebase がその拡張機能のインスタンス専用に作成したサービス アカウントとすべてのリソース(一連の関数など) が削除されます。ただし、次のものは削除されません

  • 拡張機能によって作成されたアーティファクト (保存された画像など)。

  • データベース インスタンスや Cloud Storage バケットなど、プロジェクト内のその他のリソース。拡張機能がこれらの他のリソースとやり取りした場合でも、それらは拡張機能固有のものではないため、拡張機能がアンインストールされても削除されません。

拡張機能をアンインストールする方法は次のとおりです。

  1. 拡張機能マニフェストから拡張機能インスタンスを削除するには、拡張機能のアンインストール コマンドを実行します。

    firebase ext:uninstall extensionInstanceId
  2. 次に、マニフェストへの変更を Firebase プロジェクトにデプロイするには、

    firebase deploy --only extensions --project=projectId-or-alias
    を実行します。