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

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

כשאתם מוסיפים את Firebase לפרויקט Google Cloud, מערכת Firebase מפעילה באופן אוטומטי כמה ממשקי API ויוצרת חשבונות שירות כדי לפשט את השימוש בכל השירותים והממשקים של Firebase. מערכת Firebase גם מוסיפה לפרויקט תווית firebase:enabled בדף 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 מסוף

1. נכנסים למסוף Firebase.

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

3. לוחצים על Create a project.

4. בתחתית הדף, לוחצים על הקישור כבר יש לכם פרויקט ב-Google Cloud?

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

6. לוחצים על Open project.

7. אם מופיעה בקשה, מאשרים את התנאים של Firebase.

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

הערה: אם מופיעה הודעת השגיאה 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 כדי 'להוסיף את Firebase' לפרויקט Google Cloud קיים.

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

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

• יוצרים פרויקט Firebase חדש באמצעות מסוף Firebase.

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

• פותחים Google Cloud קיים במסוף Firebase ומבצעים add Firebase.

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

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

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

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

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

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

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

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

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

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

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

• הוספת התווית firebase:enabled בדף 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 קיים, אבל אפשר לבצע את הפעולות הבאות:

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

השלבים הבאים

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

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

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

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