Remote Config sunucu şablonlarını ve sürüm oluşturmayı yönetme

Şablon türünü seçin: İstemci şablonları Sunucu şablonları


Remote Config şablonları, Firebase projeniz için oluşturulan JSON biçimli parametreler ve koşullar kümeleridir. Sunucu şablonları, Firebase Admin SDK için Remote Config kullanılarak sunucu örneklerine yapılandırmalar sunar (Node.js, Java, Python ve Go için kullanılabilir).

Sunucu şablonunuzu değiştirmek ve yönetmek için Firebase konsolunu kullanabilirsiniz. DevOps ve Etkileşim > Remote Config'e giderek şablonun içeriğini Parametreler sayfasında ve Koşullar sayfasında grafik biçiminde görüntüleyin.

Aşağıda bir sunucu şablonu dosyası örneği verilmiştir:

{
  "parameters": {
    "preamble_prompt": {
      "defaultValue": {
        "value": "You are a helpful assistant who knows everything there is to know about Firebase! "
      },
      "description": "Add this prompt to the user's prompt",
      "valueType": "STRING"
    },
    "model_name": {
      "defaultValue": {
        "value": "gemini-pro-test"
      },
      "valueType": "STRING"
    },
    "generation_config": {
      "defaultValue": {
        "value": "{\"temperature\": 0.9, \"maxOutputTokens\": 2048, \"topP\": 0.9, \"topK\": 20}"
      },
      "valueType": "JSON"
    }
  },
  "version": {
    "versionNumber": "19",
    "isLegacy": true
  }
}

Bu sürüm yönetimi görevlerini Firebase konsolunda gerçekleştirebilirsiniz (DevOps ve Etkileşim > Remote Config'e gidin):

  • Saklanan tüm şablon sürümlerini listeleme
  • Belirli bir sürümü alma
  • Belirli bir sunucu sürümüne geri çekme
  • Değişiklik geçmişi sayfasından Remote Config şablonu silin.

Şablon türü başına toplam 300 kullanıcı ömrü boyunca saklanan sürüm sınırı vardır (300 istemci şablonu ve 300 sunucu şablonu). Bu sayıya, silinen şablonların saklanan sürüm numaraları da dahildir. Bir projenin kullanım ömrü boyunca şablon türü başına 300'den fazla şablon sürümü yayınlarsanız en eski sürümler silinir ve bu türden en fazla 300 sürüm korunur.

Parametreleri her güncellediğinizde Remote Config, yeni bir sürüm oluşturulmuş Remote Config şablonu oluşturur ve önceki şablonu, gerektiğinde alabileceğiniz veya geri dönebileceğiniz bir sürüm olarak saklar. Sürüm numaraları, Remote Config tarafından depolanan ilk değerden başlayarak sırayla artırılır. Tüm şablonlar, gösterildiği gibi version alanını içerir. Bu alan, söz konusu sürüme ait meta verileri içerir.

Firebase konsolunun DevOps & Engagement > Remote Config > Değişiklik geçmişi sayfasında Remote Config şablonlarını gerektiği gibi silebilirsiniz.

Remote Config şablon sürümlerini yönetme

Bu bölümde, Remote Config sunucu şablonunuzun sürümlerini nasıl yöneteceğiniz açıklanmaktadır.

Remote Config şablonunun saklanan tüm sürümlerini listeleme

Remote Config Şablonun saklanan tüm sürümlerinin listesini alabilirsiniz. Bunun için:

  1. Firebase konsolunda DevOps & Engagement (DevOps ve Etkileşim) > Remote Config > Parameters (Parametreler) sayfasına gidin.

  2. Sağ üstte gösterilen "saat" simgesini seçin.

    Bu işlem, sağ taraftaki bir liste menüsünde depolanan tüm şablon sürümlerini listeleyen Değişiklik geçmişi sayfasını açar.

    Şablon listesinde, güncelleme zamanı, güncelleyen kullanıcı ve güncellemenin nasıl yapıldığı dahil olmak üzere, depolanan tüm sürümlerin meta verileri yer alır.

Remote Config şablonunun belirli bir sürümünü alma

Remote Config şablonunun saklanan belirli bir sürümünü alabilirsiniz. Kayıtlı bir şablon sürümünü nasıl alacağınız aşağıda açıklanmıştır:

  1. Firebase konsolunda DevOps & Engagement > Remote Config > Değişiklik geçmişi sayfasına gidin.

  2. Sayfada varsayılan olarak şu anda etkin olan şablon gösterilir. Farklı bir sürümü görüntülemek için sağdaki ayrıntılar bölmesinden ilgili sürümü seçin.

  3. Etkin şablonun ve depolanan diğer sürümlerin ayrıntılı farkını görüntülemek için seçilmeyen bir sürümün bağlam menüsünün üzerine gelin ve Seçili sürümle karşılaştır'ı seçin.

Remote Config şablonunun belirli bir depolanmış sürümüne geri çekme

Şablonun depolanan herhangi bir sürümüne geri dönebilirsiniz. Şablonu geri çekmek için aşağıdaki adımları uygulayın:

  1. Firebase konsolunda DevOps & Engagement > Remote Config > Değişiklik geçmişi sayfasına gidin.

  2. Geri alma işlemine uygun önceki şablon sürümleri için sayfanın sağ üst kısmındaki seçenek düğmesini bulun.

  3. Bu işlemi yalnızca söz konusu sürüme geri dönmek ve bu değerleri tüm uygulamalar ve kullanıcılar için hemen kullanmak istediğinizden eminseniz tıklayın ve onaylayın.

Bu geri alma işleminin, yeni bir numaralandırılmış sürüm oluşturduğunu unutmayın. Örneğin, 10. sürümden 6. sürüme geri dönmek, 6. sürümün yeni bir kopyasını oluşturur. Bu kopya, orijinalinden yalnızca sürüm numarasının 11 olmasıyla farklıdır. Geçerlilik süresi dolmamışsa orijinal sürüm 6 depolanmaya devam eder ve sürüm 11 etkin şablon haline gelir.

Remote Config şablonunu silme

Remote Config şablonlarını Firebase konsolunu kullanarak silebilirsiniz. Şablon silmek için aşağıdaki adımları uygulayın:

  1. Firebase konsolunda DevOps & Engagement (DevOps ve Etkileşim) > Remote Config > Parameters (Parametreler) sayfasına gidin.

  2. Değişiklik geçmişi'ni tıklayın.

  3. Silmek istediğiniz şablona geçin, Diğer'i tıklayın ve Sil'i seçin.

  4. Silme işlemini onaylamanız istendiğinde Sil'i tıklayın.

Remote Config şablonlarını indirip yayınlama

Remote Config şablonlarını indirip yayınlayarak bunları kaynak kontrolü ve derleme sistemlerinize entegre edin, yapılandırma güncellemelerini otomatikleştirin ve parametrelerle değerleri birden fazla proje arasında senkronize tutun.

Şu anda etkin olan Remote Config şablonunu Firebase konsolundan indirebilirsiniz. Ardından, dışa aktarılan JSON dosyasını güncelleyip aynı projede veya yeni ya da mevcut bir projede yayınlayabilirsiniz.

Örneğin, yazılım geliştirme yaşam döngünüzün farklı aşamalarını temsil eden birden fazla projeniz olduğunu varsayalım. Bu aşamalar arasında geliştirme, test, hazırlık ve üretim ortamları yer alıyor. Bu durumda, hazırlama projenizden indirip üretim projenizde yayınlayarak hazırlama ortamınızdaki tam olarak test edilmiş bir şablonu üretim ortamınıza yükseltebilirsiniz.

Bu yöntemi, yapılandırmaları bir projeden diğerine taşımak veya yeni bir projeyi yerleşik bir projenin parametreleri ve değerleriyle doldurmak için de kullanabilirsiniz.

Özellikle bir A/B Testing denemesindeki varyantlar olarak oluşturulan parametreler ve parametre değerleri, dışa aktarılan şablonlara dahil edilmez.

Remote Config şablonlarını dışa ve içe aktarmak için:

  1. Mevcut Remote Config şablonunu indirin.
  2. Remote Config şablonunu doğrulayın.
  3. Remote Config şablonunu yayınlayın.

Mevcut Remote Config şablonunu indirin

Etkin Remote Config şablonunu JSON biçiminde indirmek için aşağıdakileri kullanın:

  1. Firebase konsolunda DevOps & Engagement (DevOps ve Etkileşim) > Remote Config (Uzaktan Yapılandırma) > Parameters or Conditions (Parametreler veya Koşullar) sayfasına gidin.

  2. Menü'yü açın ve Mevcut yapılandırma dosyasını indir'i seçin.

  3. İstendiğinde Yapılandırma dosyasını indir'i tıklayın, dosyayı kaydetmek istediğiniz konumu seçin ve Kaydet'i tıklayın.

Remote Config şablonunu doğrulama

Sunucu şablonları, Firebase konsolundan yayınlamaya çalıştığınızda doğrulanır. Rastgele yüzdede kullanıcı kuralını kullanan koşullar içe aktarılabilir ancak desteklenmeyen koşullar yükleme sırasında hata oluşturur. Başlangıçta bir müşteri şablonundan dışa aktarılmış bir şablonu yayınlamaya çalışıyorsanız önce müşteriye özel koşulları kaldırdığınızdan emin olun.

Remote Config şablonunu yayınlama

Bir şablonu indirip JSON içeriğinde gerekli değişiklikleri yaptıktan ve doğruladıktan sonra şablonu bir projede yayınlayabilirsiniz.

Bir şablonun yayınlanması, mevcut yapılandırma şablonunun tamamını güncellenmiş dosyayla değiştirir ve şablon sürümünü bir artırır. Yapılandırmanın tamamı değiştirildiğinden, bir parametreyi JSON dosyasından silip yayınlarsanız parametre sunucudan silinir ve artık istemciler tarafından kullanılamaz.

Yayınlandıktan sonra parametrelerde ve değerlerde yapılan değişiklikler uygulamalarınız ve kullanıcılarınız için hemen kullanılabilir. Gerekirse önceki sürüme geri dönebilirsiniz.

Şablonunuzu yayınlamak için aşağıdaki adımları uygulayın:

  1. Firebase konsolunda DevOps & Engagement (DevOps ve Etkileşim) > Remote Config (Uzaktan Yapılandırma) > Parameters or Conditions (Parametreler veya Koşullar) sayfasına gidin.

  2. Menü'yü açın ve Dosyadan yayınla'yı seçin.

  3. İstendiğinde Göz at'ı tıklayın, yayınlamak istediğiniz Remote Config dosyasına gidin ve bu dosyayı seçin, ardından Seç'i tıklayın.

  4. Dosya doğrulanır. Doğrulama başarılı olursa yapılandırmayı uygulamalarınız ve kullanıcılarınız için hemen kullanılabilir hale getirmek üzere Yayınla'yı tıklayın.

Sonraki adımlar