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

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

Firebase konsolu Firebase CLI Otomatik olarak oluşturulan SDK

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 durumunu, kullanımını ve günlüklerini kontrol ederek 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 başka bir tarafın kodunu çalıştırırken özellikle önemli olabilir.

Firebase projeniz için bütçe uyarıları oluşturduğunuzdan emin olun.

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

1. Firebase konsolunun İşlevler kontrol paneline gidin.

2. Kontrol paneli sekmesinde, Firebase Extensions'deki 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 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şi görüntüleme

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

2. İşler listesinde, Firebase Extensions'daki Cloud Scheduler işlerini (projeniz için oluşturduğunuz diğer işlerin yanı sıra) 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ın sıraya eklediği Cloud 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'ı kullanır. Genellikle, 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ıştırılan işlem görevlerini kullanır.

Bu görevler genellikle müdahaleniz olmadan otomatik olarak çalıştırılı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 Task sıraları bölümü bulunur.

3. Yönetmek istediğiniz sıra için Sırayı göster'i tıklayın. Bu işlem, Google Cloud konsolunda sıra ayrıntıları sayfasını açar. Bu sayfada, sıraya alınmış görevleri görüntüleyebilir, sırayı duraklatabilir, sıraya alınmış görevleri kaldırabilir ve daha fazlasını yapabilirsiniz. Cloud Tasks dokümanlarında Sıraları ve görevleri yönetme başlıklı makaleyi inceleyin.

   Not: Bir kuyruğu duraklatabilirsiniz ancak çok uzun süre duraklatırsanız kuyruğu devam ettirdiğinizde görevler kimlik doğrulama hatalarıyla başarısız olabilir. (Görev kimlik doğrulamasının süresi, sıraya eklendikten bir saat sonra dolar.)
   Uyarı: Sıralamayı silmeyin. Uzantı, çalışması için sıraya ihtiyaç duyar. Sıralamayı yanlışlıkla silerseniz aşağıdakileri yapmanız gerekir:

   1. Uzantı için yeni bir örnek yükleyin.
   2. Yalnızca yeni örneği yükledikten sonra eski örneği kaldırın.

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

1. Google Cloud konsolunda projenizin Gizli Yönetici sayfasını açın.

2. Gizli anahtar listesinde, Firebase Extensions için oluşturulan gizli anahtarları (projeniz için oluşturduğunuz diğer gizli anahtarlarla 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

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

1. İşlevler kontrol panelinizin Sağlık sekmesinde, projenizdeki tüm işlevlerin hatalarına ve performans bilgilerine genel bir bakış görebilirsiniz.

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 belirli işlevi bulun.

2. Girişte en sağdaki simgesini (taşma menüsü) tıklayın ve 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 kontrol edebilirsiniz.

Bir uzantının günlüklerini görüntüleme

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

Functions kontrol panelinizin 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üncelleme

Yüklü bir uzantıyı en son sürümüne güncelleyebilirsiniz. Yüklü bir örneği, test, proje veya uygulama iş akışınızda zaten etkin bir şekilde çalıştığı veya ayarlandığı için güncellemek isteyebilirsiniz.

Not: Otomatik olarak oluşturulmuş bir SDK kullanarak uzantı yüklediyseniz konsolu veya CLI'yi değil, aynı yöntemi kullanarak uzantıyı yükseltin.

Bir örneği güncellediğinizde, yeni sürümün kaynak kodu ve dosyalarının kullanılması 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şmez.

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

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ı güncelle'yi tıklayın.

   Uzantı için yeni bir sürüm mevcut değilse ayrıntılar sayfasında güncelleme düğmesi olmaz.

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

Not: Otomatik olarak oluşturulmuş bir SDK kullanarak uzantı yüklediyseniz konsolu veya CLI'yi değil, aynı yöntemi kullanarak yeniden yapılandırın.

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. Eklentinizin parametre değerlerini yeniden yapılandırmak için ekrandaki talimatları uygulayın.

4. Kaydet'i tıklayın.

Not: Bir uzantıdaki değişikliklerin kaydedilmesi 3-5 dakika sürebilir.

Uzantıyı kaldırma

Bir uzantının örneğini Firebase projenizden kaldırabilirsiniz. Bu işlem, hizmet hesabını ve Firebase'ın uzantının bu örneği için özel olarak oluşturduğu tüm kaynakları (ör. bir işlev grubu) 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 bucket). Uzantı bu diğer kaynaklarla etkileşime geçmiş olsa bile bu kaynaklar uzantıya özgü olmadığından uzantı kaldırılırsa silinmez.

Bir uzantıyı kaldırmak için:

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. Hangi öğelerin silineceğini inceleyin ve silme işlemini onaylamak için Uzantıyı kaldır'ı tıklayın.

Not: Uzantı yükleme işlemini otomatik olarak oluşturulan SDK'yı kullanarak yaptıysanız Cloud Functions kodunuzdan örnek yapılandırmasını da kaldırdığınızdan emin olun.