Местоположения Cloud Functions

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

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

По умолчанию интерфейс командной строки Firebase развертывает функции в регионе, указанном в конфигурации проекта. Функции, управляемые событиями, обычно развертываются в регионе источника данных, который инициирует событие (например, база данных Cloud Firestore или сегмент Cloud Storage), а в качестве резервного варианта – в регионе us-central1.

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

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

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

Цены уровня 1

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

Цены уровня 2

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

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

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

По умолчанию интерфейс командной строки Firebase развертывает функции в регионе, указанном в конфигурации проекта. Функции, управляемые событиями, обычно развертываются в регионе источника данных, инициирующего событие (например, базы данных Cloud Firestore или сегмента Cloud Storage), а в качестве резервного варианта – в регионе us-central1.

Рекомендуем задавать конкретные регионы, а не полагаться на настройки Firebase по умолчанию, которые могут со временем измениться. При настройке регионов следуйте рекомендациям в этом разделе для каждого типа триггера.

Чтобы задать регион, в котором выполняется функция, установите параметр 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. Также обратите внимание, что при указании региона для многих типов фоновых триггеров вам нужно будет указать правильный фильтр событий вместе с регионом. В примере выше это Cloud Firestore document, который генерирует событие. Для триггера Cloud Storage фильтр событий может быть bucket, для триггера издатель-подписчик – topic и т. д.

Подробнее о том, как изменить регион для функции, обрабатывающей рабочий трафик…

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

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

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

Вызываемые функции на стороне клиента должны соответствовать тем же рекомендациям, что и функции HTTP. Клиент также может указать регион. Это необходимо сделать, если функция выполняется в регионе, отличном от региона по умолчанию для проекта.

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

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, в случаях, когда один и тот же регион не поддерживается: