Mevcut bir Google Cloud projesiyle Firebase'i kullanmaya başlama

Firebase projesi, Firebase'e özgü bazı ek yapılandırmaların ve hizmetlerin etkinleştirildiği bir Google Cloud projesidir. Bu işlem genellikle Google Cloud projesine "Firebase ekleme" olarak adlandırılır. Bu sayfada, "Firebase'i nasıl ekleyeceğiniz" ve sık sorulan sorular (SSS) açıklanmaktadır.

Bir Google Cloud projesine Firebase eklediğinizde Firebase, tüm Firebase hizmetlerinin ve arayüzlerinin kullanımını basitleştirmek için çeşitli API'leri otomatik olarak etkinleştirir ve hizmet hesapları oluşturur. Firebase ayrıca Google Cloud konsolunun IAM ve Yönetici > Etiketler sayfasında projenize bir firebase:enabled etiketi ekler. "Firebase eklediğinizde" ne olacağı hakkında daha fazla bilgi edinin.

Firebase projesi ile Google Cloud projesi arasındaki ilişki

Firebase projesi bir Google Cloud projesi olduğundan:

• Projeye Firebase konsolunun yanı sıra Google Cloud konsolu ve Google API'leri konsolundan erişebilir ve projeyle etkileşim kurabilirsiniz.

• Firebase KSA, gcloud CLI ve Google'ın herhangi bir Terraform kaynağını kullanarak projeyle etkileşim kurabilirsiniz.

• Projede hem Firebase hem de Google Cloud ürünlerini ve API'lerini kullanabilirsiniz.

• Projenin IAM izinleri ve rolleri Firebase ile Google Cloud arasında paylaşılır. Bir proje üyesinin (yani bir alt öğenin) Google Cloud projenize erişimi, Firebase projeniz için de geçerli olur (veya tam tersi).

• Projenin faturalandırması Firebase ve Google Cloud arasında paylaşılır. Google Cloud projenizde faturalandırma etkinleştirilmişse Firebase projeniz, Firebase'in kullandıkça öde Blaze fiyatlandırma planına dahil edilir.

• Projenin benzersiz tanımlayıcıları (ör. proje numarası ve proje kimliği) Firebase ve Google Cloud arasında paylaşılır.

• Google Cloud projenize uygulanan tüm kaynak hiyerarşileri (ör. kuruluş, klasörler vb.) Firebase projenize de uygulanır.

• Proje silindiğinde Firebase ve Google Cloud genelinde silinir.

• Projedeki bir kaynağın veya verinin silinmesi ya da değiştirilmesi Firebase ve Google Cloud genelinde geçerli olur.

Mevcut bir Google Cloud projesine Firebase ekleme

Aşağıdaki seçeneklerden birini kullanarak mevcut bir Google Cloud projesine "Firebase ekleyebilirsiniz". Google Cloud projesine Firebase eklemek için gerekli izinlere sahip olduğunuzdan emin olun.

Mevcut bir Google Cloud projesine "Firebase ekledikten" sonra bu işlemin geri alınamayacağını (yani Google Cloud projesinden "Firebase'i tamamen kaldıramayacağınızı") unutmayın. Daha fazla bilgi edinmek için bu SSS sayfasına göz atın.

Not: Bir projede Firebase'in tüm özelliklerine erişmek ve bunları kullanmak için Google CloudFirebase Hizmet Şartları'nı kabul etmeniz gerekir. Firebase Şartları'nı kabul etme koşulu hakkında daha fazla bilgi edinin.

Bu sayfanın ilerleyen bölümlerinde, Google Cloud projenize "Firebase ekleme" ile ilgili diğer SSS ve sorun giderme konularını bulabilirsiniz.

Firebase konsolu

1. Mevcut Google Cloud projesine erişmenizi sağlayan hesapla Firebase konsolunda oturum açın.

2. Yeni bir Firebase projesi oluşturmak için düğmeyi tıklayın.

3. Sayfanın alt kısmında Firebase'i Google Cloud projesine ekle'yi tıklayın.

4. Metin alanına mevcut projenin proje adını girmeye başlayın ve ardından gösterilen listeden projeyi seçin.

5. Projeyi aç'ı tıklayın.

6. İstenirse Firebase Şartları'nı kabul edin.

7. "Firebase ekleme" ve Firebase projesi oluşturma ile ilgili ekrandaki talimatları uygulayın.

   Firebase konsolunda ve Google Analytics'da Yapay Zeka Desteği'ni etkinleştirmenin isteğe bağlı olduğunu unutmayın.

Firebase CLI

1. Henüz yapmadıysanız Firebase CLI'yı yükleyin.

2. Mevcut Google Cloud projesine erişmenizi sağlayan Google Hesabı ile giriş yapın.

3. Aşağıdaki komutu çalıştırın:

   firebase projects:addfirebase

4. İstendiğinde, görüntülenen listeden mevcut Google Cloud projesini seçin.

Not: Mevcut bir Google Cloud projesine "Firebase eklemeye" çalışırken 403 PERMISSION_DENIED hatası alırsanız gerekli izinlere sahip olmayabilirsiniz veya Firebase Hizmet Şartları'nı kabul etmemiş olabilirsiniz.

REST API

1. Mevcut Google Cloud projesinde Firebase Management API'yi etkinleştirin.

2. API erişim jetonunuzu oluşturun.

3. projects.addFirebase komutunu çağırarak proje için Firebase hizmetlerini etkinleştirin.

   Bu çağrıyı yapmak için projenizin kaynak adına ihtiyacınız olduğunu unutmayın.

Ayrıntılı talimatlar için Firebase kılavuzundaki "Yönetim REST API'sini kullanarak Firebase projesi oluşturma ve yönetme" bölümünde Projenize Firebase hizmetleri ekleme konusuna bakın. İlgili kılavuzun Başlamadan önce bölümündeki tüm talimatları uyguladığınızdan emin olun.

Not: Mevcut bir Google Cloud projesine "Firebase eklemeye" çalışırken 403 PERMISSION_DENIED hatası alırsanız bu durum, gerekli izinlere sahip olmadığınız veya Firebase Hizmet Şartları'nı kabul etmediğiniz anlamına gelebilir.

Terraform

1. Mevcut Google Cloud projesinde Firebase Management API'yi (firebase.googleapis.com) etkinleştirin.

2. google_firebase_project kaynağını kullanarak proje için Firebase hizmetlerini etkinleştirin.

Firebase ve Terraform'u kullanma hakkında ayrıntılı bilgi için Terraform ve Firebase'i kullanmaya başlama başlıklı makaleyi inceleyin.

Not: Mevcut bir Google Cloud projesine "Firebase eklemeye" çalışırken 403 PERMISSION_DENIED hatası alırsanız bu durum, gerekli izinlere sahip olmadığınız veya Firebase Hizmet Şartları'nı kabul etmediğiniz anlamına gelebilir.

SSS ve sorun giderme

Firebase'i kullanmaya başlamak için Firebase Hizmet Şartları'nı kabul etmek zorunlu mu?

Bir Google Cloud projesinde Firebase'in tüm özelliklerine erişmek ve bunları kullanmak için Firebase Hizmet Şartları'nı kabul etmeniz gerekir. Mevcut bir Google Cloud projesine "Firebase eklemek" için Firebase Şartları'nı da kabul etmeniz gerekir.

Erişiminiz olan proje sayısı ne olursa olsun Firebase Şartları'nı Google Hesabınız için yalnızca bir kez kabul etmeniz gerekir. Şartları kabul ettiğinizde, bunları Google Hesabınız için kabul etmiş olursunuz. Kabul işlemi, tüm proje üyeleri için proje düzeyinde değildir.

Firebase Şartları'nı Firebase Console'da aşağıdaki seçeneklerden birini kullanarak kabul edebilirsiniz. İstendiğinde Şartlar'ı kabul edin. Firebase Şartları'nı kabul etmeniz istenmiyorsa şartları zaten kabul etmişsiniz demektir.

• Şartları kabul etme iş akışını kullanarak Firebase Şartları'nı doğrudan kabul edin.

• Firebase konsolunu kullanarak yeni bir Firebase projesi oluşturun ve Firebase Şartları'nı kabul edin.

• Firebase konsolunda mevcut bir Firebase projesini açın ve Firebase Şartları'nı kabul edin (örneğin, bir kullanıcı sizi projeye üye (yani asıl kişi) olmaya davet ettiğinde).

• Firebase konsolunda mevcut bir Google Cloud projesini açın, projeye "Firebase'i ekleyin" ve Firebase Şartları'nı kabul edin.

Not: Firebase Şartları'nı kabul etmek Firebase CLI, REST API veya Terraform kullanılarak mümkün değildir. Yalnızca yukarıda açıklanan seçeneklerden biri kullanılarak Firebase konsolu üzerinden yapılabilir.

Önemli: Belirli Firebase hizmetlerinin aynı Google Cloud Platform Hesabı kapsamında kullanımıyla ilgili olarak Google Cloud Ana Sözleşmesi'nin çevrimdışı bir kopyasını imzaladıysanız Firebase Şartları, söz konusu Firebase hizmetlerini kullanımınız için geçerli değildir ve bu Firebase hizmetlerini kullanımınız, söz konusu çevrimdışı belgenin şartlarına tabidir.

"Firebase eklemek" için hangi izinler gerekir?

Mevcut bir Google Cloud projesine "Firebase eklemek" için proje üyesinin (yani bir alt öğenin) aşağıdaki IAM izinlerine sahip olması gerekir:

• firebase.projects.update
• resourcemanager.projects.get
• serviceusage.services.enable
• serviceusage.services.get

Düzenleyici ve Sahip IAM rolleri, varsayılan olarak bu izinleri içerir.

Firebase konsolu, mevcut Google Cloud projelerimin listesini neden yükleyemiyor?

Bu SSS, genellikle Firebase konsolunu kullanarak mevcut bir Google Cloud projesine "Firebase eklemeye" çalışıyorsanız ve binlerce Google Cloud projesine erişiminiz varsa geçerlidir.

Firebase konsolu, binlerce Google Cloud projesini yükleyecek şekilde tasarlanmamıştır. Bunun yerine, mevcut Google Cloud projenize "Firebase eklemek" için Firebase CLI, REST API veya Terraform'u kullanmanızı öneririz.

Ayrıca, "Firebase projem neden Firebase projeleri listemde görünmüyor?" başlıklı SSS bölümünü inceleyebilirsiniz.

Firebase'i eklemek için firebase:enabled etiketini eklemek yeterli mi?

Tüm Firebase projelerinde, Google Cloud konsolunun IAM ve Yönetici > Etiketler sayfasında firebase:enabled etiketi bulunur.

Ancak firebase:enabled etiketini proje etiketleri listenize manuel olarak eklemek, Google Cloud projeniz için Firebase'e özgü yapılandırmaları ve hizmetleri etkinleştirmez. Bunun için Firebase konsolunu (veya ileri düzey kullanım alanları için Firebase CLI, Firebase Management REST API veya Terraform'u) kullanarak Firebase'i eklemeniz gerekir.

Mevcut bir Google Cloud projesine "Firebase eklediğinizde" ne olur?

Firebase projesi, Firebase'e özgü bazı ek yapılandırmaların ve hizmetlerin etkinleştirildiği bir Google Cloud projesidir. Mevcut bir Google Cloud projesine "Firebase eklediğinizde" Firebase, tüm Firebase hizmetlerinin ve arayüzlerinin kullanımını basitleştirmek için aşağıdaki işlemleri yapar:

• Google Cloud konsolunun IAM ve Yönetici > Etiketler sayfasında firebase:enabled etiketini ekler.

• Bir "Tarayıcı" API anahtarı oluşturur ve bunu otomatik olarak Firebase ile ilgili API'ler ile kısıtlar.

• Aşağıdaki hizmet hesaplarını oluşturur:

  • [e-mail]
  • firebase-adminsdk-random5chars@PROJECT_ID.iam.gserviceaccount.com

• Aşağıdaki API'leri etkinleştirir:

  • App Engine Admin API
  • Cloud Pub/Sub API
  • Cloud Resource Manager API
  • Cloud Runtime Configuration API
  • Cloud Testing API
  • Firebase Cloud Messaging API
  • Firebase Dynamic Links API
  • Firebase Hosting API
  • Firebase Installations API
  • Firebase Management API
  • Firebase Remote Config API
  • Firebase Remote Config Realtime API
  • Firebase Rules API
  • Identity Toolkit API
  • Token Service API

Bir projeden "Firebase'i kaldırabilir miyim"?

Mevcut bir Google Cloud projesine "Firebase ekledikten" sonra bu işlem geri alınamaz (yani Google Cloud projesinden "Firebase'i tamamen kaldıramazsınız").

"Firebase ekleme" işlemi, diğer Google Cloud özellikleri için kullanılabilecek API'leri ve arka uç hizmetlerini etkinleştirir. Etkinleştirilen tüm bu hizmetlerin devre dışı bırakılması, bağımlılıklar nedeniyle beklenmedik ve istenmeyen sonuçlara yol açabilir.

Ancak isterseniz tüm API'leri manuel olarak devre dışı bırakabilir ve "Firebase'i eklediğinizde" otomatik olarak etkinleştirilen ve oluşturulan etiketi, API anahtarını ve hizmet hesaplarını silebilirsiniz.

Uyarı: "Firebase ekleme" sırasında gerçekleşen işlemleri manuel olarak devre dışı bırakıp silmeyi seçerseniz bunu son derece dikkatli bir şekilde yapın. Google CloudProjenizin ve projeyle ilişkili uygulamaların, devre dışı bıraktığınız ve sildiğiniz öğelerle ilgili hiçbir şey kullanmadığından kesinlikle emin olmanız gerekir. Aksi takdirde projeniz veya uygulamanız çalışmayı durdurabilir ya da beklenmedik şekillerde davranabilir.

Mevcut bir Google Cloud projesine "Firebase eklenmesini" engelleyebilir miyim?

Mevcut bir Google Cloud projesine "Firebase ekleme" olasılığını engelleyemezsiniz ancak şunları yapabilirsiniz:

"Firebase eklemek" için gereken firebase.projects.update IAM iznine sahip proje üyelerini (yani, ana hesapları) sınırlayın.

Sonraki adımlar

• Firebase projeleri hakkında daha fazla bilgi edinmek için aşağıdaki kaynaklara göz atın:

  • Firebase projelerini anlama: Google Cloud ile ilişkileri, bir projenin temel hiyerarşisi, uygulamaları ve kaynakları dahil olmak üzere Firebase projeleriyle ilgili birkaç önemli kavram hakkında kısa genel bakışlar sunar.

  • Firebase projeleri oluşturmayla ilgili genel en iyi uygulamalar: Firebase projeleri oluşturma ve uygulamalarınızı bir projeye kaydetme ile ilgili genel, üst düzey en iyi uygulamaları sunar. Böylece farklı ortamlar kullanan net bir geliştirme iş akışına sahip olursunuz.

• Uygulamalarınızı Firebase projenize kaydedip Firebase'e bağlayarak mobil ve web uygulamalarınızda Firebase'i kullanmaya başlayın: iOS+ | Android | Web | Flutter | Unity | C++.