Местоположение облачных функций

Cloud Functions is regional , which means the infrastructure that runs your function is located in specific regions and is managed by Google to be redundantly available across all the zones within those regions.

When selecting what regions to run your functions in, your primary considerations should be latency and availability. You can generally select regions close to your users, but you should also consider the location of the other products and services that your app uses. Using services across multiple regions can affect your app's latency, as well as pricing .

By default, the Firebase CLI deploys functions to a region based on your project's configuration. For event-driven functions, it typically deploys to a region in the triggering data source's region (like a Cloud Firestore database or Cloud Storage bucket), and as a fallback deploys to us-central1 .

После развертывания вы можете проверить регион в консоли Firebase или выполнив команду firebase functions:list . Если вы хотите, чтобы ваша функция работала в другом регионе, вы можете изменить его регион .

Поддерживаемые регионы

In the lists in this section, the energy_savings_leaf icon indicates that the electricity for this region is produced with low carbon emissions. For more information, see Carbon free energy for Google Cloud regions .

Ценообразование первого уровня

Cloud Functions доступен в следующих регионах по тарифам уровня 1 :

Ценообразование второго уровня

Cloud Functions доступен в следующих регионах по тарифам уровня 2 :

Функции в рамках одного региона и одного проекта должны иметь уникальные (регистронечувствительные) имена, однако функции в разных регионах или проектах могут иметь одно и то же имя.

Рекомендации по указанию региона

By default, the Firebase CLI deploys functions to a region based on your project's configuration. For event-driven functions, it typically deploys to a region in the triggering data source's region (like a Cloud Firestore database or Cloud Storage bucket), and as a fallback deploys to us-central1 .

You are encouraged to set specific regions instead of relying on Firebase defaults, which might change over time. When setting regions, follow the recommendations in this section for each trigger type

Чтобы задать область выполнения функции, укажите параметр region в определении функции, как показано ниже:

exports.firestoreAsia = onDocumentCreated(
  {
    document: "my-collection/{docId}",
    region: "asia-northeast1",
  },
  (event) => {},
);

# Before
@firestore_fn.on_document_created("my-collection/{docId}")
def firestore_trigger(event):
    pass

# After
@firestore_fn.on_document_created("my-collection/{docId}",
                                  region="asia-northeast1")
def firestore_trigger_asia(event):
    pass

You can specify multiple regions by passing multiple comma-separated region strings in region . Also note that, when specifying a region for many background trigger types, you'll need to specify the correct event filter along with the region. In the example above, this is the Cloud Firestore document that emits the event. For a Cloud Storage trigger the event filter could be bucket ; for a Pub/Sub trigger it would be topic , and so on.

Дополнительную информацию об изменении региона для функции, обрабатывающей производственный трафик, см. в разделе «Изменение региона функции».

HTTP-функции и функции, вызываемые клиентом

For HTTP and callable functions, we recommend that you first set your function to the destination region, or closest to where most expected customers are located, and then alter your original function to redirect its HTTP request to the new function (they can have the same name). If clients of your HTTP function support redirects, you can simply change your original function to return an HTTP redirect status (301) along with the URL of your new function. If your clients do not handle redirects well, you can proxy the request from the original function to the new function by initiating a new request from the original function to the new function. The final step is to ensure that all clients are calling the new function.

Выбор местоположения вызываемых функций на стороне клиента

Regarding the callable function, client callable setups should follow the same guidelines as HTTP functions. The client can also specify a region, and should do so if the function runs in a region other than the project's default.

Для задания регионов на стороне клиента укажите желаемый регион при инициализации:

lazy var functions = Functions.functions(region:"europe-west1")

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

var functions = firebase.app().functions('europe-west1');

private FirebaseFunctions mFunctions;
// ...
mFunctions = FirebaseFunctions.getInstance("europe-west1");

firebase::functions::Functions* functions;
// ...
functions = firebase::functions::Functions::GetInstance("europe-west1");

firebase.Functions.FirebaseFunctions functions;

functions = Firebase.Functions.FirebaseFunctions.GetInstance("europe-west1");

Фоновые функции

Background functions adopt an at-least-once event delivery semantic, which means that under some circumstances they may receive duplicate events. So, you should implement functions to be idempotent . If your function is already idempotent, then you can redeploy the function in the new region with the same event trigger and remove the old function after you verify that the new function is correctly receiving traffic. During this transition, both functions will receive events. See change a function's region for the recommended sequence of commands to change regions for functions.

Если ваша функция в данный момент не является идемпотентной или её идемпотентность не распространяется за пределы указанного региона, мы рекомендуем сначала реализовать идемпотентность, прежде чем перемещать функцию.

Рекомендации по оптимальному региону различаются в зависимости от типа триггера события:

Выбор регионов на основе расположения Cloud Firestore и Cloud Storage

Доступные регионы для функций не всегда точно совпадают с регионами, доступными для вашей базы данных Cloud Firestore и ваших сегментов Cloud Storage .

Обратите внимание, что если ваша функция и ваш ресурс (экземпляр базы данных или хранилище Cloud Storage ) находятся в разных местах, то вы можете столкнуться с увеличением задержки и затрат на оплату .

Ниже приведено сопоставление ближайших регионов, поддерживающих функции Cloud Firestore и Cloud Storage , на случай, если тот же регион не поддерживается: