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

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


הצגת הפרטים וההגדרות האישיות של מופע של תוסף מותקן

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

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

מעקב אחרי מופע של תוסף מותקן

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

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

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

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

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

  1. נכנסים אל מרכז הבקרה של הפונקציות במסוף Firebase.

  2. בכרטיסייה מרכז בקרה אפשר להציג את הפונקציות מ 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. במסוף Firebase תוספים פותחים את דף הפרטים של המופע של התוסף.

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

  3. לוחצים על הצגת התור בתור שרוצים לנהל. הפעולה הזו תפתח את הדף 'פרטי תור' במסוף 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 במרכז הבקרה של הפונקציות, אפשר: להציג סקירה כללית של שגיאות ומידע על הביצועים של כל הפונקציות ב- בפרויקט שלכם.

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

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

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

  2. צריך ללחוץ על (אפשרויות נוספות) ב- בקצה הימני של הרשומה, בוחרים באפשרות Detailed usage data (נתוני שימוש מפורטים).

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

איך מסירים מופע של תוסף

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

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

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

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

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

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

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