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

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

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

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

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

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

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