Cloud Storage for Firebase cho phép bạn tải lên và chia sẻ nội dung do người dùng tạo, chẳng hạn như hình ảnh và video, cho phép bạn tạo nội dung đa phương tiện phong phú trong ứng dụng. Dữ liệu của bạn được lưu trữ trong một bộ chứa Google Cloud Storage – một giải pháp lưu trữ đối tượng ở quy mô exabyte với khả năng hoạt động cao và dự phòng toàn cầu. Cloud Storage for Firebase cho phép bạn tải các tệp này lên một cách an toàn ngay từ thiết bị di động và trình duyệt web, dễ dàng xử lý các mạng không ổn định.
Trước khi bắt đầu
Hãy nhớ hoàn tất hướng dẫn bắt đầu sử dụng cho ứng dụng web nếu bạn chưa thực hiện. Chẳng hạn như:
Tạo dự án Firebase.
Đăng ký ứng dụng web của bạn với dự án và kết nối ứng dụng với Firebase bằng cách thêm SDK JS Firebase và đối tượng cấu hình Firebase vào ứng dụng.
Đảm bảo dự án Firebase của bạn đang sử dụng gói giá linh hoạt trả theo mức sử dụng Blaze. Nếu bạn mới sử dụng Firebase và Google Cloud, hãy kiểm tra xem bạn có đủ điều kiện nhận khoản tín dụng trị giá 300 USD hay không.
Tạo bộ chứa Cloud Storage mặc định
Trong ngăn điều hướng của bảng điều khiển Firebase, hãy chọn Bộ nhớ.
Nếu dự án của bạn chưa sử dụng gói giá linh hoạt Blaze (thanh toán theo mức sử dụng), bạn sẽ được nhắc nâng cấp dự án.
Nhấp vào Bắt đầu.
Chọn một vị trí cho bộ chứa mặc định.
Các bộ chứa trong
,US-CENTRAL1
vàUS-EAST1
có thể tận dụng cấp"Luôn miễn phí" cho Google Cloud Storage. Các bộ chứa ở tất cả các vị trí khác tuân theo giá và mức sử dụng của Google Cloud Storage.US-WEST1
Sau này, nếu muốn, bạn có thể tạo nhiều bộ chứa, mỗi bộ chứa có một vị trí riêng.
Định cấu hình Firebase Security Rules cho bộ chứa mặc định. Trong quá trình phát triển, hãy cân nhắc thiết lập quy tắc cho quyền truy cập công khai.
Nhấp vào Xong.
Giờ đây, bạn có thể xem bộ chứa trong thẻ Cloud Storage Tệp của bảng điều khiển Firebase. Định dạng tên bộ chứa mặc định là PROJECT_ID.firebasestorage.app
Thiết lập quyền truy cập công khai
Cloud Storage for Firebase cung cấp một ngôn ngữ quy tắc khai báo cho phép bạn xác định cách cấu trúc dữ liệu, cách lập chỉ mục dữ liệu và thời điểm có thể đọc và ghi dữ liệu. Theo mặc định, quyền đọc và ghi vào Cloud Storage bị hạn chế nên chỉ những người dùng đã xác thực mới có thể đọc hoặc ghi dữ liệu. Để bắt đầu mà không cần thiết lập Authentication, bạn có thể định cấu hình quy tắc cho quyền truy cập công khai.
Điều này khiến Cloud Storage mở cho mọi người, ngay cả những người không sử dụng ứng dụng của bạn, vì vậy, hãy nhớ hạn chế lại Cloud Storage khi bạn thiết lập quy trình xác thực.
Thêm SDK JS Cloud Storage và khởi chạy Cloud Storage
Bạn phải chỉ định tên bộ chứa Cloud Storage khi khởi chạy SDK JavaScript.
Bạn có thể tìm thấy tên bộ chứa Cloud Storage trong thẻ Tệp của Cloud Storage trên bảng điều khiển Firebase. Tuỳ thuộc vào thời điểm bạn tạo bộ chứa mặc định, tên bộ chứa sẽ có một trong các định dạng sau:
(vùng chứa mặc định được tạo từ ngàyPROJECT_ID.firebasestorage.app
30 tháng 10 năm 2024 ) (vùng chứa mặc định được tạo trướcPROJECT_ID.appspot.com
ngày 30 tháng 10 năm 2024 )
Khởi chạy SDK bằng đoạn mã sau:
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();
Bạn đã sẵn sàng bắt đầu sử dụng Cloud Storage!
Bước tiếp theo? Tìm hiểu cách tạo tệp đối chiếu Cloud Storage.
Thiết lập nâng cao
Có một số trường hợp sử dụng yêu cầu thiết lập thêm:
- Sử dụng các bộ chứa Cloud Storage ở nhiều khu vực địa lý
- Sử dụng các bộ chứa Cloud Storage trong các lớp bộ nhớ khác nhau
- Sử dụng các bộ chứa Cloud Storage có nhiều người dùng đã xác thực trong cùng một ứng dụng
Trường hợp sử dụng đầu tiên là hoàn hảo nếu bạn có người dùng trên khắp thế giới và muốn lưu trữ dữ liệu của họ ở gần họ. Ví dụ: bạn có thể tạo các bộ chứa ở Hoa Kỳ, Châu Âu và Châu Á để lưu trữ dữ liệu cho người dùng ở những khu vực đó nhằm giảm độ trễ.
Trường hợp sử dụng thứ hai sẽ hữu ích nếu bạn có dữ liệu với nhiều mẫu truy cập. Ví dụ: bạn có thể thiết lập một bộ chứa nhiều khu vực hoặc bộ chứa theo khu vực để lưu trữ ảnh hoặc nội dung thường được truy cập khác, cũng như bộ chứa gần dòng hoặc bộ chứa dòng lạnh để lưu trữ bản sao lưu của người dùng hoặc nội dung khác không được truy cập thường xuyên.
Trong cả hai trường hợp sử dụng này, bạn nên sử dụng nhiều bộ chứa Cloud Storage.
Trường hợp sử dụng thứ ba sẽ hữu ích nếu bạn đang xây dựng một ứng dụng, chẳng hạn như Google Drive, cho phép người dùng có nhiều tài khoản đã đăng nhập (ví dụ: tài khoản cá nhân và tài khoản công việc). Bạn có thể sử dụng một thực thể Ứng dụng Firebase tuỳ chỉnh để xác thực từng tài khoản bổ sung.
Sử dụng nhiều bộ chứa Cloud Storage
Nếu muốn sử dụng bộ chứa Cloud Storage khác với bộ chứa mặc định được mô tả ở phần trước trong hướng dẫn này hoặc sử dụng nhiều bộ chứa Cloud Storage trong một ứng dụng, bạn có thể tạo một thực thể của firebase.storage
tham chiếu đến bộ chứa tuỳ chỉnh:
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");
Làm việc với các bộ chứa đã nhập
Khi nhập một bộ chứa Cloud Storage hiện có vào Firebase, bạn sẽ phải cấp cho Firebase quyền truy cập vào các tệp này bằng công cụ gsutil
có trong SDK Google Cloud:
gsutil -m acl ch -r -u service-PROJECT_NUMBER@gcp-sa-firebasestorage.iam.gserviceaccount.com gs://BUCKET_NAME
Bạn có thể tìm thấy số dự án của mình như mô tả trong phần giới thiệu về dự án Firebase.
Điều này không ảnh hưởng đến các bộ chứa mới tạo, vì các bộ chứa đó có chế độ kiểm soát quyền truy cập mặc định được đặt để cho phép Firebase. Đây là biện pháp tạm thời và sẽ được thực hiện tự động trong tương lai.
Sử dụng Ứng dụng Firebase tuỳ chỉnh
Nếu đang xây dựng một ứng dụng phức tạp hơn bằng firebase.app.App
tuỳ chỉnh, bạn có thể tạo một thực thể của firebase.storage.Storage
được khởi chạy bằng ứng dụng đó:
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");
Các bước tiếp theo
Chuẩn bị ra mắt ứng dụng:
Bật App Check để đảm bảo rằng chỉ các ứng dụng của bạn mới có thể truy cập vào các bộ chứa bộ nhớ.
Thiết lập cảnh báo về ngân sách cho dự án của bạn trong bảng điều khiển Google Cloud.
Theo dõi bảng điều khiển về Mức sử dụng và thanh toán trong bảng điều khiển Firebase để nắm được thông tin tổng quan về mức sử dụng của dự án trên nhiều dịch vụ Firebase. Bạn cũng có thể truy cập vào trang tổng quan Cloud Storage Mức sử dụng để biết thêm thông tin chi tiết về mức sử dụng.