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

Firebase projesi, Firebase'e özgü bazı ek yapılandırmaların ve hizmetlerin etkin olduğu bir Google Cloud projesidir. Buna genellikle Google Cloud projesine "Firebase ekleme" denir. Bu sayfada, "Firebase'i ekleme" işleminin yanı sıra bazı sık sorulan sorular (SSS) açıklanmaktadır.

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

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

Firebase projeleri Google Cloud projesi olduğundan:

• Projeye Firebase konsolundan, Google Cloud konsolundan ve Google API'leri konsolundan erişebilir ve projeyle etkileşim kurabilirsiniz.

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

• Projede hem Firebase hem de Google Cloud'deki ürünleri ve API'leri kullanabilirsiniz.

• Projenin IAM izinleri ve rolleri Firebase ile Google Cloud arasında paylaşılır. Bir proje üyesinin (yani asıl kullanıcının) Google Cloud projenize sahip olduğu tüm erişimler Firebase projeniz için de geçerlidir (ve 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ında olur.

• 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'te de silinir.

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

Mevcut bir Google Cloud projesine Firebase ekleme

Aşağıdaki seçeneklerden herhangi 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 ekleme" işlemini geri alamayacağınızı (yani Google Cloud projesinden "Firebase'i tamamen kaldıramayacağınızı") unutmayın. Daha fazla bilgi için bu SSS sayfasını inceleyin.

Not: Google Cloud projesinde Firebase'in tüm özelliklerine erişip bunları kullanmak için Firebase Hizmet Şartları'nı kabul etmeniz gerekir. Firebase Şartları koşulu hakkında daha fazla bilgiyi bu SSS'de bulabilirsiniz.

Firebase konsol

1. Firebase konsoluna gidin.

2. Mevcut Google Cloud projesine erişmenize olanak tanıyan Google Hesabı ile oturum açın.

3. Proje oluştur'u tıklayın.

4. Sayfanın alt kısmında Zaten bir Google Cloud projeniz var mı? bağlantısını tıklayın.

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

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

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

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

   Google Analytics'ü etkinleştirmenin isteğe bağlı olduğunu unutmayın.

Firebase CLI

1. Henüz yapmadıysanız Firebase CLI'yi 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 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 çağrısını yaparak 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 "Management REST API'yi kullanarak Firebase projesi oluşturma ve yönetme" bölümündeki Projenize Firebase hizmetleri ekleme bölümüne bakın. Bu 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 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 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 gerekir mi?

Google Cloud projesinde Firebase'in tüm özelliklerine erişip 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. Hükümleri kabul ettiğinizde yalnızca Google Hesabınız için kabul etmiş olursunuz. Kabul, tüm proje üyeleri için proje düzeyinde değildir.

Firebase Şartları'nı, aşağıdaki seçeneklerden herhangi birini kullanarak Firebase konsolu üzerinden 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 yönetici) olmaya davet ettiyse).

• Firebase konsolunda mevcut bir Google Cloud açın ve "Firebase ekleyin".

Not: Firebase CLI, REST API veya Terraform kullanılarak Firebase Şartları'nın kabul edilmesi mümkün değildir. Bu işlem yalnızca FirebaseConsole kullanılarak yapılabilir.

Önemli: Belirli Firebase hizmetlerinin aynı Google Cloud Platform hesabı kapsamında kullanılmasıyla ilgili olarak Google Cloud Ana Sözleşmesi'nin çevrimdışı bir kopyasını imzaladıysanız bu Firebase hizmetlerini kullanımınız Firebase Şartları'na tabi değildir ve bu Firebase hizmetlerini kullanımınız, imzaladığınız çevrimdışı şartlara tabidir.

"Firebase eklemek" için hangi izinler gereklidir?

Mevcut bir Google Cloud projesine "Firebase eklemek" için proje üyelerinin (yani asıl kullanıcıların) 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'i eklemek için firebase:enabled etiketini eklemek yeterli mi?

Tüm Firebase projelerinin, Google Cloud konsolunun Etiketler sayfasında firebase:enabled etiketi bulunur.

Ancak firebase:enabled etiketini proje etiketleri listenize manuel olarak eklemek, Google Cloud projeniz için Firebase'e özel yapılandırmaları ve hizmetleri etkinleştirmeZ. Bunu yapmak 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 etkin olduğu bir Google Cloud projesidir. Bu nedenle, 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 Etiketler sayfasında firebase:enabled etiketini ekler.

• "Tarayıcı" API anahtarı oluşturur ve bu anahtarı Firebase ile ilgili API'lerle otomatik olarak 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 Kuralları API'si
  • Identity Toolkit API
  • Token Service API

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

Mevcut bir Google Cloud projesine "Firebase ekleme" işlemi 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ştirilmiş bu hizmetlerin tümü devre dışı bırakıldığında, bağımlılıklardan dolayı beklenmedik ve istenmeyen sonuçlar ortaya çıkabilir.

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şenleri manuel olarak devre dışı bırakıp silmeyi seçerseniz bunu son derece dikkatli bir şekilde yapın. Google Cloud projenizin ve projeyle ilişkili uygulamaların devre dışı bıraktığınız ve sildiğiniz öğelerle ilgili hiçbir şeyi kullanmadığından emin olmanız gerekir. Aksi takdirde projeniz veya uygulamanız çalışmayı durdurabilir ya da beklenmedik şekilde davranabilir.

Mevcut bir Google Cloud projesi için "Firebase ekleme" işlemi engellenebilir mi?

Evet, mevcut bir projeye "Firebase ekleme" seçeneğini devre dışı bırakabilirsiniz.Google Cloud İşte bazı seçenekler:

• "İzin verilen Google Cloud API'leri ve hizmetlerini kısıtla" kısıtlamasını kullanarak firebase.googleapis.com API'sinin etkinleştirilmesini engelleyin.

• "Firebase eklemek" için gereken IAM izni firebase.projects.update'ye sahip proje üyelerini (yani, asıl kişileri) sınırlayın. Bu işlemi verimli bir şekilde yapmak için IAM reddetme politikası kullanabilirsiniz.

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 ve bir projenin, uygulamalarının ve kaynaklarının temel hiyerarşisi de dahil olmak üzere Firebase projeleri hakkındaki çeşitli önemli kavramlara kısa bir genel bakış sunar.

  • Firebase projeleri oluşturmayla ilgili genel en iyi uygulamalar: Firebase projeleri oluşturma ve uygulamalarınızı bir projeye kaydetmeyle ilgili genel, üst düzey en iyi uygulamaları sağlar. Böylece farklı ortamlar kullanan net bir geliştirme iş akışı elde edersiniz.

• 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++.