Cloud Storage for Firebase מאפשר לך להעלות ולשתף תוכן שנוצר על ידי משתמשים, כגון תמונות ווידאו, מה שמאפשר לך לבנות תוכן מדיה עשירה באפליקציות שלך. הנתונים שלך מאוחסנים בדלי של Google Cloud Storage - פתרון אחסון אובייקטים בקנה מידה של אקסבייטים עם זמינות גבוהה ויתירות גלובלית. Cloud Storage for Firebase מאפשר לך להעלות את הקבצים האלה בצורה מאובטחת ישירות ממכשירים ניידים ומדפדפני אינטרנט, תוך טיפול בקלות ברשתות נקודתיות.
דרישות מוקדמות
אם עדיין לא עשית זאת, התקן את Firebase JS SDK ואתחל את Firebase .
צור דלי ברירת מחדל של Cloud Storage
מחלונית הניווט של מסוף Firebase , בחר אחסון ולאחר מכן לחץ על התחל .
עיין בהודעות על אבטחת נתוני Cloud Storage שלך באמצעות כללי אבטחה. במהלך הפיתוח, שקול להגדיר את הכללים שלך לגישה ציבורית .
בחר מיקום עבור דלי ברירת המחדל של Cloud Storage.
הגדרת מיקום זו היא מיקום המשאב של ברירת המחדל של הפרויקט שלך ב-Google Cloud Platform (GCP) . שים לב שמיקום זה ישמש עבור שירותי GCP בפרויקט שלך הדורשים הגדרת מיקום, במיוחד מסד הנתונים שלך ב- Cloud Firestore ואפליקציית App Engine שלך (שנדרשת אם אתה משתמש ב-Cloud Scheduler).
אם אינך יכול לבחור מיקום, אז לפרויקט שלך כבר יש מיקום ברירת מחדל של משאב GCP. הוא הוגדר במהלך יצירת הפרויקט או בעת הגדרת שירות אחר הדורש הגדרת מיקום.
אם אתה בתוכנית Blaze, אתה יכול ליצור דליים מרובים , לכל אחד עם מיקום משלו.
לחץ על בוצע .
הגדר גישה ציבורית
Cloud Storage for Firebase מספק שפת חוקים הצהרתית המאפשרת לך להגדיר כיצד הנתונים שלך צריכים להיות מובנים, כיצד יש להוסיף אותם לאינדקס ומתי ניתן לקרוא את הנתונים שלך ולכתוב אליהם. כברירת מחדל, גישת קריאה וכתיבה ל-Cloud Storage מוגבלת כך שרק משתמשים מאומתים יכולים לקרוא או לכתוב נתונים. כדי להתחיל מבלי להגדיר אימות , אתה יכול להגדיר את הכללים שלך לגישה ציבורית .
זה הופך את אחסון הענן פתוח לכל אחד, אפילו לאנשים שאינם משתמשים באפליקציה שלך, אז הקפד להגביל שוב את אחסון הענן שלך כשאתה מגדיר אימות.
הוסף את כתובת ה-bucket שלך לאפליקציה שלך
אם זה לא כלול כבר, עליך להוסיף את כתובת האתר של דלי Cloud Storage לאובייקט התצורה של אפליקציית Firebase שלך.
עבור אל לוח המחוונים של האחסון שלך במסוף Firebase .
לחץ על הכרטיסייה קבצים ולאחר מכן חפש בכותרת של מציג הקבצים.
העתק את כתובת האתר ללוח שלך. זה בדרך כלל בצורת
project-id .appspot.com
.לאובייקט
firebaseConfig
שלך באפליקציה שלך, הוסף את התכונהstorageBucket
עם כתובת האתר של הדלי שלך:
Web version 9
import { initializeApp } from "firebase/app"; import { getStorage } from "firebase/storage"; // TODO: Replace the following with your app's Firebase project configuration // See: https://firebase.google.com/docs/web/learn-more#config-object const firebaseConfig = { // ... storageBucket: '' }; // Initialize Firebase const app = initializeApp(firebaseConfig); // Initialize Cloud Storage and get a reference to the service const storage = getStorage(app);
Web version 8
import firebase from "firebase/app"; import "firebase/storage"; // TODO: Replace the following with your app's Firebase project configuration // See: https://firebase.google.com/docs/web/learn-more#config-object const firebaseConfig = { // ... storageBucket: '[your-storage-bucket-url]' }; // Initialize Firebase firebase.initializeApp(firebaseConfig); // Initialize Cloud Storage and get a reference to the service const storage = firebase.storage();
אתה מוכן להתחיל להשתמש ב-Cloud Storage!
השלב הבא? למד כיצד ליצור הפניה לאחסון בענן .
התקנה מתקדמת
ישנם כמה מקרי שימוש הדורשים הגדרה נוספת:
- שימוש בדליים של Cloud Storage באזורים גיאוגרפיים מרובים
- שימוש בדליים של Cloud Storage במחלקות אחסון שונות
- שימוש בדליים של Cloud Storage עם מספר משתמשים מאומתים באותה אפליקציה
מקרה השימוש הראשון מושלם אם יש לך משתמשים ברחבי העולם, ואתה רוצה לאחסן את הנתונים שלהם בקרבתם. לדוגמה, אתה יכול ליצור דליים בארה"ב, אירופה ואסיה כדי לאחסן נתונים עבור משתמשים באזורים אלה כדי להפחית את זמן האחזור.
מקרה השימוש השני מועיל אם יש לך נתונים עם דפוסי גישה שונים. לדוגמה: אתה יכול להגדיר דלי רב-אזורי או אזורי המאחסן תמונות או תוכן אחר הנגיש לעתים קרובות, ו-nearline או דלי קולד המאחסן גיבויים של משתמשים או תוכן אחר שנגיש לעתים רחוקות.
בכל אחד ממקרי השימוש האלה, תרצה להשתמש במספר דליים של Cloud Storage .
מקרה השימוש השלישי שימושי אם אתה בונה אפליקציה, כמו Google Drive, המאפשרת למשתמשים להחזיק במספר חשבונות מחוברים (לדוגמה, חשבון אישי וחשבון עבודה). אתה יכול להשתמש במופע מותאם אישית של אפליקציית Firebase כדי לאמת כל חשבון נוסף.
השתמש במספר דליים של Cloud Storage
אם אתה רוצה להשתמש בדלי של Cloud Storage שאינו ברירת המחדל שצוינה למעלה, או להשתמש במספר דליים של Cloud Storage באפליקציה אחת, תוכל ליצור מופע של firebase.storage
לדלי המותאם אישית שלך:
Web version 9
import { getApp } from "firebase/app"; import { getStorage } from "firebase/storage"; // Get a non-default Storage bucket const firebaseApp = getApp(); const storage = getStorage(firebaseApp, "gs://my-custom-bucket");
Web version 8
// Get a non-default Storage bucket var storage = firebase.app().storage("gs://my-custom-bucket");
עבודה עם דליים מיובאים
כאשר מייבאים דלי Cloud Storage קיים ל-Firebase, תצטרך להעניק ל-Firebase את היכולת לגשת לקבצים האלה באמצעות הכלי gsutil
, הכלול ב- Google Cloud SDK :
gsutil -m acl ch -r -u service-<project number>@gcp-sa-firebasestorage.iam.gserviceaccount.com gs://<your-cloud-storage-bucket>
תוכל למצוא את מספר הפרויקט שלך כפי שמתואר במבוא לפרויקטים של Firebase .
זה לא משפיע על דליים חדשים שנוצרו, מכיוון שלאלה יש את בקרת הגישה המוגדרת כברירת מחדל כדי לאפשר את Firebase. זוהי פעולה זמנית, והיא תתבצע אוטומטית בעתיד.
השתמש באפליקציית Firebase מותאמת אישית
אם אתה בונה אפליקציה מסובכת יותר באמצעות firebase.app.App
מותאם אישית, אתה יכול ליצור מופע של firebase.storage.Storage
שאותחל עם אותה אפליקציה:
Web version 9
import { getStorage } from "firebase/storage"; // Get the default bucket from a custom firebase.app.App const storage1 = getStorage(customApp); // Get a non-default bucket from a custom firebase.app.App const storage2 = getStorage(customApp, "gs://my-custom-bucket");
Web version 8
// Get the default bucket from a custom firebase.app.App var storage = customApp.storage(); // Get a non-default bucket from a custom firebase.app.App var storage = customApp.storage("gs://my-custom-bucket");
הצעדים הבאים
היכונו להפעלת האפליקציה שלכם:
הפעל App Check כדי להבטיח שרק האפליקציות שלך יכולות לגשת לדלי האחסון שלך.
הגדר התראות תקציב עבור הפרויקט שלך ב-Google Cloud Console.
עקוב אחר לוח המחוונים של השימוש והחיובים במסוף Firebase כדי לקבל תמונה כוללת של השימוש בפרויקט שלך בשירותי Firebase מרובים. אתה יכול גם לבקר בלוח המחוונים של Cloud Storage Usage לקבלת מידע שימוש מפורט יותר.