İpuçları ve püf noktaları

Bu belgede, Cloud Functions'ü tasarlama, uygulama, test etme ve dağıtmayla ilgili en iyi uygulamalar açıklanmaktadır.

Doğruluk

Bu bölümde, Cloud Functions'ü tasarlama ve uygulamayla ilgili genel en iyi uygulamalar açıklanmaktadır.

Tekil fonksiyonlar yazma

İşlevleriniz birden çok kez çağrılsa bile aynı sonucu vermelidir. Bu sayede, önceki çağrı kodunuzun ortasında başarısız olursa çağrıyı yeniden deneyebilirsiniz. Daha fazla bilgi için etkinlik odaklı işlevleri yeniden deneme konusuna bakın.

Arka planda işlem başlatmayın

Arka plan etkinliği, işleviniz sona erdikten sonra gerçekleşen her şeydir. İşlev çağırma işlemi, işlev döndürdüğünde veya başka bir şekilde tamamlandığını belirttiğinde (ör. Node.js etkinlik odaklı işlevlerinde callback bağımsız değişkeni çağrıldığında) sona erer. Sorunsuz sonlandırmadan sonra çalıştırılan kodlar CPU'ya erişemez ve herhangi bir ilerleme kaydedemez.

Ayrıca, aynı ortamda sonraki bir çağrı yürütüldüğünde arka plan etkinliğiniz devam ederek yeni çağrıyı engeller. Bu durum, beklenmedik davranışlara ve teşhis edilmesi zor hatalara neden olabilir. Bir işlev sona erdikten sonra ağa erişmek genellikle bağlantıların sıfırlanmasına neden olur (ECONNRESET hata kodu).

Arka plan etkinliği, genellikle bağımsız çağrıların günlüklerinde, çağrının sona erdiğini belirten satırdan sonra günlüğe kaydedilen her şey bulunarak tespit edilebilir. Arka plan etkinliği, özellikle geri çağırma veya zamanlayıcı gibi eşzamansız işlemler mevcut olduğunda bazen kodun daha derinlerine gömülebilir. İşlevi sonlandırmadan önce tüm zaman uyumsuz işlemlerin tamamlandığından emin olmak için kodunuzu inceleyin.

Geçici dosyaları her zaman sil

Geçici dizindeki yerel disk depolama alanı, bellek içi bir dosya sistemidir. Yazdığınız dosyalar, işlevinizin kullanabileceği belleği tüketir ve bazen çağrılar arasında kalır. Bu dosyaları açıkça silmemek, zaman içinde bellek yetersizliği hatasına ve ardından soğuk başlatmaya neden olabilir.

Google Cloud Console'daki işlev listesinden işlevi seçip Bellek kullanımı grafiğini belirleyerek tek bir işlevin kullandığı belleği görebilirsiniz.

Geçici dizinin dışına yazmaya çalışmayın ve dosya yollarını oluşturmak için platform/OS'den bağımsız yöntemler kullandığınızdan emin olun.

Ardışık düzen kullanarak daha büyük dosyaları işlerken bellek gereksinimlerini azaltabilirsiniz. Örneğin, bir okuma akışı oluşturarak, bu akışı akış tabanlı bir işleme geçirerek ve çıkış akışını doğrudan Cloud Storage'a yazarak Cloud Storage'da bir dosyayı işleyebilirsiniz.

Functions Framework

Bir işlevi dağıttığınızda Functions Framework, mevcut sürümü kullanılarak otomatik olarak bağımlılık olarak eklenir. Aynı bağımlıların farklı ortamlarda tutarlı bir şekilde yüklenmesini sağlamak için işlevinizi Functions Framework'in belirli bir sürümüne sabitlemenizi öneririz.

Bunu yapmak için tercih ettiğiniz sürümü ilgili kilit dosyasına ekleyin (örneğin, Node.js için package-lock.json veya Python için requirements.txt).

Araçlar

Bu bölümde, Cloud Functions'ü uygulamak, test etmek ve bu araçla etkileşime geçmek için araçları kullanmayla ilgili yönergeler sağlanmaktadır.

Yerel geliştirme

İşlev dağıtımı biraz zaman aldığından işlevinizin kodunu yerel olarak test etmek genellikle daha hızlıdır.

E-posta göndermek için SendGrid'i kullanma

Cloud Functions, 25 numaralı bağlantı noktasında giden bağlantılara izin vermez. Bu nedenle, SMTP sunucusuyla güvenli olmayan bağlantılar kuramazsınız. E-posta göndermek için SendGrid'i kullanmanız önerilir. E-posta göndermeyle ilgili diğer seçenekleri Google Compute Engine'e yönelik Bir Birimden E-posta Gönderme eğitiminde bulabilirsiniz.

Performans

Bu bölümde, performansı optimize etmeye yönelik en iyi uygulamalar açıklanmaktadır.

Bağımlılıkları akıllıca kullanın

İşlevler durum bilgisi içermediğinden yürütme ortamı genellikle sıfırdan başlatılır (soğuk başlatma olarak bilinen işlem sırasında). Sıfırdan başlatma işlemi gerçekleştiğinde işlevin genel bağlamı değerlendirilir.

İşlevleriniz modül içe aktarıyorsa bu modüllerin yükleme süresi, sıfırdan başlatma sırasındaki çağrı gecikmesine eklenebilir. Bağımlılıkları doğru şekilde yükleyerek ve işlevinizin kullanmadığı bağımlılıkları yüklemeyerek bu gecikmeyi ve işlevinizi dağıtmak için gereken süreyi azaltabilirsiniz.

Nesneleri gelecekteki çağrılarda yeniden kullanmak için genel değişkenleri kullanma

Bir işlevin durumunun gelecekteki çağrılar için korunacağı garanti edilmez. Ancak Cloud Functions genellikle önceki bir çağrının yürütme ortamını geri dönüştürür. Bir değişkeni global kapsamda tanımlarsanız değeri, yeniden hesaplanmadan sonraki çağrılarda yeniden kullanılabilir.

Bu sayede, her işlev çağrısında yeniden oluşturulması pahalı olabilecek nesneleri önbelleğe alabilirsiniz. Bu tür nesneleri işlev gövdesinden genel kapsama taşımak önemli performans iyileştirmelerine neden olabilir. Aşağıdaki örnekte, ağır bir nesne yalnızca işlev örneği başına bir kez oluşturulur ve belirli bir örneğe ulaşan tüm işlev çağrılarında paylaşılır:

console.log('Global scope');
const perInstance = heavyComputation();
const functions = require('firebase-functions');

exports.function = functions.https.onRequest((req, res) => {
  console.log('Function invocation');
  const perFunction = lightweightComputation();

  res.send(`Per instance: ${perInstance}, per function: ${perFunction}`);
});

import time

from firebase_functions import https_fn

# Placeholder
def heavy_computation():
  return time.time()

# Placeholder
def light_computation():
  return time.time()

# Global (instance-wide) scope
# This computation runs at instance cold-start
instance_var = heavy_computation()

@https_fn.on_request()
def scope_demo(request):

  # Per-function scope
  # This computation runs every time this function is called
  function_var = light_computation()
  return https_fn.Response(f"Instance: {instance_var}; function: {function_var}")
  

Ağ bağlantılarını, kitaplık referanslarını ve API istemci nesnelerini genel kapsamda önbelleğe almak özellikle önemlidir. Örnekler için Ağ bağlantısını optimize etme başlıklı makaleyi inceleyin.

Genel değişkenleri yavaş başlatma

Değişkenleri global kapsamda başlatırsanız başlatma kodu her zaman soğuk başlatma çağrısı aracılığıyla yürütülür ve işlevinizin gecikmesi artar. Bu durum, try/catch bloğunda uygun şekilde işlenmeyen çağrılan hizmetlerde aralıklı zaman aşımlarına neden olabilir. Bazı nesneler tüm kod yollarında kullanılmıyorsa bunları isteğe bağlı olarak yavaşça başlatmayı düşünebilirsiniz:

const functions = require('firebase-functions');
let myCostlyVariable;

exports.function = functions.https.onRequest((req, res) => {
  doUsualWork();
  if(unlikelyCondition()){
      myCostlyVariable = myCostlyVariable || buildCostlyVariable();
  }
  res.status(200).send('OK');
});

from firebase_functions import https_fn

# Always initialized (at cold-start)
non_lazy_global = file_wide_computation()

# Declared at cold-start, but only initialized if/when the function executes
lazy_global = None

@https_fn.on_request()
def lazy_globals(request):

  global lazy_global, non_lazy_global

  # This value is initialized only if (and when) the function is called
  if not lazy_global:
      lazy_global = function_specific_computation()

  return https_fn.Response(f"Lazy: {lazy_global}, non-lazy: {non_lazy_global}.")
  

Bu, özellikle tek bir dosyada birden fazla işlev tanımlarsanız ve farklı işlevler farklı değişkenler kullanıyorsa önemlidir. Tembel başlatma özelliğini kullanmazsanız, başlatılan ancak hiç kullanılmayan değişkenler için kaynak israf edebilirsiniz.

Minimum örnek sayısı belirleyerek baştan başlatma işlemlerini azaltma

Varsayılan olarak Cloud Functions, örnek sayısını gelen isteklerin sayısına göre ölçeklendirir. Cloud Functions'nin istek sunmak için hazır tutması gereken minimum örnek sayısını ayarlayarak bu varsayılan davranışı değiştirebilirsiniz. Minimum örnek sayısı ayarlamak, uygulamanızın baştan başlatılma sayısını azaltır. Uygulamanız gecikmeye duyarlıysa minimum sayıda örnek belirlemenizi öneririz.

Ek kaynaklar

Performansı optimize etme hakkında daha fazla bilgi edinmek için "Google Cloud Performans Atlası" videosundaki Cloud Functions Soğuk Başlatma Süresi bölümünü inceleyin.