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

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

לפני שמתחילים

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

    • יצירת פרויקט Firebase.

    • רישום אפליקציית האינטרנט בפרויקט, וקישור האפליקציה ל-Firebase על ידי הוספת Firebase JS SDK ואובייקט ההגדרה של Firebase לאפליקציה.

  2. חשוב לוודא שפרויקט Firebase שלכם מוגדר למינוי Blaze בתשלום לפי שימוש, שנדרש לשימוש ב-Cloud Storage for Firebase. אם אתם חדשים ב-Firebase וב-Google Cloud, כדאי לבדוק אם אתם עומדים בדרישות לקבלת קרדיט של 300$לתקופת ניסיון בחינם.

יצירת קטגוריית Cloud Storage שמוגדרת כברירת מחדל

  1. במסוף Firebase, עוברים אל Databases & Storage (מסדי נתונים ואחסון) > Storage (אחסון).

    אם הפרויקט שלכם עדיין לא מוגדר לתוכנית התמחור Blaze בתשלום לפי שימוש, תתבקשו לשדרג את הפרויקט.

  2. לוחצים על שנתחיל?.

  3. בוחרים מיקום לקטגוריית ברירת המחדל.

  4. מגדירים את Firebase Security Rules לקטגוריית ברירת המחדל. במהלך הפיתוח, כדאי להגדיר את הכללים לגישה ציבורית.

  5. לוחצים על סיום.

עכשיו אפשר לראות את הדלי במסוף Firebase (צריך לעבור אל Databases & Storage > Storage > הכרטיסייה Files). פורמט ברירת המחדל של שם הקטגוריה הוא PROJECT_ID.firebasestorage.app.

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

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

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

הוספת Cloud Storage JS SDK ואתחול Cloud Storage

צריך לציין את Cloud Storage שם הקטגוריה כשמפעילים את JavaScript SDK.

אפשר למצוא את שם ה-bucket שלכם במסוף Firebase (עוברים אל Databases & Storage (מסדי נתונים ואחסון) > Storage (אחסון) > הכרטיסייה Files (קבצים)). בהתאם למועד שבו יצרתם את ה-bucket שמוגדר כברירת מחדל, שם ה-bucket יהיה באחד מהפורמטים הבאים: Cloud Storage

  • PROJECT_ID.firebasestorage.app (קטגוריית ברירת מחדל שנוצרה בספטמבר 2024 או אחריו)
  • PROJECT_ID.appspot.com (legacy default bucket created before September 2024)

מאתחלים את ה-SDK באמצעות קטע הקוד הבא:

Web 

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: 'BUCKET_NAME'
};

// Initialize Firebase
const app = initializeApp(firebaseConfig);


// Initialize Cloud Storage and get a reference to the service
const storage = getStorage(app);

Web 

import firebase from "firebase/app";
import "firebase/compat/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: 'BUCKET_NAME'
};

// Initialize Firebase
firebase.initializeApp(firebaseConfig);


// Initialize Cloud Storage and get a reference to the service
const storage = firebase.storage();

הכול מוכן לשימוש ב-Cloud Storage!

מה השלב הבא? איך יוצרים קובץ עזר מסוג Cloud Storage

הגדרה מתקדמת

יש כמה תרחישי שימוש שדורשים הגדרה נוספת:

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

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

בכל אחד מהתרחישים האלה, כדאי להשתמש בכמה דלייםCloud Storage.

מקרה השימוש השלישי שימושי אם אתם מפתחים אפליקציה, כמו Google Drive, שמאפשרת למשתמשים להתחבר לכמה חשבונות (למשל, חשבון לשימוש אישי וחשבון של מקום עבודה). אתם יכולים להשתמש במופע מותאם אישית של אפליקציית Firebase כדי לאמת כל חשבון נוסף.

שימוש בכמה קטגוריות Cloud Storage

אם רוצים להשתמש בקטגוריית Cloud Storage שונה מקטגוריית ברירת המחדל שמתוארת בהמשך המדריך הזה, או להשתמש בכמה קטגוריות Cloud Storage באפליקציה אחת, אפשר ליצור מופע של firebase.storage שמפנה לקטגוריה בהתאמה אישית:

Web

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

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

עבודה עם קטגוריות מיובאות

כשמייבאים 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://BUCKET_NAME

אפשר למצוא את מספר הפרויקט כמו שמתואר במאמר המבוא לפרויקטים ב-Firebase.

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

שימוש באפליקציית Firebase מותאמת אישית

אם אתם בונים אפליקציה מורכבת יותר באמצעות firebase.app.App מותאם אישית, אתם יכולים ליצור מופע של firebase.storage.Storage שמאותחל עם האפליקציה הזו:

Web

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

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

השלבים הבאים