מיקומים של 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, למקרים שבהם אין תמיכה באותו אזור: