תחילת השימוש ב-Firebase עם פרויקט קיים ב-Google Cloud

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

כשמוסיפים את Firebase לפרויקט ב-Google Cloud, המערכת מפעילה באופן אוטומטי כמה ממשקי API ויוצרת חשבונות שירות כדי לפשט את השימוש בכל השירותים והממשקים של Firebase. בנוסף, Firebase מוסיפה את התווית firebase:enabled לפרויקט בדף IAM & Admin > Labels במסוף Google Cloud. מה קורה כשמוסיפים את Firebase?

הקשר בין פרויקט Firebase לפרויקט Google Cloud

פרויקט ב-Firebase הוא פרויקט ב-Google Cloud, ולכן:

• אתם יכולים לגשת לפרויקט ולבצע בו פעולות במסוף Firebase, במסוף Google Cloud ובמסוף Google APIs.

• אתם יכולים לבצע פעולות בפרויקט באמצעות ה-CLI של Firebase, gcloud CLI וכל משאב של Terraform מ-Google.

• בפרויקט אפשר להשתמש במוצרים ובממשקי API גם של Firebase וגם של Google Cloud.

• הרשאות ותפקידים של IAM בפרויקט משותפים ל-Firebase ול-Google Cloud. כל הרשאת גישה שיש לחבר בפרויקט (כלומר, חשבון משתמש) לפרויקט ב-Google Cloud תחול גם על הפרויקט ב-Firebase (ולהפך).

• החיוב בפרויקט משותף ל-Firebase ול-Google Cloud. אם החיוב מופעל בפרויקט ב-Google Cloud, הפרויקט ב-Firebase יהיה במינוי Blaze בתשלום לפי שימוש של Firebase.

• מזהים ייחודיים של הפרויקט (כמו מספר הפרויקט ומזהה הפרויקט) משותפים ל-Firebase ול-Google Cloud.

• כל היררכיית משאבים שחלה על הפרויקט ב-Google Cloud (לדוגמה, ארגון, תיקיות וכו') תחול גם על הפרויקט ב-Firebase.

• מחיקת הפרויקט תמחק אותו מ-Firebase ומ-Google Cloud.

• אם מוחקים או משנים משאב או נתונים בפרויקט, השינוי חל גם ב-Firebase וגם ב-Google Cloud.

איך מוסיפים את Firebase לפרויקט קיים ב-Google Cloud

אתם יכולים "להוסיף את Firebase" לפרויקט קיים ב-Google Cloud באמצעות אחת מהאפשרויות הבאות. חשוב לוודא שיש לכם את ההרשאות הנדרשות להוספת Firebase לפרויקט ב-Google Cloud.

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

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

בהמשך הדף מופיעות שאלות נפוצות נוספות ופתרונות לבעיות בנושא "הוספת Firebase" לפרויקט ב-Google Cloud.

מסוף Firebase

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

2. לוחצים על הכפתור כדי ליצור פרויקט חדש ב-Firebase.

3. בתחתית הדף, לוחצים על Add Firebase to Google Cloud project.

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

5. לוחצים על פתיחת הפרויקט.

6. אם מוצגת בקשה, מאשרים את התנאים של Firebase.

7. פועלים לפי ההוראות במסך כדי להוסיף את Firebase ולהגדיר פרויקט ב-Firebase.

   שימו לב שהפעלת העזרה מבוססת ה-AI במסוף Firebase וב-Google Analytics היא אופציונלית.

Firebase CLI

1. אם עדיין לא עשיתם זאת, התקינו את ה-CLI של Firebase.

2. נכנסים לאותו חשבון Google שנותן לכם גישה לפרויקט הקיים ב-Google Cloud.

3. מריצים את הפקודה הבאה:

   firebase projects:addfirebase

4. כשמוצגת בקשה, בוחרים את הפרויקט הקיים ב-Google Cloud מהרשימה שמוצגת.

הערה: אם מופיעה השגיאה 403 PERMISSION_DENIED כשמנסים להוסיף את Firebase לפרויקט קיים ב-Google Cloud, יכול להיות שאין לכם את ההרשאות הנדרשות או שלא אישרתם את התנאים וההגבלות של Firebase.

‫API בארכיטקטורת REST

1. מפעילים את Firebase Management API בפרויקט הקיים ב-Google Cloud.

2. יוצרים את אסימון הגישה ל-API.

3. מפעילים את שירותי Firebase בפרויקט באמצעות קריאה ל-projects.addFirebase.

   שימו לב: כדי לבצע את הקריאה הזו, תצטרכו את שם המשאב של הפרויקט.

הוראות מפורטות זמינות במאמר הוספת שירותי Firebase לפרויקט במדריך של Firebase: "הגדרה וניהול של פרויקט Firebase באמצעות Management API בארכיטקטורת REST". חשוב לוודא שפעלתם בדיוק לפי ההוראות בקטע לפני שמתחילים במדריך.

הערה: אם קיבלתם שגיאת 403 PERMISSION_DENIED כשניסיתם להוסיף את Firebase לפרויקט קיים ב-Google Cloud, יכול להיות שאין לכם את ההרשאות הנדרשות או שלא אישרתם את התנאים וההגבלות של Firebase.

Terraform

1. מפעילים את Firebase Management API‏ (firebase.googleapis.com) בפרויקט הקיים ב-Google Cloud.

2. מפעילים את שירותי Firebase בפרויקט באמצעות המשאב google_firebase_project.

מידע מפורט על השימוש ב-Firebase וב-Terraform זמין במאמר תחילת העבודה עם Terraform ו-Firebase.

הערה: אם מופיעה השגיאה 403 PERMISSION_DENIED כשמנסים להוסיף את Firebase לפרויקט קיים ב-Google Cloud, יכול להיות שאין לכם את ההרשאות הנדרשות או שלא אישרתם את התנאים וההגבלות של Firebase.

שאלות נפוצות ופתרון בעיות

האם צריך לאשר את התנאים וההגבלות של Firebase כדי להתחיל להשתמש ב-Firebase?

כדי לגשת לכל היכולות של Firebase בפרויקט ב-Google Cloud ולהשתמש בהן, צריך לאשר את התנאים וההגבלות של Firebase. כדי "להוסיף את Firebase" לפרויקט קיים ב-Google Cloud, צריך גם לאשר את התנאים של Firebase.

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

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

• לאשר את התנאים של Firebase ישירות באמצעות תהליך העבודה לאישור התנאים.

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

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

• פותחים פרויקט קיים ב-Google Cloud במסוף Firebase, מוסיפים לו את Firebase ומאשרים את התנאים של Firebase.

הערה: אי אפשר לאשר את התנאים של Firebase באמצעות ה-CLI של Firebase, ה-API בארכיטקטורת REST או Terraform. אפשר לעשות זאת רק באמצעות מסוף Firebase, באחת מהאפשרויות שמתוארות למעלה.

חשוב: אם חתמת על גרסת אופליין של ההסכם הראשי של Google Cloud לשימוש בשירותי Firebase מסוימים באותו חשבון Google Cloud Platform, התנאים של Firebase לא חלים על השימוש שלך בשירותי Firebase האלה, והתנאים בהסכם האופליין הם אלה שמסדירים את השימוש שלך בשירותי Firebase האלה.

אילו הרשאות נדרשות כדי "להוסיף את Firebase"?

כדי "להוסיף את Firebase" לפרויקט קיים ב-Google Cloud, לחבר בפרויקט (כלומר, חשבון ראשי) צריכות להיות הרשאות ה-IAM הבאות:

• firebase.projects.update
• resourcemanager.projects.get
• serviceusage.services.enable
• serviceusage.services.get

כברירת מחדל, התפקידים "עריכה" ו"בעלים" ב-IAM כוללים את ההרשאות האלה.

למה מסוף Firebase לא מצליח לטעון רשימה של הפרויקטים הקיימים שלי ב-Google Cloud?

השאלה הנפוצה הזו רלוונטית בעיקר אם אתם מנסים "להוסיף את Firebase" לפרויקט קיים ב-Google Cloud באמצעות מסוף Firebase ויש לכם גישה לאלפי פרויקטים ב-Google Cloud.

מסוף Firebase לא נועד לטעון אלפי פרויקטים ב-Google Cloud. במקום זאת, מומלץ להשתמש ב-CLI של Firebase, ב-API בארכיטקטורת REST או ב-Terraform כדי "להוסיף את Firebase" לפרויקט הקיים ב-Google Cloud.

כדאי גם לעיין בשאלה הנפוצה "למה הפרויקט שלי ב-Firebase לא מופיע ברשימת הפרויקטים ב-Firebase?"

האם מספיק להוסיף את התווית firebase:enabled כדי להוסיף את Firebase?

לכל הפרויקטים ב-Firebase יש תווית firebase:enabled בדף IAM & Admin > Labels במסוף Google Cloud.

עם זאת, הוספה ידנית של התווית firebase:enabled לרשימת תוויות הפרויקט לא מפעילה הגדרות ושירותים ספציפיים ל-Firebase בפרויקט ב-Google Cloud. כדי לעשות את זה, צריך להוסיף את Firebase באמצעות מסוף Firebase (או, במקרים מתקדמים, באמצעות ה-CLI של Firebase,‏ Firebase Management API בארכיטקטורת REST או Terraform).

מה קורה כש "מוסיפים את Firebase" לפרויקט קיים ב-Google Cloud?

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

• הוספת התווית firebase:enabled בדף IAM & Admin > Labels במסוף Google Cloud.

• יוצר מפתח API של "דפדפן" ומגביל אותו באופן אוטומטי לממשקי API שקשורים ל-Firebase.

• יוצר את חשבונות השירות הבאים:

  • [e-mail]
  • firebase-adminsdk-random5chars@PROJECT_ID.iam.gserviceaccount.com

• מפעיל את ממשקי ה-API הבאים:

  • App Engine Admin API
  • Cloud Pub/Sub API
  • Cloud Resource Manager API
  • Cloud Runtime Configuration API
  • Cloud Testing API
  • Firebase Cloud Messaging API
  • Firebase Dynamic Links API
  • Firebase Hosting API
  • Firebase Installations API
  • Firebase Management API
  • Firebase Remote Config API
  • Firebase Remote Config Realtime API
  • Firebase Rules API
  • Identity Toolkit API
  • Token Service API

האם אפשר "להסיר את Firebase" מפרויקט?

אחרי שמוסיפים את Firebase לפרויקט קיים ב-Google Cloud, אי אפשר לבטל את הפעולה (כלומר, אי אפשר להסיר את Firebase באופן מלא מהפרויקט ב-Google Cloud).

תהליך "הוספת Firebase" מפעיל ממשקי API ושירותים לקצה העורפי שאפשר להשתמש בהם בתכונות אחרות של Google Cloud. השבתה של כל השירותים הפעילים האלה עלולה לגרום לתוצאות בלתי צפויות ולא מכוונות בגלל יחסי תלות.

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

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

האם אפשר לחסום את האפשרות "הוספת Firebase" בפרויקט קיים ב-Google Cloud?

אי אפשר לחסום את האפשרות "להוסיף את Firebase" לפרויקט קיים ב-Google Cloud, אבל אפשר לבצע את הפעולות הבאות:

להגביל את חברי הפרויקט (כלומר, חשבונות המשתמשים) שיש להם את הרשאת ה-IAM‏ firebase.projects.update, שנדרשת כדי "להוסיף את Firebase".

השלבים הבאים

• במקורות המידע הבאים אפשר לקרוא מידע נוסף על פרויקטים ב-Firebase:

  • הסבר על פרויקטים ב-Firebase – סקירה כללית קצרה של כמה מושגים חשובים שקשורים לפרויקטים ב-Firebase, כולל הקשר שלהם ל-Google Cloud וההיררכיה הבסיסית של פרויקט, האפליקציות והמשאבים שלו.

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

• כדי להתחיל להשתמש ב-Firebase באפליקציות לנייד ובאתרים, צריך לרשום את האפליקציות בפרויקט Firebase ולקשר אותן ל-Firebase: iOS+‎ | Android | אתר | Flutter | Unity | C++‎.