ตำแหน่งของ 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 หากฟังก์ชันของคุณเป็นแบบ 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