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

با Cloud Storage در وب شروع کنید

فضای ذخیره سازی ابری برای Firebase به شما امکان می دهد محتوای ایجاد شده توسط کاربر ، مانند تصاویر و ویدئو را بارگذاری و به اشتراک بگذارید ، که به شما امکان می دهد محتوای رسانه غنی را در برنامه های خود ایجاد کنید. اطلاعات شما در یک ذخیره می شود گوگل ابر ذخیره سازی راه حل ذخیره سازی جسم در مقیاس اگزابایت با در دسترس بودن بالا و افزونگی جهانی - سطل. فضای ذخیره سازی ابری برای Firebase به شما امکان می دهد این فایل ها را مستقیماً از دستگاه های تلفن همراه و مرورگرهای وب بارگذاری کنید و به راحتی با شبکه های لکه دار کار کنید.

پیش نیازها

اضافه کردن و پیکربندی فایربیس SDK به برنامه شما.

یک سطل ذخیره سازی پیش فرض Cloud Storage ایجاد کنید

  1. از پیمایش از فایربیس کنسول ، ذخیره سازی را انتخاب کنید، سپس با کلیک آغاز شده است.

  2. پیام های مربوط به امنیت داده های Cloud Storage خود را با استفاده از قوانین امنیتی مرور کنید. در طول توسعه، در نظر راه اندازی قوانین خود را برای دسترسی عموم مردم .

  3. یک SELECT محل برای پیش فرض سطل ابر ذخیره سازی خود را.

    • این تنظیم محل پروژه شما است محل منابع پلتفرم ابری گوگل (GCP) به طور پیش فرض . توجه داشته باشید که این مکان خواهد شد برای خدمات GCP در پروژه خود که نیاز به تنظیم محل، به طور خاص، خود را مورد استفاده قرار ابر Firestore پایگاه داده و خود را موتور برنامه برنامه (که مورد نیاز است در صورت استفاده از ابر زمانبند).

    • اگر نمی توانید مکانی را انتخاب کنید ، پروژه شما از قبل دارای موقعیت منبع پیش فرض GCP است. یا هنگام ایجاد پروژه یا هنگام راه اندازی سرویس دیگری که نیاز به تنظیم موقعیت مکانی دارد تنظیم شد.

    اگر شما بر روی طرح فروغ، شما می توانید سطل های متعدد ایجاد ، هر کدام با خود را به محل .

  4. کلیک کنید انجام می شود.

راه اندازی دسترسی عمومی

Cloud Storage for Firebase یک زبان قوانین اعلان کننده را ارائه می دهد که به شما امکان می دهد نحوه ساختار داده های خود ، نحوه نمایه سازی آنها و زمان خواندن و نوشتن داده های شما را تعیین کنید. به طور پیش فرض ، دسترسی به خواندن و نوشتن به Cloud Storage محدود است ، بنابراین فقط کاربران تأیید شده می توانند داده ها را بخوانند یا بنویسند. برای شروع بدون راه اندازی احراز هویت ، شما می توانید قوانین خود را برای دسترسی عموم پیکربندی .

این باعث می شود فضای ذخیره سازی ابری برای همه باز شود ، حتی افرادی که از برنامه شما استفاده نمی کنند ، بنابراین هنگام تنظیم احراز هویت ، مجدداً Cloud Storage خود را محدود کنید.

URL سطل خود را به برنامه خود اضافه کنید

اگر آن را شامل نمی در حال حاضر، شما نیاز به اضافه کردن URL سطل ابر ذخیره سازی خود را به شما شیء پیکربندی برنامه فایربیس است .

  1. برو به داشبورد ذخیره سازی خود را در کنسول فایربیس .

  2. کلیک بر روی زبانه فایل ها، سپس در هدر فایل بیننده است.

  3. URL را در کلیپ بورد خود کپی کنید. این معمولا در قالب project-id .appspot.com .

  4. برای خود firebaseConfig شی در برنامه شما، اضافه کردن storageBucket ویژگی با URL سطل خود را:

    نسخه وب 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();

شما آماده شروع استفاده از Cloud Storage هستید!

گام بعدی؟ یاد بگیرید چگونه به ایجاد یک مرجع ابر ذخیره سازی .

تنظیمات پیشرفته

چند مورد استفاده وجود دارد که نیاز به راه اندازی اضافی دارد:

اگر کاربرانی در سراسر جهان دارید و می خواهید داده های آنها را در نزدیکی آنها ذخیره کنید ، اولین مورد استفاده کامل است. به عنوان مثال ، می توانید سطل هایی در ایالات متحده ، اروپا و آسیا ایجاد کنید تا داده ها را برای کاربران آن مناطق ذخیره کنید تا تاخیر را کاهش دهید.

اگر داده هایی با الگوهای دسترسی متفاوت دارید ، مورد استفاده دوم مفید است. به عنوان مثال: می توانید سطل چند منطقه ای یا منطقه ای ایجاد کنید که تصاویر یا سایر محتوای مورد دسترسی را ذخیره می کند و یک سطل نزدیک خط یا خط سرد که پشتیبان گیری کاربر یا سایر محتوای نادر دسترسی را ذخیره می کند.

در هر کدام از این موارد استفاده، شما می خواهید به استفاده از چند سطل ابر ذخیره سازی .

سومین مورد استفاده اگر شما در حال ساخت برنامه ای مانند Google Drive هستید ، که به کاربران اجازه می دهد چندین حساب کاربری وارد شده (به عنوان مثال ، یک حساب شخصی و یک حساب کار) ایجاد کنند ، مفید است. شما می توانید سفارشی فایربیس برنامه استفاده کنید به عنوان مثال به اعتبار هر یک از حساب های اضافی.

از چندین سطل ذخیره سازی ابری استفاده کنید

اگر شما می خواهید به استفاده از ذخیره سازی ابر سطل دیگر از پیش فرض ارائه شده در بالا، یا استفاده از چندین سطل ابر ذخیره سازی در یک برنامه واحد، شما می توانید یک نمونه از ایجاد 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");

کار با سطل های وارداتی

هنگام وارد کردن موجود سطل ابر ذخیره سازی به فایربیس، شما باید به اعطای فایربیس توانایی دسترسی به این فایل ها با استفاده از gsutil ابزار، از جمله در گوگل ابر SDK :

gsutil -m acl ch -r -u service-<project number>@gcp-sa-firebasestorage.iam.gserviceaccount.com gs://<your-cloud-storage-bucket>

شما می توانید تعداد پروژه خود را همانطور که در توصیف پیدا معرفی به پروژه های فایربیس .

این بر سطل های تازه ایجاد شده تأثیر نمی گذارد ، زیرا آنها دارای کنترل دسترسی پیش فرض هستند که به 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");

مراحل بعدی