פרויקט 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 מסוף
נכנסים למסוף Firebase.
נכנסים לאותו חשבון Google שמאפשר לכם לגשת לפרויקט Google Cloud הקיים.
לוחצים על Create a project.
בתחתית הדף, לוחצים על הקישור כבר יש לכם פרויקט ב-Google Cloud?
בשדה הטקסט, מתחילים להזין את מזהה הפרויקט הקיים ואז בוחרים את הפרויקט מהרשימה שמוצגת.
לוחצים על Open project.
אם מופיעה בקשה, מאשרים את התנאים של Firebase.
פועלים לפי ההוראות במסך כדי 'להוסיף את Firebase' ולהגדיר פרויקט Firebase.
הערה: הפעלת Google Analytics היא אופציונלית.
Firebase CLI
אם עדיין לא עשיתם זאת, מתקינים את CLI של Firebase.
נכנסים לאותו חשבון Google שמאפשר לכם לגשת לפרויקט Google Cloud הקיים.
מריצים את הפקודה הבאה:
firebase projects:addfirebase
כשמוצגת בקשה, בוחרים את הפרויקט הקיים של Google Cloud מהרשימה שמוצגת.
אם עדיין לא אישרתם את התנאים של Firebase, עליכם לפתוח פרויקט ב-Firebase במסוף Firebase כדי לאשר את התנאים. מידע נוסף על הדרישה להסכמה לתנאים של Firebase זמין בתשובות לשאלות הנפוצות האלה.
API ל-REST
מפעילים את Firebase Management API בפרויקט Google Cloud הקיים.
יוצרים את אסימון הגישה ל-API.
מפעילים את שירותי Firebase בפרויקט באמצעות קריאה ל-
projects.addFirebase.לתשומת ליבכם: כדי לבצע את הקריאה הזו, תצטרכו את שם המשאב של הפרויקט.
אם עדיין לא אישרתם את התנאים של Firebase, עליכם לפתוח פרויקט ב-Firebase במסוף Firebase כדי לאשר את התנאים. מידע נוסף על הדרישה להסכמה לתנאים של Firebase זמין בתשובות לשאלות הנפוצות האלה.
להוראות מפורטות, ראו הוספת שירותי Firebase לפרויקט במדריך Firebase: 'הגדרה וניהול של פרויקט Firebase באמצעות Management REST API'. חשוב לפעול לפי כל ההוראות בקטע לפני שמתחילים במדריך הזה.
Terraform
מפעילים את Firebase Management API (
firebase.googleapis.com) בפרויקט הקיים Google Cloud.מפעילים את שירותי Firebase בפרויקט באמצעות המשאב
google_firebase_project.אם עדיין לא אישרתם את התנאים של Firebase, עליכם לפתוח פרויקט ב-Firebase במסוף Firebase כדי לאשר את התנאים. מידע נוסף על הדרישה להסכמה לתנאים של Firebase זמין בתשובות לשאלות הנפוצות האלה.
למידע מפורט על השימוש ב-Firebase וב-Terraform, תוכלו לקרוא את המאמר תחילת העבודה עם Terraform ו-Firebase.
שאלות נפוצות ופתרון בעיות
השלבים הבאים
מידע נוסף על פרויקטים ב-Firebase זמין במקורות המידע הבאים:
הסבר על פרויקטים ב-Firebase – כאן מפורטות סקירות קצרות של כמה מושגים חשובים לגבי פרויקטים ב-Firebase, כולל הקשר שלהם ל-Google Cloud וההיררכיה הבסיסית של פרויקט, האפליקציות והמשאבים שלו.
שיטות מומלצות כלליות להגדרת פרויקטים ב-Firebase – כאן מפורטות שיטות מומלצות כלליות ברמה גבוהה להגדרת פרויקטים ב-Firebase ולרישום האפליקציות בפרויקט, כדי שתהיה לכם תהליך פיתוח ברור שמשתמש בסביבות נפרדות.
כדי להתחיל להשתמש ב-Firebase באפליקציות לנייד ולאינטרנט, צריך לרשום את האפליקציות בפרויקט Firebase ולקשר אותן ל-Firebase: iOS+ | Android | אינטרנט | Flutter | Unity | C++.