Catch up on highlights from Firebase at Google I/O 2023. Learn more

Yüklü Firebase Uzantılarını yönetin

Uzantıları yüklemek veya yönetmek için size şu rollerden biri atanmalıdır: Sahip veya Düzenleyici veya Firebase Yöneticisi .

Bir projenin yüklü uzantı örneklerini listeleyin

Yüklediğiniz uzantıların her örneğini listeleyebilirsiniz.

extensions-list komutunu çalıştırın:

firebase ext:list --project=projectId-or-alias

Yüklü bir uzantı örneğini izleyin

Firebase konsolunda, kurulu bir uzantının sağlığını, kullanımını ve günlüklerini kontrol etme dahil etkinliğini izleyebilirsiniz.

Bütçe uyarıları ayarlayın

Bütçe uyarıları ayarlamak genel olarak iyi bir uygulamadır, ancak uyarılar, projenizde çalıştırılması için başka bir tarafın koduna güvendiğinizde özellikle önemli olabilir.

Firebase projeniz için bütçe uyarıları ayarladığınızdan emin olun.

Uzantılar tarafından oluşturulan işlevleri görüntüleyin

  1. Firebase konsolunun İşlevler kontrol panelinize gidin.

  2. Kontrol Paneli sekmesinde, Firebase Uzantılarındaki işlevleri (projeniz için dağıttığınız diğer işlevlerin yanı sıra) görüntüleyebilirsiniz.

    Uzantılar tarafından oluşturulan işlevlerin şu biçimde adları vardır: ext- extension-instance-id - functionName

    Örneğin: ext-awesome-task-simplifier-onUserCreate

Uzantılar tarafından oluşturulan Cloud Scheduler işlerini görüntüleyin

  1. Google Cloud Console'da projenizin Cloud Scheduler sayfasını açın.

  2. İşler listesinde, Firebase Uzantılarından Bulut Zamanlayıcı işlerini (projeniz için oluşturduğunuz diğer işlerin yanında) görüntüleyebilirsiniz.

    Uzantılar tarafından oluşturulan işlerin şu biçimde adları vardır: firebase-ext- extension-instance-id - functionName

    Örneğin: firebase-ext-awesome-task-simplifier-doTask

Uzantılar tarafından kuyruğa alınan Bulut Görevlerini görüntüleyin ve yönetin

Bazı uzantılar, daha uzun süreli görevleri çalıştırmak için Bulut Görevlerini kullanır: en yaygın olarak, bir uzantının yaşam döngüsünün çeşitli noktalarında (kurulum, yeniden yapılandırma ve yükseltmelerden sonra) çalışan görevleri işler.

Normalde, bu görevler müdahaleniz olmadan otomatik olarak çalışır ve tamamlanır. Ancak, bir uzantının kuyruğa alınmış görevlerini manuel olarak yönetmeniz gerekirse (örneğin, kuyruğu duraklatmak veya henüz başlamamış bir görevi kuyruktan kaldırmak için) şu adımları izleyin:

  1. Firebase konsolu Uzantıları bölümünde, uzantı örneğinin ayrıntılar sayfasını açın.

  2. Ayrıntılar sayfasında API'ler ve kaynaklar bölümünü açın. Uzantı Bulut Görevleri kullanıyorsa, bir veya daha fazla giriş içeren bir Bulut Görevi sıraları bölümü olacaktır.

  3. Yönetmek istediğiniz sıra için Sırayı görüntüle'ye tıklayın. Bu, Google Cloud Console'da kuyruğa alınmış görevleri görüntüleyebileceğiniz, kuyruğu duraklatabileceğiniz, görevleri sıradan kaldırabileceğiniz vb. işlemler yapabileceğiniz Kuyruk Ayrıntıları sayfasını açacaktır. Bulut Görevleri belgelerinde Kuyrukları ve görevleri yönetme konusuna bakın.

Uzantılar tarafından oluşturulan Cloud Secret Manager sırlarını görüntüleyin

  1. Google Cloud Console'da projenizin Gizli Yönetici sayfasını açın.

  2. Sırlar listesinde, Firebase Uzantıları için oluşturulan sırları (projeniz için oluşturduğunuz diğer sırların yanında) görüntüleyebilirsiniz.

    Uzantılar tarafından oluşturulan gizli diziler şu biçimde adlara sahiptir: ext- extension-instance-id - paramnName

    Örneğin: ext-awesome-task-simplifier-API_KEY

    Sırlar firebase-extensions-managed anahtarıyla etiketlenir. Firebase'in sırrı yönetmesini istemiyorsanız bu etiketi kaldırmayın.

Yüklü bir uzantının sağlıklı olup olmadığını kontrol edin

İşlevlerdeki (Firebase Extensions tarafından oluşturulanlar dahil) tüm hataları konsolda inceleyebilirsiniz.

  1. İşlevler panonuzun Sağlık sekmesinde, projenizdeki tüm işlevler için hatalara ve performans bilgilerine genel bir bakış görüntüleyebilirsiniz.

  2. Belirli bir uzantının bilgilerini görüntülemek için sayfanın üst kısmındaki filtreyi kullanarak belirli bir işlevi seçin.

Yüklü bir uzantının ne sıklıkta çalıştığını kontrol edin

  1. İşlevler kontrol panelinizin Kontrol Paneli sekmesinde, kontrol etmek istediğiniz Firebase Uzantısına özel işlevi bulun.

  2. Girişin en sağındaki (taşma menüsü) öğesini tıklayın, ardından Ayrıntılı kullanım istatistikleri öğesini seçin.

  3. Görüntülenen Google Cloud Konsolunda, bir işlevin çeşitli çağrılarını ayrıntılı olarak inceleyebilir ve hatta kaynak kodunu inceleyebilirsiniz.

Bir uzantı için günlükleri görüntüleyin

Projenizde hata ayıklamaya çalışıyorsanız veya Firebase'e bir hata raporu gönderiyorsanız, projenizde çalışan işlevlerin günlüklerini görüntülemek yararlı olacaktır.

İşlevler panonuzun Günlükler sekmesinde, uzantınız tarafından oluşturulan işlevleri seçmek için sayfanın üst kısmındaki filtreyi kullanın.

Yüklü bir uzantı örneğini en son sürüme güncelleyin

Bir uzantının kurulu bir örneğini, yayınlanan en son sürümüne güncelleyebilirsiniz. Örnek zaten test, proje veya uygulama iş akışınızda aktif olarak çalıştığından veya ayarlandığından, yüklü bir örneği güncellemek isteyebilirsiniz.

Bir örneği güncellediğinizde, yeni sürümün kaynak kodunu ve dosyalarını kullanmak için örneğin uzantıya özgü tüm kaynaklarının ve mantığının üzerine yazılır. Uzantının örnek kimliği ve hizmet hesabı değişmeyecektir.

Güncelleme işlemi sırasında, yeni sürümdeki herhangi bir değişiklik size bildirilecek ve herhangi bir yeni parametre için değer belirtebileceksiniz.

  1. Uzantı bildiriminizdeki bir uzantı örneğini en son sürüme güncellemek için extension update komutunu çalıştırın:

    firebase ext:update extensionInstanceId

    Belirli bir sürüme güncellemek için güncellemek istediğiniz sürümü sağlayın:

    firebase ext:update extensionInstanceId versionNumber
  2. Ardından, bildiriminizdeki uzantıları bir Firebase projesine dağıtmak için şunu çalıştırın:

    firebase deploy --only extensions --project=projectId-or-alias

Yüklü bir uzantı örneğini yeniden yapılandırın

Kurulu bir uzantı örneği için kullanıcı tarafından yapılandırılan parametrelerin değerlerini değiştirebilirsiniz. Bu yeni değerler, örneğin gelecekteki tüm tetikleyicilerinde kullanılacaktır, ancak uzantı tarafından oluşturulan önceki tüm yapılar veya yapısal öğeler (depolanmış görüntüler veya mevcut depolama kutuları gibi) değiştirilmeyecektir.

  1. Extensions manifest dosyanızdaki bir uzantıyı etkileşimli olarak yeniden yapılandırmak için extension configuration komutunu çalıştırın:

    firebase ext:configure extensionInstanceId
  2. Ardından, bildiriminizdeki uzantıları bir Firebase projesine dağıtmak için şunu çalıştırın:

    firebase deploy --only extensions --project=projectId-or-alias

Bir uzantı örneğini kaldırın

Bir uzantı örneğini Firebase projenizden kaldırabilirsiniz. Bu eylem, hizmet hesabını ve Firebase'in uzantının söz konusu örneği için özel olarak oluşturduğu tüm kaynakları (bir dizi işlev gibi) siler. Ancak, aşağıdakiler silinmez :

  • Uzantı tarafından oluşturulan tüm yapılar (depolanan görüntüler gibi).

  • Veritabanı örneği veya Bulut Depolama grubu gibi projenizdeki diğer tüm kaynaklar. Uzantı bu diğer kaynaklarla etkileşime girmiş olsa bile, bunlar uzantıya özgü değildir ve bu nedenle uzantı kaldırılırsa silinmezler.

Bir uzantının nasıl kaldırılacağı aşağıda açıklanmıştır:

  1. Bir uzantı örneğini extensions manifest dosyanızdan kaldırmak için extension uninstall komutunu çalıştırın:

    firebase ext:uninstall extensionInstanceId
  2. Ardından, bildiriminizdeki değişiklikleri bir Firebase projesine dağıtmak için şunu çalıştırın:

    firebase deploy --only extensions --project=projectId-or-alias