Google Cloud ile entegrasyon

Cloud Storage for Firebase, Google Cloud ile sıkı bir şekilde entegre edilmiştir. Cloud Storage için Firebase SDK'ları, dosyaları doğrudan Google Cloud Storage paketlerinde depolar. Uygulamanız büyüdükçe App Engine veya Cloud Functions gibi yönetilen hesaplama ya da Cloud Vision veya Google Translate gibi makine öğrenimi API'leri gibi diğer Google Cloud hizmetlerini entegre edebilirsiniz.

Firebase projesi, Firebase'e özel ek yapılandırma ve hizmetlerin etkinleştirildiği bir Google Cloud projesidir. Bu, Cloud Storage for Firebase ile kullandığınız her Cloud Storage paketine Google Cloud üzerinden (konsolu ve API'leri dahil) erişilebildiği anlamına gelir.

Mevcut Cloud Storage paketlerini içe aktarma da dahil olmak üzere Google Cloud ile entegrasyon için kullandıkça öde Blaze fiyatlandırma planında bir Firebase projesi gerekir.

Hizmet hesaplarıyla ilgili dikkat edilmesi gereken noktalar

Firebase, kullanıcı kimlik bilgilerini paylaşmadan hizmetleri çalıştırmak ve yönetmek için Google Cloud hizmet hesaplarını kullanır. Cloud Storage kullanan bir Firebase projesi oluşturduğunuzda, projenizde zaten ilgili bir hizmet hesabının mevcut olduğunu fark edebilirsiniz: service-PROJECT_NUMBER@gcp-sa-firebasestorage.iam.gserviceaccount.com. Daha fazla bilgi için Firebase hizmet hesaplarına genel bakış başlıklı makaleyi inceleyin.

Google Cloud Storage

Cloud Storage için Firebase SDK'ları aracılığıyla yüklenen dosyalara erişmek amacıyla, özellikle de dosya kopyalama veya taşıma ya da bir referanstaki tüm dosyaları listeleme gibi daha karmaşık işlemleri gerçekleştirmek için Google Cloud Storage API'lerini kullanabilirsiniz.

Bu isteklerin Firebase Authentication ve Cloud Storage Security Rules yerine Google Cloud Storage erişim denetimi seçeneklerini kullandığını unutmayın.

API'ler

Cloud Storage için Firebase SDK'larına ek olarak, ne yapmak istediğinize bağlı olarak Cloud Storage paketinizde depolanan verilere erişmenin başka yolları da vardır. Verilere bir sunucu üzerinden erişiyorsanız JSON ve S3 uyumlu XML RESTful API'nin yanı sıra sunucu tarafı kitaplıklar da sunuyoruz. Komut dosyası değişiklikleri yapmanız veya diğer yönetim görevlerini gerçekleştirmeniz gerekiyorsa komut satırı aracımızdan da yararlanabilirsiniz.

Google Cloud sunucu SDK'ları

Google Cloud, Cloud Storage dahil olmak üzere çeşitli bulut ürünleri için yüksek kaliteli sunucu SDK'ları sunar. Bu kitaplıklar Node.js, Java, Go, Python, PHP ve Ruby'de kullanılabilir.

Yükleme talimatları, kimlik doğrulama ve sorun giderme dahil olmak üzere daha fazla bilgi için yukarıdaki bağlantıya giderek platforma özel dokümanlara göz atın.

Google Cloud Storage SDK'sının örnek kullanımı aşağıda gösterilmiştir:

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

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

İstemci kitaplığı olmayan bir dil kullanıyorsanız, istemci kitaplıklarının yapmadığı bir şey yapmak istiyorsanız veya kullanmak istediğiniz favori bir HTTP istemciniz varsa Google Cloud Storage hem JSON hem de XML için API'ler sunar.

Bu depolama verilerine erişim API'lerine ek olarak, Firebase projelerinde kullanım amacıyla Cloud Storage paketlerini yönetmek için Cloud Storage for Firebase API'yi kullanabilirsiniz.

gsutil

gsutil, Cloud Storage'e doğrudan erişim sağlayan bir komut satırı aracıdır. Aşağıdakiler dahil olmak üzere çok çeşitli paket ve nesne yönetimi görevlerini yapmak için gsutil'ü kullanabilirsiniz:

  • Nesneleri yükleme, indirme ve silme.
  • Paketleri ve nesneleri listeleme.
  • Nesneleri taşıma, kopyalama ve yeniden adlandırma
  • Nesne ve paket EKL'lerini düzenleme

gsutil Dosyaları bir dizinden diğerine taşıma veya belirli bir konumun altındaki tüm dosyaları silme gibi diğer gelişmiş işlemleri yapmanıza olanak tanır.

Bir referanstaki tüm dosyaları başka bir referansa taşımak için: 

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

Bir referansın altındaki tüm dosyaları toplu olarak silmek de benzer bir işlemdir: 

# 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

İstek Oranları

Google Cloud Storage, çok yüksek istek hızlarına ulaşmak için otomatik ölçeklendirme teknolojisini kullanan, yüksek düzeyde ölçeklenebilir bir hizmettir.

Google Cloud Storage, çok kiracılı bir hizmettir. Yani kullanıcılar aynı temel kaynak grubunu paylaşır. Bu paylaşılan kaynaklardan en iyi şekilde yararlanmak için paketlerin başlangıç IO kapasitesi vardır.

Cloud Storage for Firebase'ü uygulamanıza entegre etmeyi planlarken, uygulamanızın iyi performans göstermesi için ihtiyaç duyduğu minimum istek hızını ve isteklerin verimli bir şekilde yapılmasını göz önünde bulundurun. İstek oranları ve özellikle istek oranlarını artırma ile ilgili kuralları inceleyin.

Nesnede Sürüm Oluşturma

Bir şeyi yanlışlıkla sildiğiniz halde yedeğinizin olmadığı oldu mu? Google Cloud Storage, verilerinizi yedekleme ve bu yedeklerden geri yükleme için otomatik bir yöntem sunan nesne sürümlendirmesini destekler. Nesnede sürüm oluşturmayı gsutil versioning set komutunu kullanarak etkinleştirebilirsiniz:

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

Cloud Storage her zaman en son sürümü alır. Dolayısıyla, bir nesneyi geri yüklemek isterseniz, istenen nesneyi en yeni nesne olarak ayarlamak için yukarıdaki diğer API'lerden veya araçlardan birini kullanmanız gerekir.

Nesne Yaşam Döngüsü Yönetimi

Eski dosyaları otomatik olarak arşivleme veya silme yeteneği, birçok uygulama için yararlı bir özelliktir. Neyse ki Google Cloud Storage, belirli bir süre sonra nesneleri silmenize veya arşivlemenize olanak tanıyan Nesne Yaşam Döngüsü Yönetimi sunar.

Tüm fotoğrafların bir gün içinde silinmesini istediğiniz bir fotoğraf paylaşım uygulaması düşünün. Nesne yaşam döngüsü politikasını aşağıdaki şekilde ayarlayabilirsiniz:

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

Ardından gsutil lifecycle set komutunu kullanarak dağıtın:

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

Bunun paketteki tüm dosyalar için geçerli olduğunu unutmayın. Bu nedenle, her gün silmek istediğiniz yan fotoğraflarla birlikte uzun süre saklamak istediğiniz önemli kullanıcı yedeklemelerini depoluyorsanız iki ayrı paket kullanmayı veya gsutil ya da kendi sunucunuzla manuel olarak silme işlemi gerçekleştirmeyi düşünebilirsiniz.

Google Cloud Functions (Beta)

Google Cloud Functions, bir sunucuyu veya bir çalışma zamanı ortamını yönetmeye gerek kalmadan etkinliklere yanıt veren küçük, tek amaçlı işlevler oluşturmanıza olanak tanıyan basit, olay tabanlı, eşzamansız bir bilgi işlem çözümüdür. Bu işlevler video kodunu dönüştürmek, makine öğrenimini kullanarak görüntüleri sınıflandırmak veya meta verileri Firebase Realtime Database ile senkronize etmek için kullanılabilir. App Engine kadar ek yüküyle Cloud Functions, Cloud Storage uygulamasındaki değişikliklere tepki vermenin en hızlı yoludur.

Google Cloud Vision API

Google Cloud Vision API, kullanımı kolay bir API'de güçlü makine öğrenimi modellerini kapsüllerken geliştiricilerin bir görüntünün içeriğini anlamasına olanak tanır. Resimleri hızlı bir şekilde binlerce kategoriye ayırır, resimlerdeki nesneleri ve yüzleri ayrı ayrı tespit eder, resimlerdeki basılı kelimeleri bulup okur, rahatsız edici içeriği tanımlar ve hatta görüntü yaklaşım analizi sağlar.

Google Cloud Speech API

Vision API'ye benzer şekilde Google Cloud Speech API, geliştiricilerin Cloud Storage ürününde depolanan bir ses dosyasından metin ayıklamasına olanak tanır. API, küresel kullanıcı tabanınızı desteklemek için 80'den fazla dili ve lehçeyi tanır. Google Cloud Natural Language API ile birlikte kullanıldığında geliştiriciler hem ham metni ayıklayabilir hem de bu metnin anlamını çıkarabilir. Ayrıca, global bir kitleye ulaşmak istiyorsanız metni 90'dan fazla dile çevirmek için bu özelliği Google Translate API ile birlikte kullanın.

Google App Engine

Google App Engine, aldığı trafik miktarına göre arka uç mantığını otomatik olarak ölçeklendiren bir "Platform Hizmeti"dir. Arka uç kodunuzu yüklemeniz yeterlidir. Google, uygulamanızın kullanılabilirliğini yönetir. Hazırlamanız veya sürdürmeniz gereken sunucu yoktur. App Engine, Firebase uygulamanıza ek işlem gücü veya güvenilir yürütme eklemenin hızlı ve basit bir yoludur.

PROJECT_ID.appspot.com ad biçimine sahip varsayılan bir Cloud Storage paketiniz varsa bu paket, projenizdeki bir App Engine uygulamasıyla otomatik olarak paylaşılır. Bu, bir App Engine uygulaması oluşturursanız bu paket ile App Engine arasında veri paylaşmak için yerleşik App Engine API'lerini kullanabileceğiniz anlamına gelir. Bu, ses kodlama, video kod dönüştürme ve resim dönüşümlerinin yanı sıra yoğun hesaplama gerektiren diğer arka plan işlemlerini gerçekleştirmek için kullanışlıdır.

App Engine için Java, Python ve Go standart ortamları, bir görseli yeniden boyutlandırabilen, döndürebilen, çevirebilen ve kırpabilen App Engine Images API'yi (Java | Python | Go) içerir. Ayrıca, Cloudinary ve Imgix'e benzer şekilde istemci taraflı dönüşümlere olanak tanıyan bir görsel yayınlama URL'si döndürür.

Mevcut bir Google Cloud projesini Firebase'e aktarırken mevcut App Engine nesnelerini Firebase'de kullanılabilir hale getirmek istiyorsanız gsutil kullanarak aşağıdaki komutu çalıştırarak Firebase'in nesnelerinize erişmesine izin vermek için nesnelerinizde varsayılan erişim denetimini ayarlamanız gerekir:

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

Firebase Security Rules ve App Engine dosyaları için dikkat edilmesi gereken noktalar

*.appspot.com ad biçimine sahip varsayılan bir Cloud Storage paketiniz varsa projenizde bu paketi paylaşan bir App Engine uygulaması da vardır.

Firebase Security Rules öğenizi herkese açık (kimliği doğrulanmamış) erişim için yapılandırırsanız yeni yüklenen App Engine dosyalarını da herkese açık hale getirirsiniz.

Cloud Storage ve App Engine ile ilgili bilinen sorunlar

App Engine uygulamanızı içe aktaramadığınız iki bilinen durum vardır:

  1. Projede eski bir App Engine Datastore Master/Slave uygulaması bulunuyor.
  2. Projenin ön ekinde alan adı bulunan bir proje kimliği vardır (ör. domain.com:project-1234).

Bu iki durumda da proje Cloud Storage for Firebase'ü desteklemez ve Cloud Storage'ü kullanmak için yeni bir Firebase projesi oluşturmanız gerekir. Size yardımcı olabilmemiz için destek ekibiyle iletişime geçin.