הצגה וניהול של משימות Cloud Tasks שהתווספו לתור על ידי תוספים
חלק מהתוספים משתמשים ב-Cloud Tasks כדי להריץ משימות ארוכות יותר. בדרך כלל מדובר במשימות עיבוד שמופעלות בנקודות שונות במחזור החיים של התוסף – התקנה, הגדרה מחדש ואחרי שדרוגים.
בדרך כלל, המשימות האלה מופעלות ומושלמות באופן אוטומטי, בלי התערבות שלכם.
עם זאת, אם תצטרכו לנהל באופן ידני משימות בתור של תוסף – למשל, כדי להשהות את התור או להסיר ממנו משימה שעדיין לא התחילה – תצטרכו לפעול לפי השלבים הבאים:
בקטע Extensions במסוף Firebase, פותחים את דף הפרטים של מופע התוסף.
בדף הפרטים, פותחים את הקטע ממשקי API ומשאבים. אם התוסף משתמש ב-Cloud Tasks, יופיע קטע Cloud Task queues עם רשומה אחת או יותר.
לוחצים על הצגת התור בתור שרוצים לנהל. ייפתח הדף Queue Details (פרטי התור) במסוף Google Cloud, שבו אפשר לראות את המשימות בתור, להשהות את התור, להסיר משימות מהתור וכו'. אפשר לעיין במאמר בנושא ניהול תורים ומשימות במסמכי התיעוד של Cloud Tasks.
הצגת סודות ב-Cloud Secret Manager שנוצרו על ידי תוספים
פותחים את הדף Secret Manager של הפרויקט במסוף Google Cloud.
ברשימת הסודות, אפשר לראות את הסודות שנוצרו עבור Firebase Extensions (לצד סודות אחרים שיצרתם עבור הפרויקט).
לסודות שנוצרים על ידי תוספים יש שמות בפורמט:
ext-extension-instance-id-paramnName
לדוגמה: ext-awesome-task-simplifier-API_KEY
הסודות מסומנים בתווית עם המפתח firebase-extensions-managed. אל תסירו את התווית הזו אלא אם אתם רוצים להפסיק את הניהול של הסוד על ידי Firebase.
בדיקה אם תוסף מותקן תקין
אפשר לבדוק את כל השגיאות מהפונקציות (כולל אלה שנוצרו על ידי Firebase Extensions) במסוף.
בכרטיסייה Health במרכז הבקרה של הפונקציות אפשר לראות סקירה כללית של השגיאות ופרטי הביצועים של כל הפונקציות בפרויקט.
כדי להציג מידע על תוסף ספציפי, משתמשים במסנן בחלק העליון של הדף כדי לבחור פונקציה ספציפית.
בדיקה של תדירות ההפעלה של תוסף מותקן
בכרטיסייה Dashboard של לוח הבקרה של Functions, מאתרים את הפונקציה הספציפית של Firebase Extension שרוצים לבדוק.
לוחצים על more_vert (תפריט האפשרויות הנוספות) בצד שמאל של הרשומה, ואז בוחרים באפשרות נתוני שימוש מפורטים.
במסוף Google Cloud שמוצג, אפשר להתעמק בהפעלות שונות של פונקציה ואפילו לבדוק את קוד המקור שלה.
הצגת היומנים של תוסף
אם אתם מנסים לנפות באגים בפרויקט או לשלוח דוח באגים ל-Firebase, כדאי לכם לעיין ביומנים של הפונקציות שפועלות בפרויקט.
בכרטיסייה Logs של לוח הבקרה של Functions, משתמשים במסנן שבראש הדף כדי לבחור את הפונקציות שנוצרו על ידי התוסף.
עדכון של מופע מותקן של תוסף לגרסה העדכנית
אתם יכולים לעדכן מופע מותקן של תוסף לגרסה האחרונה שלו. יכול להיות שתרצו לעדכן מופע מותקן כי המופע כבר פועל באופן פעיל או מוגדר בתהליך העבודה של הבדיקה, הפרויקט או האפליקציה.
כשמעדכנים מופע, כל המשאבים והלוגיקה הספציפיים לתוסף של המופע נמחקים כדי להשתמש בקוד המקור ובקבצים של הגרסה החדשה. מזהה המופע וחשבון השירות של התוסף לא ישתנו.
במהלך תהליך העדכון, תקבלו הודעה על כל השינויים בגרסה החדשה, ותוכלו לציין ערכים לכל הפרמטרים החדשים.
אם אין גרסה חדשה זמינה של התוסף, לא יוצג לחצן עדכון בדף הפרטים.
בודקים מה חדש בעדכון ומגדירים את התוסף (אם צריך).
לוחצים על עדכון התוסף.
הגדרה מחדש של מופע של תוסף מותקן
אפשר לשנות את הערכים של הפרמטרים שהמשתמש הגדיר עבור מופע מותקן של תוסף. הערכים החדשים האלה ישמשו בכל הטריגרים העתידיים של המופע, אבל כל הארטיפקטים או הרכיבים המבניים הקודמים שנוצרו על ידי התוסף (כמו תמונות מאוחסנות או קטגוריות אחסון קיימות) לא ישתנו.
בפינה השמאלית העליונה, לוחצים על הגדרה מחדש של התוסף.
פועלים לפי ההוראות במסך כדי להגדיר מחדש את ערכי הפרמטרים של התוסף.
לוחצים על שמירה.
הסרת מופע של תוסף
אפשר להסיר מופע של תוסף מהפרויקט ב-Firebase. הפעולה הזו מוחקת את חשבון השירות ואת כל המשאבים (כמו קבוצת פונקציות) ש-Firebase יצרה במיוחד עבור המופע הזה של התוסף. עם זאת, הפריטים הבאים לא נמחקים:
כל הארטיפקטים שנוצרו על ידי התוסף (כמו תמונות מאוחסנות).
כל משאב אחר בפרויקט, כמו מופע של מסד נתונים או Cloud Storageקטגוריית אחסון. גם אם התוסף יצר אינטראקציה עם המשאבים האחרים האלה, הם לא ספציפיים לתוסף, ולכן הם לא נמחקים אם התוסף מוסר.
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-07-25 (שעון UTC)."],[],[],null,["\u003cbr /\u003e\n\nTo install or manage extensions, you must be assigned one of these roles:\n[Owner or Editor](/docs/projects/iam/roles-basic) or\n[Firebase Admin](/docs/projects/iam/roles-predefined-all-products). \nFirebase console Firebase CLI Autogenerated SDK \n\n\u003cbr /\u003e\n\nList a project's installed extension instances\n\nYou can list every instance of the extensions you installed.\n\nRun the extensions-list command: \n\n```\nfirebase ext:list --project=projectId-or-alias\n```\n\nView details and configuration of an installed extension instance\n\n1. Go to your [Firebase Extensions dashboard](https://console.firebase.google.com/project/_/extensions/) in the Firebase console.\n\n2. On the installed extension instance's card, click **Manage**.\n\nMonitor an installed extension instance\n\nIn the Firebase console, you can monitor the activity of an installed\nextension, including checks on its health, usage, and logs.\n\nSet budget alerts\n\nSetting budget alerts is a good practice in general, but alerts may be\nespecially important when you're trusting another party's code to run in your\nproject.\n\nMake sure that you set up\n[budget alerts](/docs/projects/billing/avoid-surprise-bills#set-up-budget-alert-emails)\nfor your Firebase project.\n\nView functions created by extensions\n\n1. Go to your [Functions dashboard](https://console.firebase.google.com/project/_/functions/list) of the Firebase console.\n\n2. In the *Dashboard* tab, you can view the functions from\n Firebase Extensions (alongside any other functions that you've deployed\n for your project).\n\n Functions created by extensions have names, in the format:\n **ext-** \u003cvar translate=\"no\"\u003eextension-instance-id\u003c/var\u003e**-** \u003cvar translate=\"no\"\u003efunctionName\u003c/var\u003e\n\n For example: `ext-awesome-task-simplifier-onUserCreate`\n\nView Cloud Scheduler jobs created by extensions\n\n1. Open your project's [Cloud Scheduler](https://console.cloud.google.com/cloudscheduler?project=_) page\n in the Google Cloud console.\n\n2. In the Jobs list, you can view the Cloud Scheduler jobs from\n Firebase Extensions (alongside any other jobs you've created for your\n project).\n\n Jobs created by extensions have names in the format:\n **firebase-ext-** \u003cvar translate=\"no\"\u003eextension-instance-id\u003c/var\u003e**-** \u003cvar translate=\"no\"\u003efunctionName\u003c/var\u003e\n\n For example: `firebase-ext-awesome-task-simplifier-doTask`\n\nView and manage Cloud Tasks enqueued by extensions\n\nSome extensions use [Cloud Tasks](https://cloud.google.com/tasks/docs/)\nto run longer-running tasks: most commonly, processing tasks that run at various\npoints in an extension's lifecycle---installation, reconfiguration, and\nafter upgrades.\n\nNormally, these tasks run and complete automatically, without your intervention.\nHowever, if you ever need to manually manage an extension's queued\ntasks---for example, to pause the queue or remove from the queue a task that\nhasn't started yet---follow these steps:\n\n1. In the Firebase console [Extensions](//console.firebase.google.com/project/_/extensions)\n section, open the extension instance's details page.\n\n2. On the details page, open the **APIs and resources** section. If the\n extension uses Cloud Tasks, there will be a **Cloud Task queues** section\n with one or more entries.\n\n3. Click **View queue** for the queue you want to manage. This will open the\n Queue Details page in the Google Cloud console, from which you can view\n queued tasks, pause the queue, remove tasks from the queue, and so on. See\n [Manage queues and tasks](https://cloud.google.com/tasks/docs/deleting-appengine-queues-and-tasks)\n in the Cloud Tasks documentation.\n\n | **Note:** You can pause a queue, but if you leave it paused for too long, tasks might fail with authentication errors when you resume the queue. (Task authentication expires an hour after it joins the queue.)\n\n \u003cbr /\u003e\n\n | **Warning:** Don't delete the queue; the extension needs it to operate. If you accidentally delete the queue, you'll have to do the following:\n |\n | \u003cbr /\u003e\n |\n | 1. Install a new instance of the extension.\n | 2. Only after installing the new instance, uninstall the old instance.\n\nView Cloud Secret Manager secrets created by extensions\n\n1. Open your project's [Secret Manager](https://console.cloud.google.com/security/secret-manager?project=_) page\n in the Google Cloud console.\n\n2. In the Secrets list, you can view the secrets created for\n Firebase Extensions (alongside any other secrets you've created for your\n project).\n\n Secrets created by extensions have names in the format:\n **ext-** \u003cvar translate=\"no\"\u003eextension-instance-id\u003c/var\u003e**-** \u003cvar translate=\"no\"\u003eparamnName\u003c/var\u003e\n\n For example: `ext-awesome-task-simplifier-API_KEY`\n\n Secrets are labeled with the key `firebase-extensions-managed`. Don't remove\n this label unless you want to stop Firebase from managing the secret.\n\nCheck if an installed extension is healthy\n\nYou can review all the errors from functions (including those created by\nFirebase Extensions) in the console.\n\n1. In the *Health* tab of your [Functions dashboard](https://console.firebase.google.com/project/_/functions/list), you can\n view an overview of errors and performance information for all functions in\n your project.\n\n2. To view information for a specific extension, use the filter at the top of\n the page to select a specific function.\n\nCheck how often an installed extension is running\n\n1. In the *Dashboard* tab of your [Functions dashboard](https://console.firebase.google.com/project/_/functions/list),\n locate the specific function for the Firebase Extension that\n you want to check.\n\n2. Click more_vert (the overflow menu) on\n the far right-side of the entry, then select **Detailed usage stats**.\n\n3. In the displayed Google Cloud console, you can drill down into various\n invocations of a function and even inspect its source code.\n\nView the logs for an extension\n\nIf you're trying to debug your project, or submit a bug report to Firebase, it's\nuseful to view logs of the functions running in your project.\n\nIn the *Logs* tab of your [Functions dashboard](https://console.firebase.google.com/project/_/functions/list), use the filter at the\ntop of the page to select the functions created by your extension.\n\nUpdate an installed extension instance to the latest version\n\nYou can update an installed instance of an extension to its latest released\nversion. You might want to update an installed instance because the instance is\nalready actively running or set up in your testing, project, or app workflow.\n| **Note:** If you installed an extension using an auto-generated SDK, use the same method to upgrade it, and not the console or CLI.\n\nWhen you update an instance, all the instance's extension-specific resources and\nlogic is overwritten to use the new version's source code and files. The\nextension's instance ID and service account will not change.\n\nDuring the update process, you'll be notified of any changes for the new\nversion, and you'll be able to specify values for any new parameters.\n\n1. Go to your [Firebase Extensions dashboard](https://console.firebase.google.com/project/_/extensions/), then on the installed\n extension instance's card, click **Manage**.\n\n2. In the upper-right corner, click **Update extension**.\n\n If the extension doesn't have an available new version, the details page\n won't have an update button.\n3. Review what's new in the update and configure the extension (if needed).\n\n4. Click **Update extension**.\n\nReconfigure an installed extension instance\n\nYou can change the values of the user-configured parameters for an installed\nextension instance. These new values will be used in any *future* triggers of the\ninstance, but all previous artifacts or structural elements created by the\nextension (like stored images or existing storage buckets) will not be changed.\n| **Note:** If you installed an extension using an auto-generated SDK, use the same method to reconfigure it, and not the console or CLI.\n\n1. Go to your [Firebase Extensions dashboard](https://console.firebase.google.com/project/_/extensions/), then on the installed extension\n instance's card, click **Manage**.\n\n2. In the upper-right corner, click **Reconfigure extension**.\n\n3. Follow the on-screen instructions to reconfigure the parameter values\n for your extension.\n\n4. Click **Save**.\n\n| **Note:** Saving changes for an extension may take the system 3-5 minutes.\n\nUninstall an extension instance\n\nYou can uninstall an instance of an extension from your Firebase project. This action deletes\nthe\n[service account](/docs/extensions/permissions-granted-to-extension#uninstall-extension)\nand all the [resources](/docs/extensions/overview-use-extensions#resources)\n(like a set of functions) that Firebase created specifically for that instance\nof the extension. However, the following are ***not*** deleted:\n\n- Any artifacts created by the extension (like stored images).\n\n- Any other resources in your project, like a database instance or Cloud Storage\n bucket. Even if the extension interacted with these other resources, they\n are not *extension-specific*, so they aren't deleted if the extension is\n uninstalled.\n\nHere's how to uninstall an extension:\n\n1. Go to your [Firebase Extensions dashboard](https://console.firebase.google.com/project/_/extensions/), then on the installed extension\n instance's card, click **Manage**.\n\n2. At the bottom of the screen, click **Uninstall extension**.\n\n3. Review what will be deleted, then click **Uninstall extension** to confirm\n the deletion.\n\n| **Note:** If you installed the extension using the autogenerated SDK, be sure to also remove the instance configuration from your Cloud Functions code."]]