מיקומים של 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 של הפונקציה החדשה. אם הלקוחות שלכם לא מטפלים היטב בהפניות אוטומטיות, תוכלו להעביר את הבקשה דרך שרת proxy מהפונקציה המקורית לפונקציה החדשה, על ידי שליחת בקשה חדשה מהפונקציה המקורית לפונקציה החדשה. השלב האחרון הוא לוודא שכל הלקוחות מפעילים את הפונקציה החדשה.

בחירת מיקום בצד הלקוח לפונקציות שניתן לבצע קריאה אליהן

בנוגע לפונקציה שניתן לבצע קריאה אליה, ההגדרות של הקריאה מהלקוח צריכות לפעול לפי אותן הנחיות כמו פונקציות 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");

פונקציות ברקע

פונקציות ברקע משתמשות בסמינטיקת העברת אירועים של לפחות פעם אחת, כלומר שבנסיבות מסוימות הן עשויות לקבל אירועים כפולים. לכן, כדאי להטמיע פונקציות כך שיהיו עמידות בפני שינוי (idempotent). אם הפונקציה כבר אידמפוטנטית, תוכלו לפרוס מחדש את הפונקציה באזור החדש עם אותו טריגר אירוע ולהסיר את הפונקציה הישנה אחרי שתבדקו שהפונקציה החדשה מקבלת תנועה בצורה תקינה. במהלך המעבר, שתי הפונקציות יקבלו אירועים. במאמר שינוי האזור של פונקציה מפורטת רצף הפקודות המומלץ לשינוי האזורים של פונקציות.

אם הפונקציה שלכם לא חד-פעמית כרגע, או שהיא לא חד-פעמית מעבר לאזור, מומלץ להטמיע אותה קודם לפני שמעבירים אותה.

ההמלצות לאזורים אופטימליים משתנות בהתאם לסוג הטריגר של האירוע:

בחירת אזורים על סמך המיקומים Cloud Firestore ו-Cloud Storage

האזורים הזמינים לפונקציות לא תמיד תואמים בדיוק לאזורים הזמינים למסד הנתונים Cloud Firestore ולקטגוריות Cloud Storage.

חשוב לזכור שאם הפונקציה והמשאב (מכונה של מסד נתונים או קטגוריה Cloud Storage) נמצאים במיקומים שונים, ייתכן שתבחינו בעלייה בזמן האחזור ובעלויות החיוב.

בהמשך מופיעה מיפוי של האזורים הקרובים ביותר עם תמיכה בפונקציות של Cloud Firestore ו-Cloud Storage, למקרים שבהם אין תמיכה באותו אזור: