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

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

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

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

הפעל את הפקודה extensions-list:

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

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

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

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

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

ודא שאתה מגדיר התראות תקציב עבור פרויקט Firebase שלך.

הצג פונקציות שנוצרו על ידי הרחבות

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

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

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

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

הצג משרות Cloud Scheduler שנוצרו על ידי הרחבות

  1. פתח את דף מתזמן הענן של הפרויקט שלך במסוף Google Cloud.

  2. ברשימת המשרות, אתה יכול להציג את משימות Cloud Scheduler מהרחבות Firebase (לצד כל משימות אחרות שיצרת עבור הפרויקט שלך).

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

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

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

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

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

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

  2. בדף הפרטים, פתח את הקטע ממשקי API ומשאבים . אם התוסף משתמש ב-Cloud Tasks, יהיה קטע תורים של Cloud Task עם ערך אחד או יותר.

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

הצג את הסודות של Cloud Secret Manager שנוצרו על ידי הרחבות

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

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

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

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

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

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

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

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

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

בדוק באיזו תדירות תוסף מותקן פועל

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

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

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

הצג את היומנים של הרחבה

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

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

עדכן מופע תוסף מותקן לגרסה העדכנית ביותר

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

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

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

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

    firebase ext:update extensionInstanceId

    כדי לעדכן לגרסה ספציפית, ספק את הגרסה שאליה ברצונך לעדכן:

    firebase ext:update extensionInstanceId versionNumber

  2. לאחר מכן, כדי לפרוס את ההרחבות במניפסט שלך בפרויקט Firebase, הרץ:

    firebase deploy --only extensions --project=projectId-or-alias

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

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

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

    firebase ext:configure extensionInstanceId

  2. לאחר מכן, כדי לפרוס את ההרחבות במניפסט שלך בפרויקט Firebase, הרץ:

    firebase deploy --only extensions --project=projectId-or-alias

הסר התקנה של מופע הרחבה

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

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

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

כך מסירים התקנת תוסף:

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

    firebase ext:uninstall extensionInstanceId

  2. לאחר מכן, כדי לפרוס את השינויים במניפסט שלך בפרויקט Firebase, הרץ:

    firebase deploy --only extensions --project=projectId-or-alias