Lokalizacje Cloud Functions

Cloud Functions jest regionalna, co oznacza, że infrastruktura, która uruchamia Twoją funkcję, znajduje się w określonych regionach i jest zarządzana przez Google w taki sposób, aby była nadmiarowo dostępna we wszystkich strefach w tych regionach.

Wybierając regiony, w których mają być uruchamiane funkcje, należy przede wszystkim wziąć pod uwagę opóźnienie i dostępność. Zazwyczaj możesz wybrać regiony znajdujące się blisko Twoich użytkowników, ale musisz też wziąć pod uwagę lokalizację innych produktów i usług, z których korzysta Twoja aplikacja. Korzystanie z usług w wielu regionach może wpłynąć na opóźnienie aplikacji, a także na ceny.

Domyślnie funkcje działają w regionie us-central1. Pamiętaj, że może to być inny region niż region źródła zdarzeń, np. zasobnika Cloud Storage. Dowiedz się, jak określić region, w którym ma działać funkcja, w dalszej części tej strony.

Obsługiwane regiony

Na listach w tej sekcji ikona energy_savings_leaf oznacza, że energia elektryczna w tym regionie jest wytwarzana przy niskiej emisji dwutlenku węgla. Więcej informacji znajdziesz w artykule Energia bezemisyjna w regionach Google Cloud.

Ceny na poziomie 1

Cloud Functions jest dostępny w tych regionach w cenach na poziomie 1:

Cennik poziomu 2

Cloud Functions jest dostępny w tych regionach w cenie na poziomie 2:

Funkcje w danym regionie w danym projekcie muszą mieć unikalne nazwy (bez rozróżniania wielkości liter), ale funkcje w różnych regionach lub w różnych projektach mogą mieć tę samą nazwę.

Sprawdzone metody określania regionu

Domyślnie funkcje działają w regionie us-central1. Pamiętaj, że może to być inny region niż region źródła zdarzeń, np. zasobnika Cloud Storage. Jeśli musisz określić region, w którym ma działać funkcja, postępuj zgodnie z zaleceniami w tej sekcji dla każdego typu wyzwalacza funkcji.

Aby ustawić region, w którym ma działać funkcja, ustaw parametr region w definicji funkcji, jak pokazano poniżej:

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

Możesz określić wiele regionów, przekazując w parametrze region kilka ciągów znaków regionu oddzielonych przecinkami. Pamiętaj też, że w przypadku wielu typów reguł w tle musisz podać nie tylko region, ale też odpowiedni filtr zdarzeń. W przykładzie powyżej jest to Cloud Firestore document, które emituje zdarzenie. W przypadku aktywatora Cloud Storage filtr zdarzeń może mieć postać bucket, w przypadku aktywatora Pub/Sub – topic itd.

Więcej informacji o zmianie regionu funkcji obsługującej ruch produkcyjny znajdziesz w artykule Zmiana regionu funkcji.

Funkcje HTTP i funkcje wywoływane przez klienta

W przypadku funkcji HTTP i funkcji wywoływanych zalecamy najpierw ustawić funkcję w regionie docelowym lub w regionie najbliższym lokalizacji większości oczekiwanych klientów, a następnie zmienić pierwotną funkcję, aby przekierowywała żądanie HTTP do nowej funkcji (mogą mieć tę samą nazwę). Jeśli klienci Twojej funkcji HTTP obsługują przekierowania, możesz po prostu zmienić pierwotną funkcję tak, aby zwracała stan przekierowania HTTP (301) wraz z adresem URL nowej funkcji. Jeśli Twoi klienci nie radzą sobie dobrze z przekierowaniami, możesz przekierować żądanie z pierwotnej funkcji do nowej, inicjując nowe żądanie z pierwotnej funkcji do nowej. Ostatnim krokiem jest upewnienie się, że wszystkie aplikacje klienckie wywołują nową funkcję.

Wybór lokalizacji po stronie klienta w przypadku funkcji wywoływanych

W przypadku funkcji wywoływalnej konfiguracje wywoływane przez klienta powinny być zgodne z tymi samymi wytycznymi co funkcje HTTP. Klient może też określić region i musi to zrobić, jeśli funkcja jest uruchamiana w regionie innym niż us-central1.

Aby ustawić regiony na kliencie, określ żądany region podczas inicjowania:

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

Funkcje w tle

Funkcje w tle korzystają z semantyki dostarczania zdarzeń co najmniej raz, co oznacza, że w pewnych okolicznościach mogą otrzymywać zduplikowane zdarzenia. Dlatego warto zaimplementować funkcje, które są idempotentne. Jeśli funkcja jest już idempotentna, możesz ponownie wdrożyć ją w nowym regionie z tym samym wyzwalaczem zdarzeń i usunąć starą funkcję po sprawdzeniu, czy nowa funkcja prawidłowo odbiera ruch. Podczas tego przejścia obie funkcje będą otrzymywać zdarzenia. Aby poznać zalecaną kolejność poleceń do zmiany regionów funkcji, zobacz zmiana regionu funkcji.

Jeśli Twoja funkcja nie jest obecnie idempotentna lub jej idempotentność nie wykracza poza region, zalecamy najpierw wdrożenie idempotentności, a dopiero potem przeniesienie funkcji.

Zalecenia dotyczące optymalnego regionu różnią się w zależności od typu aktywatora zdarzenia:

Wybieranie regionów na podstawie lokalizacji Cloud Firestore i Cloud Storage

Dostępne regiony funkcji nie zawsze dokładnie odpowiadają regionom dostępnym dla Cloud Firestore bazy danych i Cloud Storage zasobników.

Pamiętaj, że jeśli Twoja funkcja i zasób (instancja bazy danych lub Cloud Storagezasobnik) znajdują się w różnych lokalizacjach, czas oczekiwania i koszty mogą być większe.

Oto mapowanie najbliższych regionów obsługujących funkcje Cloud Firestore i Cloud Storage w przypadku, gdy ten sam region nie jest obsługiwany: