ตำแหน่งของ Cloud Functions

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 อยู่แล้ว คุณสามารถทำให้ฟังก์ชันใช้งานได้อีกครั้งในภูมิภาคใหม่โดยใช้ทริกเกอร์เหตุการณ์เดียวกัน และนำฟังก์ชันเก่าออกหลังจากที่คุณยืนยันว่าฟังก์ชันใหม่ได้รับการเข้าชมอย่างถูกต้องแล้ว ในระหว่างการเปลี่ยนผ่านนี้ ทั้ง 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