Lokasi Cloud Functions

Cloud Functions bersifat regional. Artinya, infrastruktur yang menjalankan fungsi Anda terletak di region tertentu dan dikelola oleh Google agar tersedia secara redundan di semua zona dalam region tersebut.

Saat memilih region untuk menjalankan fungsi, pertimbangan utama Anda haruslah latensi dan ketersediaan. Secara umum, Anda bisa memilih region yang dekat dengan pengguna Anda. Namun, pertimbangkan juga lokasi produk dan layanan lain yang digunakan aplikasi Anda. Penggunaan layanan di beberapa region dapat memengaruhi latensi dan harga aplikasi.

Secara default, fungsi dijalankan di region us-central1. Perhatikan bahwa region ini mungkin berbeda dengan region sumber peristiwa, seperti bucket Cloud Storage. Pelajari cara menentukan region tempat fungsi dijalankan nanti di halaman ini.

Region yang didukung

Dalam daftar di bagian ini, ikon energy_savings_leaf menunjukkan bahwa listrik untuk region ini dihasilkan dengan emisi karbon yang rendah. Untuk informasi selengkapnya, lihat Energi bebas karbon untuk region Google Cloud.

Harga Paket 1

Cloud Functions tersedia di region berikut dengan harga Paket 1:

Harga Paket 2

Cloud Functions tersedia di region berikut dengan harga Paket 2:

Fungsi di region tertentu pada project tertentu harus memiliki nama unik (tidak peka huruf besar/kecil), tetapi fungsi lintas region atau lintas project dapat menggunakan nama yang sama.

Praktik terbaik untuk menentukan region

Secara default, fungsi dijalankan di region us-central1. Perhatikan bahwa region ini mungkin berbeda dengan region sumber peristiwa, seperti bucket Cloud Storage. Jika perlu menentukan region tempat fungsi dijalankan, ikuti rekomendasi di bagian ini untuk setiap jenis pemicu fungsi.

Untuk menyetel region tempat fungsi dijalankan, setel parameter region dalam definisi fungsi seperti yang ditunjukkan:

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

Anda dapat menentukan beberapa region dengan meneruskan beberapa string region yang dipisahkan koma di region. Perhatikan juga bahwa saat menentukan region untuk banyak jenis pemicu latar belakang, Anda harus menentukan filter peristiwa yang benar bersama dengan regionnya. Pada contoh di atas, ini adalah Cloud Firestore document yang memunculkan peristiwa. Untuk pemicu Cloud Storage, filter peristiwa dapat berupa bucket; untuk pemicu Pub/Sub, filternya adalah topic, dan seterusnya.

Lihat bagian mengubah region fungsi untuk mengetahui informasi selengkapnya tentang cara mengubah region untuk fungsi yang menangani traffic produksi.

Fungsi yang dapat dipanggil klien dan HTTP

Untuk fungsi callable dan HTTP, sebaiknya setel ke region tujuan terlebih dahulu, atau region yang terdekat dengan lokasi sebagian besar pelanggan yang ditarget. Selanjutnya, ubah fungsi asal untuk mengalihkan permintaan HTTP-nya ke fungsi baru (keduanya boleh menggunakan nama yang sama). Jika klien fungsi HTTP Anda mendukung pengalihan, Anda dapat mengubah fungsi asal dengan mudah untuk menampilkan status pengalihan HTTP (301) beserta URL fungsi yang baru. Jika klien tidak menangani pengalihan dengan baik, Anda dapat mem-proxy permintaan dari fungsi asal ke fungsi baru dengan menginisiasi permintaan baru dari fungsi asal ke fungsi baru. Langkah terakhir adalah memastikan bahwa semua klien memanggil fungsi baru.

Pilihan lokasi sisi klien untuk fungsi callable

Terkait fungsi callable, penyiapan fungsi callable klien harus mengikuti panduan yang sama dengan fungsi HTTP. Klien juga dapat menentukan region, dan harus melakukannya jika fungsi berjalan di region mana pun selain us-central1.

Untuk menyetel region pada klien, tentukan region yang diinginkan saat inisialisasi:

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

Fungsi latar belakang

Fungsi latar belakang mengadopsi semantik penayangan peristiwa setidaknya-sekali, yang berarti dalam keadaan tertentu, fungsi tersebut dapat menerima peristiwa duplikat. Jadi, Anda harus mengimplementasikan fungsi agar idempoten. Jika fungsi sudah idempoten, Anda dapat men-deploy ulang fungsi tersebut di region baru dengan pemicu peristiwa yang sama, dan menghapus fungsi lama setelah memverifikasi bahwa fungsi baru sudah menerima traffic dengan benar. Selama transisi ini, kedua fungsi akan menerima peristiwa. Lihat mengubah region fungsi untuk mengetahui urutan perintah yang direkomendasikan dalam mengubah region fungsi.

Jika fungsi Anda saat ini tidak idempoten, atau idempotensinya tidak melampaui region, sebaiknya terapkan idempotensi terlebih dulu sebelum memindahkan fungsi.

Rekomendasi region yang optimal berbeda-beda berdasarkan jenis pemicu peristiwa:

Memilih region berdasarkan lokasi Cloud Firestore dan Cloud Storage

Region yang tersedia untuk fungsi tidak selalu sama persis dengan region yang tersedia untuk database Cloud Firestore dan bucket Cloud Storage.

Perlu diperhatikan, jika fungsi dan resource Anda (instance database atau bucket Cloud Storage) berada di lokasi berbeda, Anda berpotensi mengalami peningkatan latensi dan biaya penagihan.

Berikut adalah pemetaan region terdekat yang didukung fungsi untuk Cloud Firestore dan Cloud Storage, untuk kasus jika region yang sama tidak didukung: