Cloud Functions เป็นแพลตฟอร์มระดับภูมิภาค ซึ่งหมายความว่าโครงสร้างพื้นฐานที่เรียกใช้ฟังก์ชันของคุณจะอยู่ในภูมิภาคที่เฉพาะเจาะจงและได้รับการจัดการโดย Google เพื่อให้พร้อมใช้งานแบบซ้ำซ้อนในทุกโซนภายในภูมิภาคเหล่านั้น
เมื่อเลือกภูมิภาคที่จะเรียกใช้ฟังก์ชัน ข้อควรพิจารณาหลักคือเวลาในการตอบสนองและความพร้อมใช้งาน โดยทั่วไป คุณจะเลือกภูมิภาคที่ใกล้กับผู้ใช้ได้ แต่ก็ควรพิจารณาตำแหน่งของผลิตภัณฑ์และบริการอื่นๆ ที่แอปใช้ด้วย การใช้บริการในหลายภูมิภาคอาจส่งผลต่อเวลาในการตอบสนองของแอปและราคา
โดยค่าเริ่มต้น ฟังก์ชันจะทํางานในภูมิภาค us-central1
โปรดทราบว่าข้อมูลนี้อาจแตกต่างจากภูมิภาคของแหล่งที่มาของเหตุการณ์ เช่น ที่เก็บข้อมูล Cloud Storage
ดูวิธีระบุภูมิภาคที่ฟังก์ชันทำงานภายหลังในหน้านี้
ภูมิภาคที่รองรับ
ในรายการในส่วนนี้ ไอคอน energy_savings_leaf บ่งบอกว่าไฟฟ้าสำหรับภูมิภาคนี้ผลิตขึ้นโดยมีการปล่อยก๊าซคาร์บอนต่ำ ดูข้อมูลเพิ่มเติมได้ที่พลังงานแบบปลอดคาร์บอนสําหรับภูมิภาค Google Cloud
การกำหนดราคาระดับ 1
Cloud Functions พร้อมให้บริการในภูมิภาคต่อไปนี้ที่มีราคาระดับ 1
ภูมิภาค | ตำแหน่ง | เวอร์ชันผลิตภัณฑ์ที่รองรับ | การปล่อย CO2 |
---|---|---|---|
asia-east1 |
ไต้หวัน | รุ่นที่ 1, รุ่นที่ 2 | |
asia-east2 |
ฮ่องกง | รุ่นที่ 1 เท่านั้น | |
asia-northeast1 |
โตเกียว | รุ่นที่ 1, รุ่นที่ 2 | |
asia-northeast2 |
โอซาก้า | รุ่นที่ 1, รุ่นที่ 2 | |
europe-north1 |
ฟินแลนด์ | รุ่นที่ 2 เท่านั้น | energy_savings_leaf |
europe-southwest1 |
มาดริด | รุ่นที่ 2 เท่านั้น | |
europe-west1 |
เบลเยียม | รุ่นที่ 1, รุ่นที่ 2 | energy_savings_leaf |
europe-west4 |
เนเธอร์แลนด์ | รุ่นที่ 2 เท่านั้น | |
europe-west8 |
มิลาน | รุ่นที่ 2 เท่านั้น | |
europe-west9 |
ปารีส | รุ่นที่ 2 เท่านั้น | energy_savings_leaf |
me-west1 |
เทลอาวีฟ | รุ่นที่ 2 เท่านั้น | |
europe-west2 |
ลอนดอน | รุ่นที่ 1 เท่านั้น | |
us-central1 |
ไอโอวา | รุ่นที่ 1, รุ่นที่ 2 | energy_savings_leaf |
us-east1 |
เซาท์แคโรไลนา | รุ่นที่ 1, รุ่นที่ 2 | |
us-east4 |
เวอร์จิเนียตอนเหนือ | รุ่นที่ 1, รุ่นที่ 2 | |
us-east5 |
โคลัมบัส | รุ่นที่ 2 เท่านั้น | |
us-south1 |
แดลลัส | รุ่นที่ 2 เท่านั้น | |
us-west1 |
ออริกอน | รุ่นที่ 1, รุ่นที่ 2 | energy_savings_leaf |
การกำหนดราคาระดับ 2
Cloud Functions พร้อมให้บริการในภูมิภาคต่อไปนี้ด้วยราคาระดับ 2
ภูมิภาค | ตำแหน่ง | เวอร์ชันผลิตภัณฑ์ที่รองรับ | การปล่อย CO2 |
---|---|---|---|
asia-east2 |
ฮ่องกง | รุ่นที่ 2 เท่านั้น | |
asia-northeast3 |
โซล | รุ่นที่ 1, รุ่นที่ 2 | |
asia-southeast1 |
สิงคโปร์ | รุ่นที่ 1, รุ่นที่ 2 | |
asia-southeast2 |
จาการ์ตา | รุ่นที่ 1, รุ่นที่ 2 | |
asia-south1 |
มุมไบ | รุ่นที่ 2 เท่านั้น | |
asia-south2 |
เดลี อินเดีย | รุ่นที่ 2 เท่านั้น | |
australia-southeast1 |
ซิดนีย์ | รุ่นที่ 1, รุ่นที่ 2 | |
australia-southeast2 |
เมลเบิร์น | รุ่นที่ 2 เท่านั้น | |
europe-central2 |
วอร์ซอ | รุ่นที่ 1, รุ่นที่ 2 | |
europe-west2 |
ลอนดอน | รุ่นที่ 2 เท่านั้น | |
europe-west3 |
แฟรงค์เฟิร์ต | รุ่นที่ 1, รุ่นที่ 2 | energy_savings_leaf |
europe-west6 |
ซือริช | รุ่นที่ 1, รุ่นที่ 2 | energy_savings_leaf |
europe-west10 |
เบอร์ลิน | รุ่นที่ 2 เท่านั้น | |
europe-west12 |
ตูริน | รุ่นที่ 2 เท่านั้น | |
me-central1 |
โดฮา | รุ่นที่ 2 เท่านั้น | |
me-central2 |
ดัมมาม | รุ่นที่ 2 เท่านั้น | |
northamerica-northeast1 |
มอนทรีออล | รุ่นที่ 1, รุ่นที่ 2 | energy_savings_leaf |
northamerica-northeast2 |
โทรอนโต | รุ่นที่ 2 เท่านั้น | energy_savings_leaf |
southamerica-east1 |
เซา เปาโล | รุ่นที่ 1, รุ่นที่ 2 | energy_savings_leaf |
southamerica-west1 |
ซันติอาโก ชิลี | รุ่นที่ 2 เท่านั้น | |
us-west2 |
ลอสแอนเจลิส | รุ่นที่ 1, รุ่นที่ 2 | |
us-west3 |
ซอลต์เลกซิตี | รุ่นที่ 1, รุ่นที่ 2 | |
us-west4 |
ลาสเวกัส | รุ่นที่ 1, รุ่นที่ 2 |
ฟังก์ชันในภูมิภาคที่กำหนดในโปรเจ็กต์ที่กำหนดต้องมีชื่อที่ไม่ซ้ำกัน (ไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่) แต่ฟังก์ชันข้ามภูมิภาคหรือในโปรเจ็กต์ต่างๆ อาจใช้ชื่อเดียวกัน
แนวทางปฏิบัติที่ดีที่สุดในการระบุภูมิภาค
โดยค่าเริ่มต้น ฟังก์ชันจะทํางานในภูมิภาค us-central1
โปรดทราบว่าข้อมูลนี้อาจแตกต่างจากภูมิภาคของแหล่งที่มาของเหตุการณ์ เช่น ที่เก็บข้อมูล Cloud Storage หากต้องระบุภูมิภาคที่ฟังก์ชันทำงาน ให้ทำตามคำแนะนำในส่วนนี้สำหรับทริกเกอร์ฟังก์ชันแต่ละประเภท
หากต้องการตั้งค่าภูมิภาคที่ฟังก์ชันทำงาน ให้ตั้งค่าพารามิเตอร์ region
ในคำจำกัดความของฟังก์ชันดังที่แสดงดังนี้
Node.js
exports.firestoreAsia = onDocumentCreated(
{
document: "my-collection/{docId}",
region: "asia-northeast1",
},
(event) => {},
);
Python
# 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
นอกจากนี้ โปรดทราบว่าเมื่อระบุภูมิภาคสําหรับทริกเกอร์ประเภทเบื้องหลังหลายประเภท คุณจะต้องระบุตัวกรองเหตุการณ์ที่ถูกต้องพร้อมกับภูมิภาค ในตัวอย่างข้างต้น Cloud Firestore document
คือรายการที่ส่งเหตุการณ์ สําหรับทริกเกอร์ Cloud Storage ตัวกรองเหตุการณ์อาจเป็น bucket
สําหรับทริกเกอร์ Pub/Sub จะเป็น topic
เป็นต้น
ดูข้อมูลเพิ่มเติมเกี่ยวกับการเปลี่ยนภูมิภาคของฟังก์ชันที่จัดการการเข้าชมเวอร์ชันที่ใช้งานจริงได้ที่หัวข้อเปลี่ยนภูมิภาคของฟังก์ชัน
ฟังก์ชัน HTTP และไคลเอ็นต์ที่เรียกใช้ได้
สำหรับฟังก์ชัน HTTP และฟังก์ชันที่เรียกใช้ได้ เราขอแนะนำให้คุณตั้งค่าฟังก์ชันเป็นภูมิภาคปลายทาง หรือใกล้กับตำแหน่งที่ลูกค้าที่คาดไว้มากที่สุดก่อน จากนั้นเปลี่ยนฟังก์ชันเดิมเพื่อเปลี่ยนเส้นทางคำขอ HTTP ไปยังฟังก์ชันใหม่ (อาจมีชื่อเดียวกัน) หากไคลเอ็นต์ของฟังก์ชัน HTTP รองรับการเปลี่ยนเส้นทาง คุณก็เปลี่ยนฟังก์ชันเดิมให้แสดงสถานะการเปลี่ยนเส้นทาง HTTP (301) พร้อมกับ URL ของฟังก์ชันใหม่ได้ หากลูกค้าของคุณจัดการการเปลี่ยนเส้นทางได้ไม่ดีนัก คุณสามารถพร็อกซีคำขอจากฟังก์ชันเดิมไปยังฟังก์ชันใหม่ด้วยการเริ่มต้นคำขอใหม่จากฟังก์ชันเดิมไปยังฟังก์ชันใหม่ ขั้นตอนสุดท้ายคือตรวจสอบว่าไคลเอ็นต์ทั้งหมดเรียกใช้ฟังก์ชันใหม่
การเลือกตำแหน่งฝั่งไคลเอ็นต์สำหรับฟังก์ชันที่เรียกใช้ได้
สำหรับฟังก์ชันที่เรียกใช้ได้ การตั้งค่าที่เรียกใช้ได้ของไคลเอ็นต์ควรเป็นไปตามหลักเกณฑ์เดียวกันกับฟังก์ชัน HTTP นอกจากนี้ ลูกค้ายังระบุภูมิภาคได้ด้วย และต้องระบุหากฟังก์ชันทำงานในภูมิภาคอื่นที่ไม่ใช่ us-central1
หากต้องการตั้งค่าภูมิภาคในไคลเอ็นต์ ให้ระบุภูมิภาคที่ต้องการเมื่อเริ่มต้น
Swift
lazy var functions = Functions.functions(region:"europe-west1")
Objective-C
@property(strong, nonatomic) FIRFunctions *functions;
// ...
self.functions = [FIRFunctions functionsWithRegion:@"europe-west1"];
เว็บ
var functions = firebase.app().functions('europe-west1');
Android
private FirebaseFunctions mFunctions;
// ...
mFunctions = FirebaseFunctions.getInstance("europe-west1");
C++
firebase::functions::Functions* functions;
// ...
functions = firebase::functions::Functions::GetInstance("europe-west1");
Unity
firebase.Functions.FirebaseFunctions functions;
functions = Firebase.Functions.FirebaseFunctions.GetInstance("europe-west1");
ฟังก์ชันพื้นหลัง
ฟังก์ชันที่ทำงานอยู่เบื้องหลังใช้ความหมายของการนำส่งเหตุการณ์อย่างน้อย 1 ครั้ง ซึ่งหมายความว่าในบางกรณีอาจได้รับเหตุการณ์ที่ซ้ำกัน ดังนั้นคุณควรใช้ฟังก์ชันเป็น idempotent หากฟังก์ชันของคุณเป็นแบบ idempotent อยู่แล้ว คุณสามารถทำให้ฟังก์ชันใช้งานได้อีกครั้งในภูมิภาคใหม่โดยใช้ทริกเกอร์เหตุการณ์เดียวกัน และนำฟังก์ชันเก่าออกหลังจากที่คุณยืนยันว่าฟังก์ชันใหม่ได้รับการเข้าชมอย่างถูกต้องแล้ว ระหว่างการเปลี่ยนนี้ ทั้ง 2 ฟังก์ชันจะได้รับเหตุการณ์ ดูการเปลี่ยนภูมิภาคของฟังก์ชันสำหรับลำดับคำสั่งที่แนะนำในการเปลี่ยนภูมิภาคของฟังก์ชัน
หากฟังก์ชันของคุณไม่ได้เป็นแบบซ้ำซ้อนหรือไม่เป็นแบบซ้ำซ้อนที่ขยายออกไปนอกภูมิภาค เราขอแนะนำให้คุณใช้แบบซ้ำซ้อนก่อนย้ายฟังก์ชัน
คําแนะนําภูมิภาคที่ดีที่สุดจะแตกต่างกันไปตามประเภททริกเกอร์เหตุการณ์ ดังนี้
ประเภททริกเกอร์ | คำแนะนำระดับภูมิภาค |
---|---|
Cloud Firestore | ภูมิภาคที่อยู่ใกล้กับตำแหน่งอินสแตนซ์ Cloud Firestore มากที่สุด (ดูส่วนถัดไป) |
Realtime Database | us-central1 เสมอ |
Cloud Storage | ภูมิภาคที่อยู่ใกล้กับตำแหน่งของที่เก็บข้อมูล Cloud Storage มากที่สุด (ดูส่วนถัดไป) |
อื่นๆ | หากคุณกำลังโต้ตอบกับอินสแตนซ์ Realtime Database, อินสแตนซ์ Cloud Firestore หรือที่เก็บข้อมูล Cloud Storage ภายในฟังก์ชัน ภูมิภาคที่แนะนำก็จะเหมือนกันเสมือนว่าคุณมีฟังก์ชันที่ทริกเกอร์โดยทรัพยากรรายการใดรายการหนึ่งเหล่านั้น หรือใช้ภูมิภาคเริ่มต้น us-central1
ฟังก์ชันที่เชื่อมต่อกับ Firebase Hosting จะอยู่ภูมิภาคใดก็ได้ แต่ดูคำแนะนำได้ในภาพรวมโฮสติ้งแบบเซิร์ฟเวอร์เสมือน |
การเลือกภูมิภาคโดยอิงจากสถานที่ตั้ง Cloud Firestore และ Cloud Storage รายการ
ภูมิภาคที่พร้อมใช้งานสำหรับฟังก์ชันอาจไม่ตรงกับภูมิภาคที่พร้อมสำหรับฐานข้อมูล Cloud Firestore และที่เก็บข้อมูล Cloud Storage ของคุณเสมอไป
โปรดทราบว่าหากฟังก์ชันและทรัพยากร (อินสแตนซ์ฐานข้อมูลหรือที่เก็บข้อมูล Cloud Storage) อยู่คนละตำแหน่ง คุณอาจพบว่าเวลาในการตอบสนองและค่าใช้จ่ายการเรียกเก็บเงินเพิ่มขึ้น
ต่อไปนี้เป็นการแมปภูมิภาคที่รองรับฟังก์ชันใกล้เคียงที่สุดสำหรับ Cloud Firestore และ Cloud Storage ในกรณีที่ไม่รองรับภูมิภาคเดียวกัน
ภูมิภาค/หลายภูมิภาคสำหรับ Cloud Firestore และ Cloud Storage | เขตที่ใกล้ที่สุดที่มีฟังก์ชัน |
---|---|
nam5 หรือ us-central (หลายภูมิภาค) |
us-central1 |
eur3 หรือ europe-west (หลายภูมิภาค) |
europe-west1 |
europe-west4 (เนเธอร์แลนด์) |
europe-west1 |
asia-south1 (มุมไบ) |
asia-east2 |
asia-south2 (เดลี) |
asia-east2 |
australia-southeast2 (เมลเบิร์น) |
australia-southeast1 |