Catch up on everthing we announced at this year's Firebase Summit. Learn more

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

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

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

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

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

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

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

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

    • הגדרת המיקום זהו הפרויקט שלך בפלטפורמת הענן של Google מחדל מיקום משאב (GCP) . שים לב שמיקום זה ישמש עבור שירותים GCP בפרויקט שלך הדורשים הגדרת המיקום, במיוחד, שלך ענן Firestore מסד הנתונים שלך מנוע יישום האפליקציה (נדרש אם אתה משתמש ענן מתזמן).

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

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

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

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

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

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

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

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

  1. עברתי למרכז השליטה החפצה שלך קונסולת Firebase .

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

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

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

    גרסת אינטרנט 9

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

    גרסת אינטרנט 8

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

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

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

התקנה מתקדמת

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

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

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

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

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

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

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

גרסת אינטרנט 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");

גרסת אינטרנט 8

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

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

בעת יבוא קובץ דלי אחסון הענן קיים לתוך 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 אותחל עם אותה אפליקציה:

גרסת אינטרנט 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");

גרסת אינטרנט 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");

הצעדים הבאים