Check out what’s new from Firebase@ Google I/O 2021, and join our alpha program for early access to the new Remote Config personalization feature. Learn more

התחל בעבודה עם אחסון בענן באינטרנט

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

תנאים מוקדמים

הוסף והגדר את ה- SDK של Firebase לאפליקציה שלך.

צור דלי ברירת מחדל של ענן אחסון

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

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

  3. בחר מיקום עבור דלי ברירת המחדל של אחסון בענן.

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

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

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

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

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

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

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

הוסף את כתובת ה- bucket שלך לאפליקציה שלך

אם הוא כבר לא נכלל, עליך להוסיף את כתובת ה- URL של דלי אחסון בענן לאובייקט התצורה של אפליקציית Firebase שלך.

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

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

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

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

    אינטרנט v8

    // Set the configuration for your app
    // TODO: Replace with your app's config object
    var firebaseConfig = {
      apiKey: '<your-api-key>',
      authDomain: '<your-auth-domain>',
      databaseURL: '<your-database-url>',
      storageBucket: '<your-storage-bucket-url>'
    };
    firebase.initializeApp(firebaseConfig);
    
    // Get a reference to the storage service, which is used to create references in your storage bucket
    var storage = firebase.storage();

    אינטרנט v9

    import { initializeApp } from "firebase/app";
    import { getStorage } from "firebase/storage";
    
    // Set the configuration for your app
    // TODO: Replace with your app's config object
    const firebaseConfig = {
      apiKey: '<your-api-key>',
      authDomain: '<your-auth-domain>',
      databaseURL: '<your-database-url>',
      storageBucket: '<your-storage-bucket-url>'
    };
    const firebaseApp = initializeApp(firebaseConfig);
    
    // Get a reference to the storage service, which is used to create references in your storage bucket
    const storage = getStorage(firebaseApp);

אתה מוכן להתחיל להשתמש בענן אחסון!

השלב הבא? למד כיצד ליצור הפניה לאחסון ענן .

התקנה מתקדמת

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

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

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

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

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

השתמש במספר דליים של אחסון בענן

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

אינטרנט v8

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

אינטרנט v9

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

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

בעת ייבוא ​​דלי אחסון ענן קיימים ל- Firebase, יהיה עליך להעניק ל- Firebase את האפשרות לגשת לקבצים אלה באמצעות הכלי gsutil , הכלול ב- SDK של Google Cloud :

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 מאותחל לאפליקציה זו:

אינטרנט v8

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

אינטרנט v9

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

הצעדים הבאים