Cloud Functions のロケーション

Cloud Functions はリージョナルです。つまり、Cloud Function を実行するインフラストラクチャは特定のリージョンに配置され、そのリージョン内のすべてのゾーンで冗長的に利用できるように Google によって管理されます。

関数を実行するリージョンを選択するときは、レイテンシと可用性を第一に考慮してください。一般的には、ユーザーに近いリージョンを選択しますが、アプリで使用されている他のプロダクトやサービスのロケーションも考慮する必要があります。使用するサービスが複数のリージョンにまたがっていると、アプリのレイテンシだけでなく、料金にも影響します。

Cloud Functions は、次のリージョンで利用できます。

• us-central1（アイオワ）
• us-east1（サウスカロライナ）
• europe-west1（ベルギー）
• europe-west2（ロンドン）
• asia-east2（香港）
• asia-northeast1（東京）

特定のプロジェクトの特定のリージョンで使用する関数には一意の名前を付ける必要があります（大文字小文字は区別されません）。リージョンまたはプロジェクトが異なる場合、関数には同じ名前を使用できます。

リージョン変更のおすすめの方法

デフォルトでは、関数は us-central1 リージョンで実行されます。これは、ストレージ バケットなどのイベントソースのリージョンとは異なる場合があるので注意してください。関数の実行リージョンを変更する場合は、このセクションの推奨事項に従ってください。

関数の実行リージョンを設定するには、次に示すように、関数定義で region パラメータを設定します。

exports.myStorageFunction = functions
    .region('europe-west1')
    .storage
    .object()
    .onFinalize((object) => {
      // ...
    });

functions.region() でカンマ区切りの複数のリージョン文字列を渡すことで、複数のリージョンを指定できます。推奨手順の詳細については、関数のリージョンを変更するをご覧ください。

HTTP とクライアント呼び出し可能関数

HTTP と呼び出し可能関数に関しては、最初に関数を目的のリージョンまたは最も多くの見込み顧客がいる場所に一番近いリージョンに設定してから、HTTP リクエストを新しい関数にリダイレクトするように元の関数を変更することをおすすめします（元の関数と新しい関数は同じ名前にできます）。HTTP ファンクションのクライアントがリダイレクトをサポートしている場合は、HTTP リダイレクト ステータス（301）と新しいファンクションの URL を返すように元のファンクションを変更します。リダイレクトにうまく対応できないクライアントの場合は、元のファンクションから新しいファンクションへリクエストをプロキシするという方法があります。これを行うには、元のファンクションから新しいファンクションに対して新しいリクエストを開始します。最終的には、すべてのクライアントが新しい関数を呼び出すようにします。

クライアント側での呼び出し可能関数のロケーション選択

呼び出し可能ファンクションについては、HTTP ファンクションと同じガイドラインに従って、クライアント側の呼び出し可能ファンクションの設定を行う必要があります。クライアント側でもリージョンを指定できます。us-central1 以外のリージョンで関数を実行する場合は、リージョンを指定する必要があります。

クライアント側でリージョンを設定するには、初期化時に目的のリージョンを指定します。

lazy var functions = Functions.functions(region:"us-central1")

@property(strong, nonatomic) FIRFunctions *functions;
// ...
self.functions = [FIRFunctions functionsWithRegion:@"us-central1"];

var functions = firebase.app().functions('us-central1');

private FirebaseFunctions mFunctions;
// ...
mFunctions = FirebaseFunctions.getInstance("us-central1");

firebase::functions::Functions* functions;
// ...
functions = firebase::functions::Functions::GetInstance("us-central1");

firebase.Functions.FirebaseFunctions functions;

functions = Firebase.Functions.FirebaseFunctions.GetInstance("us-central1");

バックグラウンド関数

バックグラウンド関数では、at-least-once（少なくとも 1 回）のイベント配信セマンティックを採用しています。つまり、状況によってはイベントを重複して受け取る可能性があります。そのため、関数の実装は必ずべき等にする必要があります。関数がすでにべき等になっている場合は、同じイベント トリガーを使用して新しいリージョンに関数を再デプロイし、新しい関数がトラフィックを正しく受け取っていることを確認してから古い関数を削除します。この移行中は、どちらの関数もイベントを受信します。関数のリージョンを変更するための推奨のコマンド シーケンスについては、関数のリージョンを変更するをご覧ください。

ファンクションが正しくべき等になっていない場合や、べき等性がリージョンを超えて拡張できない場合は、最初にべき等性を実装してからファンクションを移動してください。

最適なリージョンに関する推奨事項は、イベント トリガーの種類によって異なります。

Firestore と Storage のリージョンの選択

関数のリージョンは、Firebase プロジェクトで利用可能なリージョンと正確には一致しません。Firebase プロジェクトの作成中にリージョンを指定すると、Firestore インスタンスはそのリージョン内に作成されます。また、そのリージョンは Cloud Storage バケットのデフォルトのリージョンにもなります。Firestore と Storage でトリガーされる関数に最も近い関数リージョンのマッピングを次に示します。