このページでは、Cloud Functions for Firebase (第 2 世代) をセットアップする手順について説明します。 Cloud Functions for Firebase をセットアップするための一般的なフローをまだよく理解していない場合は、第 1 世代の紹介とスタート ガイドを参照してください。
Blaze プランでプロジェクトを使用する
Cloud Functions for Firebase (第 2 世代) は Cloud Run で実行されるため、開始するには課金手段を提供する必要があります。 Cloud Run には、1 か月あたり 200 万リクエストの無料利用枠があります。詳細については、 Cloud Run の料金をご覧ください。
SDK をインストールする
Cloud Functions for Firebase (第 2 世代) ライブラリはnpmで利用できます。ライブラリで行われたすべての作業は、 GitHubでも公開されています。
Cloud Functions for Firebase (第 2 世代) を有効にするには、Firebase CLI で次のコマンドを実行します。
# Install the latest version of the Firebase CLI
npm install -g firebase-tools
# Initialize a project, if necessary
firebase init functions
firebase-functions
SDK をインポートする
Cloud Functions for Firebase (第 2 世代) SDK は、 v2
パッケージ エクスポートに含まれています。サブパッケージをインポートするか (推奨)、次のようにfirebase-functions/v2
でモノリスをインポートできます。
// import from a specific subpackage
const {onRequest} = require('firebase-functions/v2/https');
// import the entire v2 monolith
const functionsV2 = require('firebase-functions/v2');
第 1 世代の SDK をインポートする (オプション)
元の Cloud Functions for Firebase SDK は、第 1 世代として知られるようになりました。以前と同様に、第 1 世代の SDK を引き続きインポートできます。または、読みやすさを向上させるために、 v1
名前空間から第 1 世代の SDK をインポートすることもできます。
const functions = require('firebase-functions/v1');
// alternatively:
// const functions = require('firebase-functions');
第 1 世代 SDK で作成された関数は、Cloud Functions 第 1 世代にデプロイされます。第 2 世代への移行を容易にするために、Cloud Functions では、1 つのコードベースに第 1 世代と第 2 世代の両方の関数を含めることができます。
次のステップ
新しいタイプ、 Firebase Alerts トリガー、Firebase Extensions のカスタム イベント トリガー、タスク キュー関数など、サポートされている各トリガー タイプのガイドとサンプル コードを参照してください。次の方法に関する基本的なガイダンスも参照してください。