Cloud Storage for Firebase позволяет загружать и публиковать пользовательский контент, например изображения и видео, что позволяет встраивать мультимедийный контент в ваши приложения. Ваши данные хранятся в корзине Google Cloud Storage — решении для хранения объектов эксабайтного масштаба с высокой доступностью и глобальной избыточностью. Cloud Storage for Firebase позволяет безопасно загружать эти файлы непосредственно с мобильных устройств и веб-браузеров, с легкостью обрабатывая нестабильные сети.
Прежде чем начать
Если вы еще этого не сделали, обязательно ознакомьтесь с руководством по началу работы с веб-приложениями . Это включает в себя:
Создание проекта Firebase.
Регистрация вашего веб-приложения в проекте и подключение вашего приложения к Firebase путем добавления Firebase JS SDK и объекта конфигурации Firebase в ваше приложение.
Убедитесь, что ваш проект Firebase включен в тарифный план Blaze с оплатой по факту использования . Если вы новичок в Firebase и Google Cloud, проверьте, имеете ли вы право на получение кредита в размере 300 долларов США .
Создайте сегмент Cloud Storage по умолчанию.
На панели навигации консоли Firebase выберите Storage . Если ваш проект еще не включен в тарифный план Blaze с оплатой по мере использования, вам будет предложено обновить проект. Нажмите « Начать» . Выберите местоположение для корзины по умолчанию. Ведра в US-CENTRAL1
,US-EAST1
иUS-WEST1
может воспользоваться уровнем «Всегда бесплатно» для Google Cloud Storage . Во всех остальных местах сегменты соответствуют ценам и использованию Google Cloud Storage .При желании позже вы сможете создать несколько сегментов , каждый из которых будет иметь свое собственное местоположение.
Настройте Firebase Security Rules для корзины по умолчанию. Во время разработки рассмотрите возможность настройки правил публичного доступа . Нажмите Готово .
PROJECT_ID .firebasestorage.app
.
Настройте общий доступ
Добавьте Cloud Storage JS SDK и инициализируйте Cloud Storage .
PROJECT_ID .firebasestorage.app
(корзина по умолчанию, созданная30 октября 2024 г. или после этой даты)PROJECT_ID .appspot.com
(корзина по умолчанию, созданная до30 октября 2024 г. )
Инициализируйте SDK, используя следующий фрагмент кода:
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);
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 .
Расширенная настройка
Есть несколько случаев использования, которые требуют дополнительной настройки:
- Использование сегментов Cloud Storage в нескольких географических регионах
- Использование сегментов Cloud Storage в разных классах хранилища
- Использование сегментов Cloud Storage с несколькими аутентифицированными пользователями в одном приложении.
Первый вариант использования идеален, если у вас есть пользователи по всему миру и вы хотите хранить их данные рядом с ними. Например, вы можете создать сегменты в США, Европе и Азии для хранения данных пользователей в этих регионах, чтобы уменьшить задержку.
Второй вариант использования полезен, если у вас есть данные с разными шаблонами доступа. Например: вы можете настроить мультирегиональную или региональную корзину, в которой хранятся изображения или другой часто доступный контент, а также корзину ближней или холодной линии, в которой хранятся резервные копии пользователей или другой контент, к которому редко обращаются.
В любом из этих случаев вам понадобится использовать несколько сегментов 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");
// Get a non-default Storage bucket var storage = firebase.app().storage("gs://my-custom-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
, инициализированный с помощью этого приложения:
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");
// 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");
Следующие шаги
Подготовьтесь к запуску приложения:
Включите App Check , чтобы гарантировать, что только ваши приложения смогут получить доступ к вашим сегментам хранилища.
Настройте оповещения о бюджете для своего проекта в консоли Google Cloud .
Отслеживайте панель «Использование и выставление счетов» в консоли Firebase , чтобы получить общую картину использования вашего проекта в нескольких сервисах Firebase. Вы также можете посетить панель мониторинга использования Cloud Storage для получения более подробной информации об использовании.
Ознакомьтесь с контрольным списком запуска Firebase .