Cloud Functions konumları

Cloud Functions bölgeseldir. Yani işlevinizi çalıştıran altyapı belirli bölgelerde bulunur ve Google tarafından bu bölgelerdeki tüm bölgelerde yedek olarak kullanılabilir şekilde yönetilir.

İşlevlerinizin hangi bölgelerde çalışacağını seçerken öncelikle gecikme ve kullanılabilirlik faktörlerini göz önünde bulundurmanız gerekir. Genellikle kullanıcılarınıza yakın bölgeleri seçebilirsiniz ancak uygulamanızın kullandığı diğer ürün ve hizmetlerin konumunu da göz önünde bulundurmanız gerekir. Birden fazla bölgede hizmet kullanmak, uygulamanızın gecikmesini ve fiyatlandırmasını etkileyebilir.

İşlevler varsayılan olarak us-central1 bölgesinde çalışır. Bunun, Cloud Storage paketi gibi bir etkinlik kaynağının bölgesinden farklı olabileceğini unutmayın. Bir işlevin çalıştığı bölgeyi nasıl belirteceğinizi bu sayfanın ilerleyen bölümlerinde öğrenebilirsiniz.

Desteklenen bölgeler

Bu bölümdeki listelerde energy_savings_leaf simgesi, bu bölgedeki elektriğin düşük karbon emisyonuyla üretildiğini gösterir. Daha fazla bilgi için Google Cloud bölgeleri için karbonsuz enerji başlıklı makaleyi inceleyin.

1. Katman fiyatlandırması

Cloud Functions, aşağıdaki bölgelerde 1. Katman fiyatlandırması ile kullanılabilir:

2. Katman fiyatlandırması

Cloud Functions, 2. Katman fiyatlandırması ile aşağıdaki bölgelerde kullanılabilir:

Belirli bir projedeki belirli bir bölgedeki işlevlerin benzersiz (büyük/küçük harf duyarlı olmayan) adları olmalıdır ancak bölgeler veya projeler genelindeki işlevler aynı adı paylaşabilir.

Bölge belirtmeyle ilgili en iyi uygulamalar

İşlevler varsayılan olarak us-central1 bölgesinde çalışır. Bunun, Cloud Storage paketi gibi bir etkinlik kaynağının bölgesinden farklı olabileceğini unutmayın. Bir işlevin çalıştığı bölgeyi belirtmeniz gerekiyorsa her işlev tetikleyici türü için bu bölümdeki önerileri uygulayın.

Bir işlevin çalışacağı bölgeyi ayarlamak için işlev tanımında region parametresini aşağıdaki gibi ayarlayın:

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 parametresinde virgülle ayrılmış birden fazla bölge dizesi ileterek birden fazla bölge belirtebilirsiniz. Ayrıca, birçok arka plan tetikleyici türü için bir bölge belirtirken bölgeyle birlikte doğru etkinlik filtresini de belirtmeniz gerektiğini unutmayın. Yukarıdaki örnekte, etkinliği yayınlayan Cloud Firestore document bu öğedir. Cloud Storage tetikleyici için etkinlik filtresi bucket olabilir; Pub/Sub tetikleyici için topic olur ve bu şekilde devam eder.

Üretim trafiğini yöneten bir işlevin bölgesini değiştirme hakkında daha fazla bilgi için bir işlevin bölgesini değiştirme başlıklı makaleyi inceleyin.

HTTP ve istemci tarafından çağrılabilir işlevler

HTTP ve çağrılabilir işlevler için önce işlevinizi hedef bölgeye veya beklenen çoğu müşterinin bulunduğu yere en yakın bölgeye ayarlamanızı, ardından orijinal işlevinizi HTTP isteğini yeni işleve yönlendirecek şekilde değiştirmenizi öneririz (aynı ada sahip olabilirler). HTTP işlevinizin istemcileri yönlendirmeleri destekliyorsa orijinal işlevinizi, yeni işlevinizin URL'si ile birlikte bir HTTP yönlendirme durumu (301) döndürecek şekilde değiştirebilirsiniz. Müşterileriniz yönlendirmeleri iyi şekilde işlemiyorsa orijinal işlevden yeni işleve yeni bir istek başlatarak isteği orijinal işlevden yeni işleve proxy olarak gönderebilirsiniz. Son adım, tüm istemcilerin yeni işlevi çağırdığında emin olmaktır.

Çağırılabilir işlevler için istemci tarafı yer seçimi

Çağırılabilir işlevle ilgili olarak, istemci çağrılabilir ayarları HTTP işlevleriyle aynı kurallara uymalıdır. İstemci bir bölge de belirtebilir ve işlev us-central1 dışındaki bir bölgede çalışıyorsa bunu yapmalıdır.

İstemcide bölgeleri ayarlamak için başlatma sırasında istediğiniz bölgeyi belirtin:

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

Arka plan işlevleri

Arka plan işlevleri, en az bir kez etkinlik yayınlama semantiği kullanır. Bu, bazı durumlarda yinelenen etkinlikler alabileceği anlamına gelir. Bu nedenle, işlevleri tekil olacak şekilde uygulamanız gerekir. İşleviniz zaten tekil ise işlevi yeni bölgede aynı etkinlik tetikleyiciyle yeniden dağıtabilir ve yeni işlevin trafiği doğru şekilde aldığını doğruladıktan sonra eski işlevi kaldırabilirsiniz. Bu geçiş sırasında her iki işlev de etkinlik alır. İşlevlerin bölgelerini değiştirmek için önerilen komut sırası için bir işlevin bölgesini değiştirme başlıklı makaleyi inceleyin.

İşleviniz şu anda tekil değilse veya tekilliği bölgenin ötesine geçmiyorsa işlevi taşımadan önce tekilliği uygulamanızı öneririz.

Optimum bölge önerileri, etkinlik tetikleyici türüne göre farklılık gösterir:

Cloud Firestore ve Cloud Storage konumlarına göre bölgeleri seçme

İşlevler için kullanılabilen bölgeler her zaman Cloud Firestore veritabanınız ve Cloud Storage paketleriniz için kullanılabilen bölgelerle tam olarak eşleşmez.

İşleviniz ve kaynağınız (veritabanı örneği veya Cloud Storage paketi) farklı konumlardaysa gecikme ve faturalandırma maliyetlerinde artışla karşılaşabileceğinizi unutmayın.

Aynı bölgenin desteklenmediği durumlarda Cloud Firestore ve Cloud Storage için en yakın işlevlerin desteklenen bölgelerini aşağıda bulabilirsiniz: