התחל עם Cloud Storage באינטרנט

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

דרישות מוקדמות

אם עדיין לא עשית זאת, התקן את Firebase JS SDK ואתחל את Firebase .

צור דלי ברירת מחדל של Cloud Storage

1. מחלונית הניווט של מסוף Firebase , בחר אחסון ולאחר מכן לחץ על התחל .

2. עיין בהודעות על אבטחת נתוני Cloud Storage שלך ​​באמצעות כללי אבטחה. במהלך הפיתוח, שקול להגדיר את הכללים שלך לגישה ציבורית .

3. בחר מיקום עבור דלי ברירת המחדל של Cloud Storage.

   • הגדרת מיקום זו היא מיקום המשאב המוגדר כברירת מחדל של הפרויקט שלך ב-Google Cloud Platform (GCP) . שים לב שמיקום זה ישמש עבור שירותי GCP בפרויקט שלך הדורשים הגדרת מיקום, במיוחד מסד הנתונים שלך ב- Cloud Firestore ואפליקציית App Engine שלך ​​(שנדרשת אם אתה משתמש ב-Cloud Scheduler).

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

   אם אתה בתוכנית Blaze, אתה יכול ליצור דליים מרובים , לכל אחד מיקום משלו.

4. לחץ על סיום .

הגדר גישה ציבורית

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

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

הוסף את כתובת האתר של הדלי שלך לאפליקציה שלך

אם זה לא כלול כבר, עליך להוסיף את כתובת האתר של דלי Cloud Storage לאובייקט התצורה של אפליקציית Firebase שלך.

1. עבור אל לוח המחוונים של האחסון שלך במסוף Firebase .

2. לחץ על הכרטיסייה קבצים ולאחר מכן חפש בכותרת של מציג הקבצים.

3. העתק את כתובת האתר ללוח שלך. זה בדרך כלל בצורת project-id .appspot.com .

4. לאובייקט firebaseConfig שלך באפליקציה שלך, הוסף את התכונה storageBucket עם כתובת האתר של הדלי שלך:

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);

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 המתייחס לדלי המותאם אישית שלך:

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");
storage_multiple_buckets.js

// Get a non-default Storage bucket
var storage = firebase.app().storage("gs://my-custom-bucket");
index.js

עבודה עם דליים מיובאים

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

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");
storage_custom_app.js

// 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");
index.js

הצעדים הבאים

• היכונו להפעלת האפליקציה שלכם:

  • הפעל App Check כדי להבטיח שרק האפליקציות שלך יכולות לגשת לדלי האחסון שלך.

  • הגדר התראות תקציב עבור הפרויקט שלך ב-Google Cloud Console.

  • עקוב אחר לוח המחוונים של השימוש והחיובים במסוף Firebase כדי לקבל תמונה כוללת של השימוש בפרויקט שלך בשירותי Firebase מרובים. אתה יכול גם לבקר בלוח המחוונים של Cloud Storage Usage לקבלת מידע שימוש מפורט יותר.

  • עיין ברשימת המשימות להפעלת Firebase .