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

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

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

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

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

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

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

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

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

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