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

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

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

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

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

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

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

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

ราคาระดับ 2

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

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

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

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

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

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

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

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

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

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