ניהול התוספים המותקנים ל-Firebase

כדי להתקין או לנהל תוספים, צריך להיות לכם אחד מהתפקידים הבאים: בעלים או עורך או אדמין ב-Firebase.


הצגת רשימה של מכונות התוספים המותקנות בפרויקט

אפשר לקבל רשימה של כל המופעים של התוספים שהותקנו.

מריצים את הפקודה extensions-list:

firebase ext:list --project=projectId-or-alias

הצגת הפרטים וההגדרות של מכונה מותקנת של תוסף

  1. עוברים אל מרכז הבקרה של Firebase Extensions במסוף Firebase.

  2. בכרטיס של מופע התוסף שמותקן, לוחצים על ניהול.

מעקב אחרי מכונה של תוסף שהותקן

במסוף Firebase אפשר לעקוב אחרי הפעילות של תוסף מותקן, כולל בדיקות של התקינות, השימוש והיומנים שלו.

הגדרה של התראות לגבי תקציב

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

חשוב להגדיר התראות תקציב לפרויקט ב-Firebase.

הצגת פונקציות שנוצרו על ידי תוספים

  1. עוברים אל מרכז הבקרה של Functions במסוף Firebase.

  2. בכרטיסייה Dashboard אפשר לראות את הפונקציות מ-Firebase Extensions (לצד כל הפונקציות האחרות שפרסמתם בפרויקט).

    לפונקציות שנוצרות על ידי תוספים יש שמות, בפורמט: ext-extension-instance-id-functionName

    לדוגמה: ext-awesome-task-simplifier-onUserCreate

הצגת Cloud Scheduler משימות שנוצרו על ידי תוספים

  1. פותחים את הדף Cloud Scheduler של הפרויקט במסוף Google Cloud.

  2. ברשימת המשימות תוכלו לראות את המשימות של Cloud Scheduler מ-Firebase Extensions (לצד משימות אחרות שיצרתם לפרויקט).

    למשימות שנוצרות על ידי תוספים יש שמות בפורמט: firebase-ext-extension-instance-id-functionName

    לדוגמה: firebase-ext-awesome-task-simplifier-doTask

הצגה וניהול של משימות Cloud Tasks שנשלחו לתור על ידי תוספים

תוספים מסוימים משתמשים ב-Cloud Tasks כדי להריץ משימות ממושכות יותר: בדרך כלל, משימות עיבוד שפועלות בנקודות שונות במחזור החיים של התוסף – התקנה, הגדרה מחדש ואחרי שדרוגים.

בדרך כלל, המשימות האלה פועלות ומסתיימים באופן אוטומטי, בלי התערבות מצדכם. עם זאת, אם תצטרכו לנהל באופן ידני את המשימות בתור של תוסף – לדוגמה, כדי להשהות את התור או להסיר ממנו משימה שעדיין לא התחילה – עליכם לפעול לפי השלבים הבאים:

  1. בקטע Extensions במסוף Firebase, פותחים את דף הפרטים של מכונה של התוסף.

  2. בדף הפרטים, פותחים את הקטע APIs and resources. אם התוסף משתמש ב-Cloud Tasks, יופיע הקטע Cloud Task queues (תורנויות של Cloud Tasks) עם רשומה אחת או יותר.

  3. לוחצים על הצגת התור של התור שרוצים לנהל. הפעולה הזו תפתח את הדף Queue Details במסוף Google Cloud, שבו תוכלו לראות את המשימות שבתור, להשהות את התור, להסיר משימות מהתור וכו'. למידע נוסף, ראו ניהול משימות ותורים במסמכי העזרה של Cloud Tasks.

הצגת סודות ב-Cloud Secret Manager שנוצרו על ידי תוספים

  1. פותחים את הדף Secret Manager של הפרויקט במסוף Google Cloud.

  2. ברשימת הסודות תוכלו לראות את הסודות שנוצרו עבור Firebase Extensions (לצד סודות אחרים שיצרתם לפרויקט).

    לשמות של סודות שנוצרו על ידי תוספים יש את הפורמט הבא: ext-extension-instance-id-paramnName

    לדוגמה: ext-awesome-task-simplifier-API_KEY

    הסודות מסומנים באמצעות המפתח firebase-extensions-managed. אל תסירו את התווית הזו אלא אם אתם רוצים להפסיק את ניהול הסוד ב-Firebase.

איך בודקים אם תוסף מותקן תקין

אפשר לבדוק את כל השגיאות מהפונקציות (כולל אלה שנוצרו על ידי Firebase Extensions) במסוף.

  1. בכרטיסייה Health במרכז הבקרה של Functions תוכלו לראות סקירה כללית של השגיאות ונתוני הביצועים של כל הפונקציות בפרויקט.

  2. כדי להציג מידע על תוסף ספציפי, משתמשים במסנן בחלק העליון של הדף כדי לבחור פונקציה ספציפית.

בדיקת תדירות הפעלת תוסף שהותקן

  1. בכרטיסייה Dashboard במרכז הבקרה של הפונקציות, מאתרים את הפונקציה הספציפית של Firebase Extension שרוצים לבדוק.

  2. לוחצים על (תפריט ההרחבה) בפינה השמאלית הרחוקה של הרשומה, ובוחרים באפשרות נתוני שימוש מפורטים.

  3. במסוף Google Cloud שמוצג, אפשר להציג פירוט של הקריאות השונות לפונקציה ואפילו לבדוק את קוד המקור שלה.

הצגת היומנים של תוסף

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

בכרטיסייה Logs במרכז הבקרה של Functions, משתמשים במסנן בחלק העליון של הדף כדי לבחור את הפונקציות שנוצרו על ידי התוסף.

עדכון של מכונה מותקנת של תוסף לגרסה האחרונה

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

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

במהלך תהליך העדכון, תקבלו הודעה על כל שינוי בגרסה החדשה, ותוכלו לציין ערכים לכל פרמטר חדש.

  1. עוברים אל מרכז הבקרה של Firebase Extensions, ובכרטיס של מופע התוסף ההתקין לוחצים על ניהול.

  2. בפינה הימנית העליונה, לוחצים על עדכון התוסף.

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

  3. בודקים מה חדש בעדכון ומגדירים את התוסף (אם צריך).

  4. לוחצים על עדכון התוסף.

הגדרה מחדש של מופע של תוסף שהותקן

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

  1. עוברים אל מרכז הבקרה של Firebase Extensions, ובכרטיס של מופע התוסף שמותקן לוחצים על ניהול.

  2. בפינה הימנית העליונה, לוחצים על Reconfigure extension (הגדרה מחדש של התוסף).

  3. פועלים לפי ההוראות במסך כדי להגדיר מחדש את ערכי הפרמטרים של התוסף.

  4. לוחצים על שמירה.

הסרה של מכונה של תוסף

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

  • כל ארטיפקט שנוצר על ידי התוסף (למשל תמונות שמאוחסנות).

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

כך מסירים תוסף:

  1. עוברים אל מרכז הבקרה של Firebase Extensions, ובכרטיס של מופע התוסף שמותקן לוחצים על ניהול.

  2. בתחתית המסך, לוחצים על הסרת התוסף.

  3. בודקים מה יימחק ולוחצים על הסרת התוסף כדי לאשר את המחיקה.