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

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

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

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

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

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

การกำหนดราคาระดับ 1

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

การกำหนดราคาระดับ 2

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

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

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

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

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

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

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

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

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

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

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

การเลือกภูมิภาคตามตำแหน่ง Cloud Firestore และ Cloud Storage

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

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

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