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

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

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

  1. עבור אל לוח המחוונים של Firebase Extensions במסוף Firebase.

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

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

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

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

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

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

  4. לחץ על עדכן הרחבה .

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

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

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

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

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

  4. לחץ על שמור .

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

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

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

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

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

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

  2. בתחתית המסך, לחץ על הסר התקנה של תוסף .

  3. סקור מה יימחק ולאחר מכן לחץ על הסר התקנה של תוסף כדי לאשר את המחיקה.