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

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

Bir Google Cloud projeye Firebase'i eklediğinizde Firebase, tüm Firebase hizmetlerinin ve arayüzlerinin kullanımını kolaylaştırmak için otomatik olarak çeşitli API'leri etkinleştirir ve hizmet hesapları oluşturur. Firebase ayrıca Google Cloud konsolunun Etiketler sayfasında projenize bir firebase:enabled etiketi ekler. "Firebase eklediğinizde ne olur?" başlıklı makaleden daha fazla bilgi edinin.

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

Firebase projesi bir Google Cloud projesi olduğundan:

• Projeye Firebase konsolunda, Google Cloud konsolunda ve Google API'leri konsolunda erişip projeyle etkileşimde bulunabilirsiniz.

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

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

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

• Projenin faturalandırması Firebase ve Google Cloud arasında paylaşılır. Google Cloud projenizde faturalandırma etkinse 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.

• Projenin silinmesi, Firebase ve Google Cloud'da da silinmesine neden olur.

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

Firebase'i mevcut bir Google Cloud projesine ekleme

Aşağıdaki seçeneklerden herhangi birini kullanarak mevcut bir Google Cloud projeye "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 bilgiyi bu SSS bölümünde bulabilirsiniz.

Not: Bir Google Cloud projesinde Firebase'in tüm özelliklerine erişmek ve bu özellikleri kullanmak için Firebase Hizmet Şartları'nı kabul etmeniz gerekir. Firebase Şartları ile ilgili koşul hakkında daha fazla bilgiyi bu SSS bölümünde 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örüntülenen 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 talimatlarını uygulayın.

   Firebase konsolunda ve Google Analytics yapay zeka yardımını 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österilen listeden mevcut Google Cloud projesini seçin.

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

REST API

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

2. API erişim jetonunuzu oluşturun.

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

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

Ayrıntılı talimatlar için Firebase kılavuzundaki "Yönetim REST API'sini kullanarak Firebase projesi oluşturma ve yönetme" başlıklı makalenin Firebase hizmetlerini projenize ekleme bölümüne bakın. Bu rehberin Başlamadan önce bölümündeki tüm talimatları uyguladığınızdan emin olun.

Not: Mevcut bir Google Cloud projeye "Firebase eklemeye" çalışırken 403 PERMISSION_DENIED hatası alırsanız bu, 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 kullanımı 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 projeye "Firebase eklemeye" çalışırken 403 PERMISSION_DENIED hatası alırsanız bu, 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?

Google Cloud projesinde Firebase'in tüm özelliklerine erişmek ve bu özellikleri kullanmak için Firebase Hizmet Şartları'nı kabul etmeniz gerekir. Ayrıca, mevcut bir Google Cloud projesine "Firebase eklemek" için Firebase Şartları'nı kabul etmeniz gerekir.

Kaç projeye erişiminiz olursa olsun Google Hesabınız için Firebase Şartları'nı yalnızca bir kez kabul etmeniz gerekir. Şartları kabul ettiğinizde yalnızca Google Hesabınız için kabul etmiş olursunuz. Kabul işlemi, tüm proje üyeleri için proje düzeyinde yapılmaz.

Aşağıdaki seçeneklerden herhangi birini kullanarak Firebase konsolu üzerinden Firebase Şartları'nı kabul edebilirsiniz. İstendiğinde Şartlar'ı kabul edin.

• Firebase konsolunu kullanarak yeni bir Firebase projesi oluşturun.

• Firebase konsolunda mevcut bir Firebase projesini açın (örneğin, bir kullanıcı sizi projede proje üyesi (yani asıl üye) olmaya davet etmiştir).

• Firebase konsolunda mevcut bir Google Cloud açın ve bu Google Cloud'ya "Firebase'i ekleyin".

Not: Firebase Şartları'nı kabul etmek için Firebase CLI, REST API veya Terraform kullanılamaz. Bu işlem yalnızca Firebase konsolu kullanılarak 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ı bu Firebase hizmetlerini kullanımınız için geçerli değildir ve bu Firebase hizmetlerini kullanımınız, imzaladığınız çevrimdışı şartlara tabidir.

"Firebase eklemek" için hangi izinler gerekir?

Mevcut bir Google Cloud projesine "Firebase eklemek" için bir proje üyesinin (yani bir asıl) 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 rollerinde bu izinler varsayılan olarak bulunur.

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

Tüm Firebase projeleri, Google Cloud konsolunun Etiketler sayfasında firebase:enabled etiketine sahiptir.

Ancak, firebase:enabled etiketini proje etiketleri listenize manuel olarak eklemeniz, Google Cloud projenizde Firebase'e özel yapılandırmaları ve hizmetleri ETKİNLEŞTİRMEZ. Bunu yapmak için Firebase konsolunu (veya gelişmiş kullanım alanları için Firebase CLI, Firebase Management REST API ya da Terraform'u) kullanarak Firebase'i eklemeniz gerekir.

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

Firebase projesi, Google Cloud Firebase'e özgü bazı ek yapılandırmaların ve hizmetlerin etkinleştirildiği bir projedir. Bu nedenle, mevcut bir Google Cloud projeye "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 firebase:enabled Etiketler sayfasında Etiketler'i ekler.

• "Tarayıcı" API anahtarı oluşturur ve bunu otomatik olarak Firebase ile ilgili API'lerle 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 projeye "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 özellikler için kullanılabilecek API'leri ve arka uç hizmetlerini etkinleştirir. Etkinleştirilmiş bu hizmetlerin tümünün devre dışı bırakılması, bağımlılıklar nedeniyle beklenmedik ve istenmeyen sonuçlara yol açabilir.

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

Uyarı: "Firebase ekleme" sırasında olanları manuel olarak devre dışı bırakıp silmeyi seçerseniz çok dikkatli olun. Google Cloud projenizin ve projeyle ilişkili uygulamaların, devre dışı bırakıp sileceğiniz herhangi bir şeyi kullanmadığından kesinlikle emin olmanız gerekir. Aksi takdirde projeniz veya uygulamanız çalışmayı durdurabilir ya da beklenmedik şekilde davranabilir.

Mevcut bir Google Cloud projesinde "Firebase ekleme" işlemini engelleyebilir miyim?

Mevcut bir Google Cloud projesine "Firebase ekleme" olasılığını tamamen engelleyemeseniz de aşağıdakileri yapabilirsiniz:

"Firebase eklemek" için gerekli olan IAM izni firebase.projects.update'ne sahip proje üyelerini (yani asıl kullanıcıları) 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: Firebase projeleriyle ilgili birkaç önemli kavram hakkında kısa bilgiler sunar. Bu kavramlar arasında projelerin Google Cloud ile ilişkisi, bir projenin ve uygulamalarının ve kaynaklarının temel hiyerarşisi yer alır.

  • Firebase projelerini ayarlamayla ilgili genel en iyi uygulamalar: Firebase projelerini ayarlama ve uygulamalarınızı bir projeye kaydetmeyle ilgili genel ve üst düzey en iyi uygulamaları sağlar. Böylece, farklı ortamların kullanıldığı 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++.