Tích hợp với Google Cloud

Cloud Storage for Firebase được tích hợp chặt chẽ với Google Cloud. Các SDK Firebase cho Cloud Storage lưu trữ tệp trực tiếp trong Google Cloud Storage vùng chứa, và khi ứng dụng của bạn phát triển, bạn có thể tích hợp các dịch vụ Google Cloud khác, chẳng hạn như dịch vụ điện toán được quản lý như App Engine hoặc Cloud Functions, hoặc các API học máy như Cloud Vision hoặc Google Dịch.

Dự án Firebase thực ra chỉ là một dự án Google Cloud có các cấu hình và dịch vụ bổ sung dành riêng cho Firebase được bật. Điều này có nghĩa là bạn có thể truy cập vào mọi vùng chứa Cloud Storage mà bạn sử dụng với Cloud Storage for Firebase trong Google Cloud (bao gồm cả bảng điều khiển và API của vùng chứa đó).

Những điều cần cân nhắc đối với tài khoản dịch vụ

Firebase sử dụng tài khoản dịch vụ Google Cloud để vận hành và quản lý các dịch vụ mà không chia sẻ thông tin xác thực của người dùng. Khi tạo một dự án Firebase sử dụng Cloud Storage, bạn có thể nhận thấy rằng một tài khoản dịch vụ tương ứng đã có sẵn trong dự án của bạn: service-PROJECT_NUMBER@gcp-sa-firebasestorage.iam.gserviceaccount.com. Để biết thêm thông tin, hãy xem bài viết Tổng quan về tài khoản dịch vụ Firebase.

Google Cloud Storage

Bạn có thể sử dụng Google Cloud Storage API để truy cập vào các tệp được tải lên thông qua Firebase SDK cho Cloud Storage, đặc biệt là để thực hiện các thao tác phức tạp hơn, chẳng hạn như sao chép hoặc di chuyển tệp, hoặc liệt kê tất cả các tệp có sẵn tại một tham chiếu.

Điều quan trọng cần lưu ý là các yêu cầu này sử dụng Google Cloud Storage các lựa chọn kiểm soát quyền truy cập, thay vì Firebase Authentication và Cloud Storage Security Rules.

API

Ngoài SDK Firebase cho Cloud Storage, có một số cách khác để truy cập vào dữ liệu được lưu trữ trong vùng chứa Cloud Storage, tuỳ thuộc vào những gì bạn muốn làm. Nếu đang truy cập vào dữ liệu trên một máy chủ, chúng tôi cung cấp các thư viện phía máy chủ, cũng như API RESTful JSON và XML tương thích với S3. Hoặc nếu bạn cần viết tập lệnh thay đổi hoặc thực hiện các tác vụ quản trị khác, chúng tôi có một công cụ dòng lệnh sẽ rất hữu ích.

Google Cloud SDK máy chủ

Google Cloud cung cấp các SDK máy chủ chất lượng cao cho một số sản phẩm trên đám mây, bao gồm cả Cloud Storage. Các thư viện này có trong Node.js, Java, Go, Python, PHP, và Ruby.

Để biết thêm thông tin, bao gồm cả hướng dẫn cài đặt, xác thực và khắc phục sự cố, hãy tham khảo tài liệu dành riêng cho nền tảng được liên kết ở trên.

Ví dụ về cách sử dụng SDK Google Cloud Storage được trình bày bên dưới:

Node.js

    // Require gcloud
    var gcloud = require('google-cloud');

    // Enable Cloud Storage
    var gcs = gcloud.storage({
      projectId: 'grape-spaceship-123',
      keyFilename: '/path/to/keyfile.json'
    });

    // Reference an existing bucket.
    var bucket = gcs.bucket('my-existing-bucket');

    // Upload a local file to a new file to be created in your bucket.
    bucket.upload('/photos/zoo/zebra.jpg', function(err, file) {
      if (!err) {
        // "zebra.jpg" is now in your bucket.
      }
    });

    // Download a file from your bucket.
    bucket.file('giraffe.jpg').download({
      destination: '/photos/zoo/giraffe.jpg'
    }, function(err) {});

Java

    // Enable Cloud Storage
    Storage storage = StorageOptions.builder()
      .authCredentials(AuthCredentials.createForJson(new FileInputStream("/path/to/my/key.json"))
      .build()
      .service();

    // Upload a local file to a new file to be created in your bucket.
    InputStream uploadContent = ...
    BlobId blobId = BlobId.of("my-existing-bucket", "zebra.jpg");
    BlobInfo blobInfo = BlobInfo.builder(blobId).contentType("text/plain").build();
    Blob zebraBlob = storage.create(blobInfo, content);

    // Download a file from your bucket.
    Blob giraffeBlob = storage.get("my-existing-bucket", "giraffe.jpg", null);
    InputStream downloadContent = giraffeBlob.getInputStream();

Bắt đầu

    // Enable Cloud Storage
    client, err := storage.NewClient(ctx, option.WithServiceAccountFile("path/to/keyfile.json"))
    if err != nil {
        log.Fatal(err)
    }

    // Download a file from your bucket.
    rc, err := client.Bucket("my-existing-bucket").Object("giraffe.jpg").NewReader(ctx)
    if err != nil {
        log.Fatal(err)
    }
    defer rc.Close()
    body, err := ioutil.ReadAll(rc)
    if err != nil {
        log.Fatal(err)
    }

Python

    # Import gcloud
    from google.cloud import storage

    # Enable Cloud Storage
    client = storage.Client()

    # Reference an existing bucket.
    bucket = client.get_bucket('my-existing-bucket')

    # Upload a local file to a new file to be created in your bucket.
    zebraBlob = bucket.get_blob('zebra.jpg')
    zebraBlob.upload_from_filename(filename='/photos/zoo/zebra.jpg')

    # Download a file from your bucket.
    giraffeBlob = bucket.get_blob('giraffe.jpg')
    giraffeBlob.download_as_string()

PHP

    // Require gcloud
    require 'vendor/autoload.php';
    use Google\Cloud\Storage\StorageClient;

    // Enable Cloud Storage
    $storage = new StorageClient([
        'projectId' => 'grape-spaceship-123'
    ]);

    // Reference an existing bucket.
    $bucket = $storage->bucket('my-existing-bucket');

    // Upload a file to the bucket.
    $bucket->upload(
        fopen('/photos/zoo/zebra.jpg', 'r')
    );

    // Download a file from your bucket.
    $object = $bucket->object('giraffe.jpg');
    $object->downloadToFile('/photos/zoo/giraffe.jpg');

Ruby

    # Require gcloud
    require "google/cloud"

    # Enable Cloud Storage
    gcloud = Google::Cloud.new "grape-spaceship-123", "/path/to/keyfile.json"
    storage = gcloud.storage

    # Reference an existing bucket.
    bucket = storage.bucket "my-existing-bucket"

    # Upload a file to the bucket.
    bucket.create_file "/photos/zoo/zebra.jpg", "zebra.jpg"

    # Download a file from your bucket.
    file = bucket.file "giraffe.jpg"
    file.download "/photos/zoo/#{file.name}"

API REST

Nếu bạn đang sử dụng một ngôn ngữ không có thư viện ứng dụng, muốn thực hiện một thao tác mà các thư viện ứng dụng không thực hiện được hoặc chỉ có một ứng dụng HTTP yêu thích mà bạn muốn sử dụng, thì Google Cloud Storage cung cấp các API cho cả JSON và XML.

Ngoài các API truy cập dữ liệu lưu trữ này, để quản lý các bộ chứa Cloud Storage dùng trong dự án Firebase, bạn có thể sử dụng API Cloud Storage cho Firebase.

gsutil

gsutil là một công cụ dòng lệnh cho phép bạn truy cập trực tiếp vào Cloud Storage. Bạn có thể sử dụng gsutil để thực hiện nhiều tác vụ quản lý vùng chứa và đối tượng, bao gồm:

  • Tải đối tượng lên, tải đối tượng xuống và xoá đối tượng.
  • Liệt kê các bộ chứa và đối tượng.
  • Di chuyển, sao chép và đổi tên đối tượng.
  • Chỉnh sửa danh sách kiểm soát quyền truy cập (ACL) của đối tượng và vùng chứa.

gsutil cho phép thực hiện các thao tác nâng cao khác, chẳng hạn như di chuyển tệp từ một thư mục sang thư mục khác hoặc xoá tất cả các tệp bên dưới một vị trí nhất định.

Việc di chuyển tất cả các tệp từ một tham chiếu sang một tham chiếu khác rất dễ dàng: 

gsutil mv gs://bucket/old/reference gs://bucket/new/reference

Việc xoá hàng loạt tất cả các tệp bên dưới một tham chiếu cũng trực quan tương tự: 

# Delete all files under a path
gsutil rm -r gs://bucket/reference/to/delete



# Delete all the files in a bucket but not the bucket
gsutil rm -r gs://bucket/**



# Delete all the files AND the bucket
# Removing the default bucket will break the Firebase SDKs for Cloud Storage and
is strongly discouraged
gsutil rm -r gs://bucket

Tỷ lệ yêu cầu

Google Cloud Storage là một dịch vụ có khả năng mở rộng cao, sử dụng công nghệ tự động cấp tài nguyên bổ sung để đạt được tỷ lệ yêu cầu rất cao.

Google Cloud Storage là một dịch vụ nhiều người thuê, nghĩa là người dùng chia sẻ cùng một nhóm tài nguyên cơ bản. Để tận dụng tối đa các tài nguyên dùng chung này, các vùng chứa có dung lượng IO ban đầu.

Khi bạn lên kế hoạch tích hợp Cloud Storage for Firebase vào ứng dụng, hãy nghĩ đến tỷ lệ yêu cầu tối thiểu mà ứng dụng cần để có hiệu suất tốt và cách đưa ra yêu cầu một cách hiệu quả. Xem lại hướng dẫn về tỷ lệ yêu cầu, đặc biệt là cách tăng tỷ lệ yêu cầu.

Kiểm soát phiên bản đối tượng

Bạn đã bao giờ vô tình xoá một nội dung nào đó và không có bản sao lưu chưa? Google Cloud Storage hỗ trợ tính năng Kiểm soát phiên bản đối tượng, cung cấp một cách tự động để sao lưu dữ liệu và khôi phục từ các bản sao lưu đó. Bạn có thể bật tính năng Kiểm soát phiên bản đối tượng bằng lệnh gsutil versioning set:

gsutil versioning set on gs://<your-cloud-storage-bucket>

Cloud Storage luôn chọn phiên bản mới nhất. Vì vậy, nếu muốn khôi phục một đối tượng, bạn cần sử dụng một trong các API hoặc công cụ khác ở trên để đặt đối tượng mong muốn làm đối tượng mới nhất.

Quản lý vòng đời đối tượng

Khả năng tự động lưu trữ hoặc xoá các tệp cũ là một tính năng hữu ích cho nhiều ứng dụng. May mắn thay, Google Cloud Storage cung cấp tính năng Quản lý vòng đời đối tượng, cho phép bạn xoá hoặc lưu trữ các đối tượng sau một khoảng thời gian nhất định.

Hãy cân nhắc một ứng dụng chia sẻ ảnh mà bạn muốn tất cả ảnh đều bị xoá trong vòng một ngày. Bạn có thể thiết lập chính sách vòng đời đối tượng như sau:

// lifecycle.json
{
  "lifecycle": {
    "rule":
    [
      {
        "action": {"type": "Delete"},
        "condition": {"age": 1}
      }
    ]
  }
}

Và triển khai chính sách đó bằng lệnh gsutil lifecycle set:

gsutil lifecycle set lifecycle.json gs://<your-cloud-storage-bucket>

Xin lưu ý rằng chính sách này áp dụng cho tất cả các tệp trong vùng chứa. Vì vậy, nếu bạn đang lưu trữ các bản sao lưu quan trọng của người dùng mà bạn muốn lưu trữ trong một thời gian dài cùng với những bức ảnh mà bạn muốn xoá hằng ngày, thì bạn có thể muốn sử dụng hai vùng chứa riêng biệt hoặc thực hiện thao tác xoá theo cách thủ công bằng gsutil hoặc máy chủ của riêng bạn.

Google Cloud Functions (Thử nghiệm)

Google Cloud Functions là một giải pháp điện toán không đồng bộ, dựa trên sự kiện và có dung lượng nhẹ, cho phép bạn tạo các hàm nhỏ, có một mục đích duy nhất để phản hồi các sự kiện mà không cần quản lý máy chủ hoặc môi trường thời gian chạy. Bạn có thể sử dụng các hàm này để chuyển mã video, phân loại hình ảnh bằng công nghệ học máy hoặc đồng bộ hoá siêu dữ liệu với Firebase Realtime Database. Với mức hao tổn thậm chí còn ít hơn App Engine, Cloud Functions là cách nhanh nhất để phản ứng với những thay đổi trong Cloud Storage.

Google Cloud Vision API

Google Cloud Vision API cho phép nhà phát triển hiểu nội dung của một hình ảnh bằng cách đóng gói các mô hình học máy mạnh mẽ trong một API dễ sử dụng. API này nhanh chóng phân loại hình ảnh thành hàng nghìn danh mục, phát hiện các đối tượng và khuôn mặt riêng lẻ trong hình ảnh, tìm và đọc các từ in có trong hình ảnh, xác định nội dung phản cảm và thậm chí cung cấp tính năng phân tích cảm xúc của hình ảnh.

Google Cloud Speech API

Tương tự như Vision API, Google Cloud Speech API cho phép nhà phát triển trích xuất văn bản từ một tệp âm thanh được lưu trữ trong Cloud Storage. API này nhận dạng hơn 80 ngôn ngữ và biến thể để hỗ trợ cơ sở người dùng toàn cầu của bạn. Khi kết hợp với Google Cloud Natural Language API, nhà phát triển có thể vừa trích xuất văn bản thô vừa suy luận ý nghĩa về văn bản đó. Và nếu cần có đối tượng toàn cầu, hãy kết hợp API này với Google Dịch API để dịch văn bản sang hơn 90 ngôn ngữ.

Google App Engine

Google App Engine là một "Nền tảng dưới dạng dịch vụ" tự động điều chỉnh quy mô logic phụ trợ để phản hồi lượng lưu lượng truy cập mà nền tảng này nhận được. Bạn chỉ cần tải mã phụ trợ lên và Google sẽ quản lý khả năng cung cấp của ứng dụng; bạn không cần cung cấp hoặc duy trì máy chủ. App Engine là một cách nhanh chóng và đơn giản để thêm sức mạnh xử lý bổ sung hoặc thực thi đáng tin cậy vào ứng dụng Firebase.

Nếu bạn có một vùng chứa Cloud Storage mặc định có định dạng tên là PROJECT_ID.appspot.com, thì vùng chứa đó sẽ tự động được chia sẻ với một ứng dụng App Engine trong dự án của bạn. Điều này có nghĩa là nếu xây dựng một App Engine ứng dụng, bạn có thể sử dụng các API App Engine tích hợp để chia sẻ dữ liệu giữa bộ chứa đó và App Engine. Điều này hữu ích cho việc thực hiện mã hoá âm thanh, chuyển mã video và biến đổi hình ảnh, cũng như các hoạt động xử lý nền tốn nhiều tài nguyên tính toán khác.

Các môi trường tiêu chuẩn Java, Python và Go cho App Engine bao gồm API Hình ảnh App Engine (Java | Python | Go), có thể đổi kích thước, xoay, lật và cắt hình ảnh, cũng như trả về URL phân phát hình ảnh cho phép biến đổi phía ứng dụng, tương tự như Cloudinary và Imgix.

Khi nhập một dự án Google Cloud hiện có vào Firebase, nếu bạn muốn cung cấp bất kỳ đối tượng App Engine hiện có nào trong Firebase, bạn cần đặt quyền kiểm soát quyền truy cập mặc định trên các đối tượng để cho phép Firebase truy cập vào các đối tượng đó bằng cách chạy lệnh sau bằng gsutil:

gsutil -m acl ch -r -u service-PROJECT_NUMBER@gcp-sa-firebasestorage.iam.gserviceaccount.com gs://BUCKET_NAME

Những điều cần cân nhắc đối với tệp Firebase Security Rules và App Engine

Nếu bạn có một vùng chứa Cloud Storage mặc định có định dạng tên là *.appspot.com, thì dự án của bạn cũng có một ứng dụng App Engine chia sẻ vùng chứa đó.

Nếu bạn định cấu hình Firebase Security Rules cho quyền truy cập công khai (chưa xác thực), thì bạn cũng sẽ cung cấp quyền truy cập công khai vào các tệp App Engine mới tải lên.

Các vấn đề đã biết đối với Cloud Storage và App Engine

Có 2 trường hợp đã biết mà bạn không thể nhập ứng dụng App Engine:

  1. Dự án chứa một ứng dụng App Engine Datastore Master/Slave cũ.
  2. Dự án có mã dự án được thêm tiền tố miền, ví dụ: domain.com:project-1234.

Trong một trong các trường hợp này, dự án sẽ không hỗ trợ Cloud Storage for Firebase, và bạn nên tạo một dự án Firebase mới để sử dụng Cloud Storage. Liên hệ với bộ phận hỗ trợ để chúng tôi có thể giúp bạn.