Google Cloud와 통합

Cloud Storage for Firebase는 Google Cloud Cloud Storage용 Firebase SDK 파일을 Cloud Storage에 버킷 Google Cloud Storage개, 앱이 성장함에 따라 다른 Google Cloud 서비스를 쉽게 통합할 수 있습니다. 관리형 컴퓨팅(예: App Engine, Cloud Functions) 또는 Google 번역과 같은 API 학습에 중점을 두고 있습니다

Firebase는 Google Cloud 서비스 계정을 사용하여 서비스를 운영하고 관리합니다. 사용자 인증 정보를 공유하지 않고 GCP 서비스 계정을 사용하는 Firebase 프로젝트를 만들 때 Cloud Storage를 사용하는 경우 해당 서비스 계정이 사용할 수 있습니다. service-<project number>@gcp-sa-firebasestorage.iam.gserviceaccount.com입니다. 자세한 내용은 자세한 내용은 Firebase 지원 가이드를 참조하세요. 확인할 수 있습니다

참고: Cloud Storage 버킷이 이름이 [e-mail]인 서비스 계정에 대한 자세한 내용은 다음을 참조하세요. Firebase 지원 FAQ 주제 참조하세요.

내부적으로 Cloud Storage용 Firebase SDK는 App Engine 무료 등급. 이 Cloud Storage을(를) 사용하면 별도의 설정 없이 신용카드를 등록하거나 Cloud Billing 계정을 사용하도록 설정해야 하는 경우 또한 Firebase와 Google Cloud 프로젝트 간에 손쉽게 데이터를 공유할 수 있습니다.

기존 Cloud Storage 가져오기를 포함하여 Google Cloud과 통합 버킷에는 Blaze 요금제의 Firebase 프로젝트가 필요합니다. 자세히 알아보기: 가격 책정 페이지에서 요금제를 자세히 알아보세요.

Google Cloud Storage

이 Google Cloud Storage API Cloud Storage용 Firebase SDK를 통해 업로드된 파일, 특히 복잡한 작업(예: 파일 복사, 이동, 나열)을 참조에서 사용할 수 있는 모든 파일을 가져올 수 있습니다

이러한 요청은 Google Cloud Storage 액세스 제어 옵션 (Firebase Authentication 및 Cloud Storage Security Rules가 아님)

API

Cloud Storage용 Firebase SDK 외에도 수행하려는 작업에 따라 Cloud Storage 버킷에 저장된 데이터에 액세스하는 다른 방법이 많이 있습니다. 서버에서 데이터에 액세스하는 경우 서버 측 라이브러리와 JSON 및 S3 호환 XML RESTful API를 제공합니다. 변경사항을 스크립트로 작성하거나 기타 관리 작업을 실행해야 하는 경우 유용한 명령줄 도구가 있습니다.

서버 SDK Google Cloud개

Google Cloud는 다양한 SDK를 위한 고품질 서버 SDK를 클라우드 제품에 대한 Cloud Storage 이 라이브러리는 다음에서 사용할 수 있습니다. Node.js 자바, 이동, Python, PHP 및 Ruby

설치 안내, 인증, 문제 해결 등의 자세한 내용은 위에 링크된 플랫폼별 문서를 참조하세요.

다음은 Google Cloud Storage SDK의 사용 예입니다.

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

자바

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

Go

    // 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}"
    

REST API

클라이언트 라이브러리가 없는 언어를 사용하는 경우 클라이언트 라이브러리가 그렇게 하지 않거나, 여러분이 원하는 HTTP 클라이언트가 Google Cloud Storage는 API와 SDK를 지원하는 JSON 및 XML

이러한 스토리지 데이터 액세스 API 외에도 Cloud Storage for Firebase API를 사용해 Firebase 프로젝트에 사용할 Cloud Storage 버킷을 관리할 수 있습니다.

gsutil

gsutil은 Cloud Storage에 직접 액세스할 수 있는 명령줄 도구입니다. gsutil를 사용할 수 있습니다. 다음과 같은 다양한 버킷 및 객체 관리 작업을 수행할 수 있습니다.

• 객체 업로드, 다운로드, 삭제
• 버킷 및 객체 나열
• 객체 이동, 복사 및 이름 바꾸기
• 객체 및 버킷 ACL 수정

gsutil은 디렉터리 간 파일 이동, 특정 위치 아래의 모든 파일 삭제와 같은 고급 기능도 지원합니다.

다음과 같이 한 참조의 모든 파일을 다른 참조로 손쉽게 이동할 수 있습니다.

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

참조 위치 아래의 모든 파일을 일괄 삭제하는 방법도 매우 간단합니다.

# 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

요청 비율

Google Cloud Storage는 자동 확장을 사용하는 확장성이 뛰어난 서비스입니다. 매우 높은 요청 비율을 달성할 수 있습니다

Google Cloud Storage는 멀티 테넌트 서비스이므로 사용자가 사용할 수 있습니다 이러한 공유된 리소스를 최대한 활용하기 위해 버킷은 초기 IO 용량을 가지고 있습니다.

앱에 Cloud Storage for Firebase를 통합할 계획이라면 다음 사항을 고려하세요. 최적의 성능을 위해 앱에 필요한 최소 요청 비율과 요청을 효율적으로 실행할 수 있습니다 요청 비율 특히 요청 비율을 증가시키는 것이 중요합니다.

객체 버전 관리

백업해 두지 않은 항목을 실수로 삭제한 적이 있으신가요? Google Cloud Storage 지원 객체 버전 관리, 이 기능을 사용하면 자동으로 데이터를 백업하고 백업합니다 gsutil versioning set를 사용하여 객체 버전 관리를 사용 설정할 수 있습니다. 명령어:

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

Cloud Storage는 항상 최신 버전을 선택하므로 복원하는 경우 위의 다른 API 또는 도구 중 하나를 사용하여 원하는 객체를 가장 최근 객체로 지정합니다.

객체 수명 주기 관리

비활성 파일을 자동으로 보관 처리하거나 삭제하는 기능은 여러 애플리케이션에서 매우 유용합니다. 다행히 Google Cloud Storage는 다음을 제공합니다. 객체 수명 주기 관리, 이 옵션을 사용하면 일정 시간이 지난 객체를 삭제하거나 보관처리할 수 있습니다.

사진 공유 애플리케이션에서 모든 사진을 하루 이내에 삭제해야 한다고 가정해 보겠습니다. 객체 수명 주기 정책을 아래와 같이 설정하면 됩니다.

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

gsutil lifecycle set 명령어를 사용하여 배포합니다.

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

이는 버킷의 모든 파일에 적용되므로, 매일 삭제하려는 사진과 장기간 보관하고자 하는 중요한 사용자 백업을 함께 저장하는 경우 별도의 버킷 두 개를 사용하거나 gsutil 또는 자체 서버로 수동으로 삭제하는 것이 좋습니다.

App Engine

App Engine는 'Platform as a Service'입니다. 백엔드를 자동으로 확장하며 수신한 트래픽의 양에 응답하여 로직을 사용합니다. 백엔드 코드만 업로드하면 Google에서 앱의 가용성을 관리해 주므로 개발자는 별도의 서버를 프로비저닝하거나 유지할 필요가 없습니다. App Engine을(를) 사용하면 쉽고 빠르게 추가할 수 있습니다. 신뢰할 수 있는 실행을 위해 추가 처리 능력이나 신뢰할 수 있는 실행을 할 필요가 없습니다

Cloud Storage용 Firebase SDK는 App Engine 기본 버킷을 사용하므로 App Engine 앱을 빌드하면 내장된 App Engine Firebase와 App Engine 간에 데이터를 공유하는 API 이 방법은 오디오 인코딩, 동영상 트랜스코딩, 이미지 변환 등 막대한 연산 능력이 필요한 백그라운드 처리를 수행할 때 유용합니다.

App Engine용 Java, Python, Go 표준 환경에 포함된 App Engine Images API(Java, Python)를 사용하여 이미지 크기 조절, 회전, 뒤집기, 자르기 등을 수행하고 Cloudinary 및 Imgix와 유사하게 클라이언트 측 변환을 허용하는 이미지 제공 URL을 반환할 수 있습니다.

기존 Google Cloud 프로젝트를 Firebase로 가져올 때 다음을 수행합니다. Firebase에서 기존 App Engine 객체를 사용할 수 있게 하려면 객체에 대한 기본 액세스 제어를 통해 Firebase가 객체에 액세스할 수 있도록 합니다. 명령어를 사용하여 gsutil:

gsutil -m acl ch -r -u service-<project number;[e-mail] gs://<your-cloud-storage-bucket>

알려진 문제

App Engine 앱을 가져올 수 없는 두 가지 알려진 사례는 다음과 같습니다.

1. 프로젝트에 이전 App Engine Datastore 마스터/슬레이브가 포함되어 있습니다. 있습니다.
2. 프로젝트 ID에 도메인 프리픽스가 포함된 경우(예: domain.com:project-1234)

두 경우 모두 프로젝트는 Cloud Storage for Firebase를 지원하지 않습니다. 새 Firebase 프로젝트를 만들어 Cloud Storage입니다. 지원팀에 문의하면 도움을 받을 수 있습니다.

Google Cloud Functions(베타)

Google Cloud Functions는 이벤트 기반의 경량형 비동기 컴퓨팅 솔루션으로, 서버나 런타임 환경을 관리할 필요 없이 이벤트에 응답하는 것이 유일한 목적인 소형 함수를 만들 수 있습니다. 이러한 함수는 동영상 트랜스코딩, 머신러닝을 사용한 이미지 분류 또는 동기화 메타데이터를 Firebase Realtime Database로 설정합니다. 기존보다 오버헤드가 App Engine님, Cloud Functions는 Cloud Storage입니다.

Google Cloud Vision API

개발자는 강력한 머신러닝 모델을 사용하기 쉬운 API로 통합한 Google Cloud Vision API를 사용하여 이미지의 내용을 파악할 수 있습니다. 이 API는 이미지를 수천 가지 카테고리로 빠르게 분류하고, 이미지 안의 개별 물체와 얼굴을 감지하고, 이미지에 포함된 글자를 찾아서 판독하고, 부적절한 콘텐츠를 식별하고, 이미지 감정 분석도 제공합니다.

Google Cloud Speech API

Vision API와 마찬가지로 Google Cloud Speech API를 사용하면 개발자가 Cloud Storage에 저장된 오디오 파일에서 텍스트를 추출합니다. 이 API는 글로벌 사용자층을 지원하기 위해 80가지 이상의 언어와 방언을 인식합니다. Google Cloud Natural Language API 개발자는 원시 텍스트를 추출하는 동시에 텍스트의 의미를 추론할 수 있습니다. 전 세계 잠재고객이 필요한 경우 이를 Google Translate API를 사용하여 번역 텍스트를 90개 이상의 언어로 지원합니다