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

Uzantıları yüklemek veya yönetmek için şu rollerden birine atanmış olmanız gerekir: Sahip veya Düzenleyici ya da Firebase Yöneticisi.


Bir projenin yüklü uzantı örneklerini listeleme

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ğinin ayrıntılarını ve yapılandırmasını görüntüleme

  1. Firebase konsolunda Firebase Extensions kontrol panelinize gidin.

  2. Yüklü uzantı örneğinin kartında Yönet'i tıklayın.

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

Firebase konsolunda, yüklü bir uzantının etkinliğini (durum, kullanım ve günlüklerle ilgili kontroller dahil) izleyebilirsiniz.

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

Bütçe uyarıları ayarlamak genel olarak iyi bir uygulamadır ancak başka bir tarafın kodunun projenizde çalışmasına güveniyorsanız uyarılar ö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üleme

  1. Firebase konsolunun Functions kontrol paneline gidin.

  2. Kontrol paneli sekmesinde, Firebase Extensions'daki işlevleri (projeniz için dağıttığınız diğer işlevlerle birlikte) görüntüleyebilirsiniz.

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

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

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

  1. Google Cloud konsolunda projenizin Cloud Scheduler sayfasını açın.

  2. İşler listesinde, Cloud Scheduler işlerini Firebase Extensions (projeniz için oluşturduğunuz diğer işlerle birlikte) görüntüleyebilirsiniz.

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

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

Uzantılar tarafından sıraya alınan Cloud Tasks görevlerini görüntüleme ve yönetme

Bazı uzantılar, daha uzun süren görevleri çalıştırmak için Cloud Tasks'i kullanır. En yaygın olarak, bir uzantının yaşam döngüsünün çeşitli noktalarında (yükleme, yeniden yapılandırma ve yükseltmelerden sonra) çalışan işleme görevleri kullanılır.

Bu görevler normalde sizin müdahaleniz olmadan otomatik olarak çalışır ve tamamlanır. Ancak, bir uzantının sıraya alınmış görevlerini manuel olarak yönetmeniz gerekirse (ör. sırayı duraklatmak veya henüz başlamamış bir görevi sıradan kaldırmak için) aşağıdaki adımları uygulayın:

  1. Firebase konsolunun 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ı Cloud Tasks kullanıyorsa bir veya daha fazla giriş içeren bir Cloud Tasks sıraları bölümü olur.

  3. Yönetmek istediğiniz sıra için Sırayı görüntüle'yi tıklayın. Bu işlem, Google Cloud konsolunda Kuyruk Ayrıntıları sayfasını açar. Bu sayfada, kuyruğa alınan görevleri görüntüleyebilir, kuyruğu duraklatabilir, görevleri kuyruktan kaldırabilirsiniz. Cloud Tasks dokümanlarındaki Sıraları ve görevleri yönetme bölümüne bakın.

Uzantılar tarafından oluşturulan Cloud Secret Manager gizli anahtarlarını görüntüleme

  1. Google Cloud konsolunda projenizin Secret Manager sayfasını açın.

  2. Gizli diziler listesinde, Firebase Extensions için oluşturulan gizli dizileri (projeniz için oluşturduğunuz diğer gizli dizilerle birlikte) görüntüleyebilirsiniz.

    Uzantılar tarafından oluşturulan gizli anahtarların adları şu biçimdedir: ext-extension-instance-id-paramnName

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

    Gizli anahtarlar firebase-extensions-managed anahtarıyla etiketlenir. Firebase'in gizli anahtarı yönetmesini durdurmak istemiyorsanız bu etiketi kaldırmayın.

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

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

  1. İşlevler kontrol panelinizin Sağlık sekmesinde, projenizdeki tüm işlevlerle ilgili hatalara ve performans bilgilerine genel bir bakış sunan bir görünüm elde edebilirsiniz.

  2. Belirli bir uzantıyla ilgili bilgileri 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 etme

  1. İşlevler kontrol panelinizin Kontrol paneli sekmesinde, kontrol etmek istediğiniz Firebase Extension için ilgili işlevi bulun.

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

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

Uzantıların günlüklerini görüntüleme

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

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

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

Yüklü bir uzantı örneğini, yayınlanan en son sürüme güncelleyebilirsiniz. Yüklü bir örneği güncellemek isteyebilirsiniz. Bunun nedeni, örneğin test, proje veya uygulama iş akışınızda zaten etkin olarak çalışıyor ya da ayarlanmış olmasıdır.

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

Güncelleme işlemi sırasında, yeni sürümdeki değişiklikler size bildirilir ve yeni parametreler için değerler belirleyebilirsiniz.

  1. Firebase Extensions kontrol panelinize gidin. Yüklü uzantı örneğinin kartında Yönet'i tıklayın.

  2. Sağ üst köşede Uzantıyı güncelle'yi tıklayın.

    Uzantının yeni bir sürümü yoksa ayrıntılar sayfasında güncelleme düğmesi bulunmaz.

  3. Güncellemedeki yenilikleri inceleyin ve uzantıyı yapılandırın (gerekirse).

  4. Uzantıyı güncelle'yi tıklayın.

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

Yüklü 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 tetikleyicilerde kullanılır ancak uzantı tarafından oluşturulan önceki tüm yapılar veya yapısal öğeler (ör. depolanan resimler ya da mevcut depolama paketleri) değiştirilmez.

  1. Firebase Extensions kontrol panelinize gidin ve yüklü uzantı örneğinin kartında Yönet'i tıklayın.

  2. Sağ üst köşede Uzantıyı yeniden yapılandır'ı tıklayın.

  3. Uzantınızın parametre değerlerini yeniden yapılandırmak için ekrandaki talimatları uygulayın.

  4. Kaydet'i tıklayın.

Uzantı örneğini kaldırma

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

  • Uzantı tarafından oluşturulan yapılar (ör. depolanan resimler).

  • Projenizdeki diğer kaynaklar (ör. veritabanı örneği veya Cloud Storage paketi). Uzantı bu diğer kaynaklarla etkileşimde bulunsa bile bunlar uzantıya özgü olmadığından uzantı kaldırıldığında silinmez.

Uzantıları kaldırmak için şu adımları uygulayın:

  1. Firebase Extensions kontrol panelinize gidin ve yüklü uzantı örneğinin kartında Yönet'i tıklayın.

  2. Ekranın alt kısmında Uzantıyı kaldır'ı tıklayın.

  3. Silinecek öğeleri inceleyin ve ardından silme işlemini onaylamak için Uzantıyı kaldır'ı tıklayın.