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

Cloud Functions เป็นระดับภูมิภาค ซึ่งหมายความว่าโครงสร้างพื้นฐานที่เรียกใช้ฟังก์ชันจะอยู่ในภูมิภาคที่เฉพาะเจาะจงและได้รับการจัดการโดย Google เพื่อให้พร้อมใช้งานซ้ำซ้อนในทุกโซนภายในภูมิภาคเหล่านั้น

เมื่อเลือกภูมิภาคที่จะเรียกใช้ฟังก์ชัน สิ่งที่ควรพิจารณาเป็นหลักคือเวลาในการตอบสนองและความพร้อมใช้งาน โดยทั่วไป คุณสามารถเลือกภูมิภาคที่อยู่ใกล้กับผู้ใช้ แต่ก็ควรพิจารณาตำแหน่งของผลิตภัณฑ์และบริการอื่นๆ ที่แอปใช้ด้วย การใช้บริการในหลายภูมิภาคอาจส่งผลต่อเวลาในการตอบสนองของแอป รวมถึงราคา

โดยค่าเริ่มต้น Firebase CLI จะทำให้ฟังก์ชันใช้งานได้ในภูมิภาคตามการกำหนดค่าของโปรเจ็กต์ สำหรับฟังก์ชันที่ขับเคลื่อนด้วยเหตุการณ์ โดยทั่วไปจะติดตั้งใช้งานในภูมิภาคในภูมิภาคของแหล่งข้อมูลที่ทริกเกอร์ (เช่น ฐานข้อมูล Cloud Firestore หรือที่เก็บข้อมูล Cloud Storage) และติดตั้งใช้งานใน us-central1 เป็นทางเลือกสำรอง

หลังจากติดตั้งใช้งานแล้ว คุณสามารถยืนยันภูมิภาคในคอนโซล Firebase หรือโดยการเรียกใช้ firebase functions:list หากต้องการให้ฟังก์ชันทำงานในภูมิภาคอื่น คุณสามารถเปลี่ยนภูมิภาคได้

ภูมิภาคที่รองรับ

ในรายการในส่วนนี้ ไอคอน energy_savings_leaf บ่งบอกว่าไฟฟ้าสำหรับภูมิภาคนี้ผลิตโดยมีการปล่อยคาร์บอนต่ำ ดูข้อมูลเพิ่มเติมได้ที่พลังงานแบบปลอดคาร์บอนสำหรับภูมิภาค Google Cloud

ราคาสำหรับระดับ 1

Cloud Functions พร้อมให้บริการในภูมิภาคต่อไปนี้ด้วยราคาเทียร์ 1

ราคาสำหรับระดับ 2

Cloud Functions พร้อมให้บริการในภูมิภาคต่อไปนี้ด้วยราคาในระดับที่ 2

ฟังก์ชันในภูมิภาคหนึ่งๆ ในโปรเจ็กต์หนึ่งๆ ต้องมีชื่อที่ไม่ซ้ำกัน (ไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่) แต่ฟังก์ชันในภูมิภาคต่างๆ หรือในโปรเจ็กต์ต่างๆ อาจใช้ชื่อเดียวกันได้

แนวทางปฏิบัติแนะนำในการระบุภูมิภาค

โดยค่าเริ่มต้น Firebase CLI จะทำให้ฟังก์ชันใช้งานได้ในภูมิภาคตามการกำหนดค่าของโปรเจ็กต์ สำหรับฟังก์ชันที่ขับเคลื่อนด้วยเหตุการณ์ โดยทั่วไปจะติดตั้งใช้งานในภูมิภาคในภูมิภาคของแหล่งข้อมูลที่ทริกเกอร์ (เช่น ฐานข้อมูล Cloud Firestore หรือที่เก็บข้อมูล Cloud Storage) และติดตั้งใช้งานใน us-central1 เป็นทางเลือกสำรอง

เราขอแนะนำให้คุณตั้งค่าภูมิภาคที่เฉพาะเจาะจงแทนการใช้ค่าเริ่มต้นของ Firebase ซึ่งอาจเปลี่ยนแปลงเมื่อเวลาผ่านไป เมื่อตั้งค่าขอบเขต ให้ทำตามคำแนะนำในส่วนนี้สำหรับทริกเกอร์แต่ละประเภท

หากต้องการตั้งค่าภูมิภาคที่ฟังก์ชันทำงาน ให้ตั้งค่าพารามิเตอร์ region ในคําจํากัดความของฟังก์ชันดังที่แสดงต่อไปนี้

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 นอกจากนี้ โปรดทราบว่าเมื่อระบุภูมิภาคสำหรับทริกเกอร์เบื้องหลังหลายประเภท คุณจะต้องระบุตัวกรองเหตุการณ์ที่ถูกต้องพร้อมกับภูมิภาคด้วย ในตัวอย่างด้านบน Cloud Firestore document คือสิ่งที่ส่งเหตุการณ์ สำหรับทริกเกอร์ Cloud Storage ตัวกรองเหตุการณ์อาจเป็น bucket สำหรับทริกเกอร์ Pub/Sub จะเป็น topic เป็นต้น

ดูข้อมูลเพิ่มเติมเกี่ยวกับการเปลี่ยนภูมิภาคสำหรับฟังก์ชันที่จัดการการเข้าชมเวอร์ชันที่ใช้งานจริงได้ที่เปลี่ยนภูมิภาคของฟังก์ชัน

HTTP และฟังก์ชันที่เรียกใช้ได้จากฝั่งไคลเอ็นต์

สำหรับฟังก์ชัน HTTP และฟังก์ชันที่เรียกใช้ได้ เราขอแนะนำให้คุณตั้งค่าฟังก์ชันเป็นภูมิภาคปลายทางก่อน หรือตั้งค่าให้ใกล้เคียงกับตำแหน่งที่ลูกค้าส่วนใหญ่คาดว่าจะอยู่มากที่สุด แล้วจึงแก้ไขฟังก์ชันเดิมเพื่อเปลี่ยนเส้นทางคำขอ HTTP ไปยังฟังก์ชันใหม่ (ฟังก์ชันทั้งสองมีชื่อเดียวกันได้) หากไคลเอ็นต์ของฟังก์ชัน HTTP รองรับการเปลี่ยนเส้นทาง คุณก็เพียงแค่เปลี่ยนฟังก์ชันเดิมให้แสดงสถานะการเปลี่ยนเส้นทาง HTTP (301) พร้อมกับ URL ของฟังก์ชันใหม่ หากไคลเอ็นต์ของคุณจัดการการเปลี่ยนเส้นทางได้ไม่ดี คุณสามารถพร็อกซีคำขอจากฟังก์ชันเดิมไปยังฟังก์ชันใหม่ได้โดยเริ่มคำขอใหม่จากฟังก์ชันเดิมไปยังฟังก์ชันใหม่ ขั้นตอนสุดท้ายคือตรวจสอบว่าไคลเอ็นต์ทั้งหมดเรียกใช้ฟังก์ชันใหม่

การเลือกตำแหน่งฝั่งไคลเอ็นต์สำหรับฟังก์ชันที่เรียกใช้ได้

สำหรับการตั้งค่าฟังก์ชันที่เรียกใช้ได้ การตั้งค่าที่เรียกใช้ได้ของไคลเอ็นต์ควรเป็นไปตามหลักเกณฑ์เดียวกันกับฟังก์ชัน HTTP ไคลเอ็นต์ยังระบุภูมิภาคได้ด้วย และควรระบุหากฟังก์ชันทำงานในภูมิภาคอื่นนอกเหนือจากค่าเริ่มต้นของโปรเจ็กต์

หากต้องการตั้งค่าภูมิภาคในไคลเอ็นต์ ให้ระบุภูมิภาคที่ต้องการเมื่อเริ่มต้นใช้งาน ดังนี้

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

ฟังก์ชันที่ทำงานอยู่เบื้องหลัง

ฟังก์ชันที่ทำงานอยู่เบื้องหลังจะใช้ความหมายของการนำส่งเหตุการณ์อย่างน้อย 1 ครั้ง ซึ่งหมายความว่าในบางกรณี ฟังก์ชันอาจได้รับเหตุการณ์ที่ซ้ำกัน ดังนั้น คุณควรใช้ฟังก์ชันที่ไม่เปลี่ยนแปลง หากฟังก์ชันเป็นแบบ Idempotent อยู่แล้ว คุณสามารถทำให้ฟังก์ชันใช้งานได้อีกครั้งในภูมิภาคใหม่ด้วยทริกเกอร์เหตุการณ์เดียวกัน และนำฟังก์ชันเก่าออกหลังจากยืนยันว่าฟังก์ชันใหม่ได้รับการเข้าชมอย่างถูกต้อง ในระหว่างการเปลี่ยนผ่านนี้ ทั้ง 2 ฟังก์ชันจะได้รับเหตุการณ์ ดูเปลี่ยนภูมิภาคของฟังก์ชันเพื่อดูลำดับคำสั่งที่แนะนำในการเปลี่ยนภูมิภาคสำหรับฟังก์ชัน

หากฟังก์ชันของคุณไม่ได้เป็นแบบ Idempotent ในปัจจุบัน หรือ Idempotency ของฟังก์ชันไม่ได้ขยายออกไปนอกภูมิภาค เราขอแนะนำให้คุณใช้ Idempotency ก่อนที่จะย้ายฟังก์ชัน

คำแนะนำเกี่ยวกับภูมิภาคที่เหมาะสมที่สุดจะแตกต่างกันไปตามประเภททริกเกอร์เหตุการณ์ ดังนี้

การเลือกภูมิภาคตามสถานที่ตั้งของ Cloud Firestore และ Cloud Storage

ภูมิภาคที่ใช้ได้สำหรับฟังก์ชันอาจไม่ตรงกับภูมิภาคที่ใช้ได้สำหรับฐานข้อมูล Cloud Firestore และที่เก็บข้อมูล Cloud Storage เสมอไป

โปรดทราบว่าหากฟังก์ชันและทรัพยากร (อินสแตนซ์ฐานข้อมูลหรือ Cloud Storage บัケット) อยู่คนละตำแหน่ง คุณอาจพบว่าเวลาในการตอบสนองและค่าใช้จ่ายที่เรียกเก็บเพิ่มขึ้น

ต่อไปนี้คือการแมปภูมิภาคที่รองรับฟังก์ชันที่ใกล้เคียงที่สุดสำหรับ Cloud Firestore และ Cloud Storage ในกรณีที่ไม่รองรับภูมิภาคเดียวกัน