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

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

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

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

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

В списках этого раздела значок energy_savings_leaf указывает на то, что электроэнергия для этого региона производится с низким уровнем выбросов углерода. Подробнее см. в разделе «Энергия без выбросов углерода для регионов Google Cloud» .

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

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

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

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