תחילת השימוש ב-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 Console.

• אפשר ליצור אינטראקציה עם הפרויקט באמצעות Firebase CLI,‏ 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 באמצעות החשבון שדרכו יש לכם גישה לפרויקט Google Cloud הקיים.

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

3. בתחתית הדף, לוחצים על הוספת Firebase לפרויקט Google Cloud.

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

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

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

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

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

‫Firebase CLI

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

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" לפרויקט Google Cloud קיים, צריך גם לאשר את התנאים וההגבלות של Firebase.

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

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

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

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

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

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

.

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

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

מה קורה כשמוסיפים את 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 קיים, אבל אפשר לעשות את הפעולות הבאות:

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

השלבים הבאים

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

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

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

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