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

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Cloud Functions является региональным решением , что означает, что инфраструктура, на которой выполняется ваша функция, расположена в определенных регионах и управляется Google, чтобы быть избыточно доступной во всех зонах этих регионов.

При выборе регионов для запуска ваших функций, вашими основными соображениями должны быть задержка и доступность. Обычно вы можете выбирать регионы, близкие к вашим пользователям, но вы также должны учитывать местоположение других продуктов и сервисов , которые использует ваше приложение. Использование сервисов в нескольких регионах может повлиять на задержку вашего приложения, а также на цены .

По умолчанию функции запускаются в регионе us-central1 . Обратите внимание, что он может отличаться от региона источника событий, например, контейнера Cloud Storage . Узнайте, как указать регион, в котором запускается функция, далее на этой странице.

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

В списках этого раздела значок energy_savings_leaf указывает на то, что электроэнергия для этого региона производится с низкими выбросами углерода. Для получения дополнительной информации см. Carbon free energy for Google Cloud regions .

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

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

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

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

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

Лучшие практики указания региона

По умолчанию функции запускаются в регионе us-central1 . Обратите внимание, что он может отличаться от региона источника событий, например, контейнера Cloud Storage . Если вам нужно указать регион, в котором запускается функция, следуйте рекомендациям в этом разделе для каждого типа триггера функции.

Чтобы задать регион, в котором выполняется функция, задайте параметр 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

Вы можете указать несколько регионов, передав несколько строк регионов, разделенных запятыми, в region . Также обратите внимание, что при указании региона для многих типов фоновых триггеров вам нужно будет указать правильный фильтр событий вместе с регионом. В приведенном выше примере это document Cloud Firestore , который генерирует событие. Для триггера Cloud Storage фильтром событий может быть bucket ; для триггера Pub/Sub это будет topic и т. д.

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

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

Для HTTP и вызываемых функций мы рекомендуем вам сначала установить функцию в целевой регион или в ближайший к нему регион, где находится большинство ожидаемых клиентов, а затем изменить исходную функцию, чтобы перенаправить ее HTTP-запрос в новую функцию (они могут иметь одинаковое имя). Если клиенты вашей HTTP-функции поддерживают перенаправления, вы можете просто изменить исходную функцию, чтобы она возвращала статус перенаправления HTTP (301) вместе с URL-адресом вашей новой функции. Если ваши клиенты плохо справляются с перенаправлениями, вы можете проксировать запрос из исходной функции в новую функцию, инициировав новый запрос из исходной функции в новую функцию. Последний шаг — убедиться, что все клиенты вызывают новую функцию.

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

Что касается вызываемой функции, вызываемые клиентом настройки должны следовать тем же рекомендациям, что и функции HTTP. Клиент также может указать регион и должен сделать это, если функция выполняется в любом регионе, кроме us-central1 .

Чтобы задать регионы на клиенте, укажите нужный регион при инициализации:

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");

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

Фоновые функции принимают семантику доставки событий по крайней мере один раз, что означает, что при некоторых обстоятельствах они могут получать дублирующие события. Поэтому вам следует реализовать функции так, чтобы они были идемпотентными . Если ваша функция уже идемпотентна, вы можете повторно развернуть функцию в новом регионе с тем же триггером события и удалить старую функцию после того, как убедитесь, что новая функция правильно получает трафик. Во время этого перехода обе функции будут получать события. См. изменение региона функции для рекомендуемой последовательности команд для изменения регионов для функций.

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

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

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

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

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

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