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

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


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

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

מריצים את הפקודה של רשימת התוספים:

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, ואז לוחצים על Manage בכרטיס של המכונה של התוסף המותקן.

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

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

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

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

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

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

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

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

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

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

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