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

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

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

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

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

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

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

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

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

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

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

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

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

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

    firebase projects:addfirebase

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

תפקידי ה-IAM‏ Editor ו-Owner כוללים את ההרשאות האלה כברירת מחדל.

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

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

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

  • התווית firebase:enabled נוספת בדף Labels במסוף Google Cloud.

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

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

    • service-PROJECT_NUMBER@gcp-sa-firebase.iam.gserviceaccount.com
    • 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 לפרויקט Google Cloud קיים, אי אפשר לבטל את הפעולה הזו (כלומר, אי אפשר להסיר את Firebase מהפרויקט Google Cloud באופן מלא).

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

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

אי אפשר למנוע את האפשרות של 'הוספת Firebase' לפרויקט Google Cloud קיים, אבל אפשר לעשות את הפעולות הבאות:

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

השלבים הבאים

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

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

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

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