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 parametre ve koşul kümeleridir. Sunucu şablonları, Remote Config için Firebase Admin SDK kullanarak 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. Şablonun içeriğini Parametreler sayfasında ve Koşullar sayfasında grafik biçiminde görüntülemek için DevOps ve Etkileşim > Remote Config'e gidin.

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-3.8-flash"
      },
      "valueType": "STRING"
    },
    "generation_config": {
      "defaultValue": {
        "value": "{\"maxOutputTokens\": 2048}"
      },
      "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 dönme
  • Değişiklik geçmişi sayfasından Remote Config şablonu silin.

Şablon türü başına toplam 300 kayıtlı sürüm sınırı vardır (300 istemci şablonu ve 300 sunucu şablonu). Bu sınıra, silinen şablonların kayıtlı 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üme sahip 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 itibaren sırayla artırılır. Tüm şablonlar, gösterildiği gibi ilgili sürümle ilgili meta verileri içeren bir version alanı içerir.

Remote Config şablonlarını, Firebase konsolunun DevOps ve Etkileşim > Remote Config > Değişiklik geçmişi sayfasında gerektiği şekilde silebilirsiniz.

Remote Config şablon sürümünü yönetme

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

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

Remote Config şablonunun depolanan tüm sürümlerinin listesini alabilirsiniz. Bunun için:

  1. Firebase konsolunda DevOps & Engagement > Remote Config > Parameters sayfasına gidin.

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

    Bu işlem, sağdaki 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üncellemeyi yapan kullanıcı ve güncellemenin nasıl yapıldığı dahil olmak üzere tüm depolanan sürümlerin meta verileri yer alır.

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

Remote Config şablonunun depolanan belirli bir sürümünü alabilirsiniz. Kayıtlı bir şablon sürümünü şu şekilde alabilirsiniz:

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

  2. Sayfada varsayılan olarak mevcut etkin şablon gösterilir. Farklı bir sürümü görüntülemek için sağdaki ayrıntı penceresinden ilgili sürümü seçin.

  3. Seçili olmayan herhangi bir sürümün bağlam menüsünün üzerine gelip Seçili sürümle karşılaştır'ı seçerek etkin şablon ile diğer kayıtlı sürümler arasındaki farkları ayrıntılı olarak görüntüleyebilirsiniz.

Remote Config şablonunun depolanan belirli bir sürümüne geri dönme

Şablonun depolanan herhangi bir sürümüne geri dönebilirsiniz. Bir şablonu nasıl geri alacağınız aşağıda açıklanmıştır:

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

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

  3. Yalnızca bu sürüme geri dönmek ve bu değerleri tüm uygulamalar ve kullanıcılar için hemen kullanmak istediğinizden eminseniz bu seçeneği tıklayıp onaylayın.

Bu geri alma işleminin, numaralandırılmış yeni bir sürüm oluşturduğunu unutmayın. Örneğin, 10. sürümden 6. sürüme geri dönüldüğünde 6. sürümün yeni bir kopyası oluşturulur. Bu kopya, orijinalinden yalnızca sürüm numarasının 11 olmasıyla ayrılır. Orijinal sürüm 6, geçerlilik süresi dolmadığı varsayılarak depolanmaya devam eder ve sürüm 11 etkin şablon olur.

Remote Config şablonunu silme

Firebase konsolunu kullanarak Remote Config şablonlarını silebilirsiniz. Şablonları silmek için:

  1. Firebase konsolunda DevOps & Engagement > Remote Config > Parameters sayfasına gidin.

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

  3. Silmek istediğiniz şablona gidin, 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 şablonu indirin ve yayınlayın

Remote Config şablonlarını indirip yayınlayarak kaynak denetimi ve derleme sistemlerinize entegre edin, yapılandırma güncellemelerini otomatikleştirin ve parametreler ile değerleri birden fazla projede senkronize edin.

Şu anda etkin olan Remote Config şablonunu Firebase konsolundan indirebilirsiniz. Ardından, dışa aktarılan JSON dosyasını güncelleyip aynı projede yayınlayabilir 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ı (geliştirme, test, hazırlık ve üretim ortamları gibi) temsil eden birden fazla projeniz olduğunu varsayalım. Bu durumda, tam olarak test edilmiş bir şablonu hazırlık projenizden indirip üretim projenizde yayınlayarak hazırlık ortamınızdan üretim ortamınıza yükseltebilirsiniz.

Bu yöntemi kullanarak yapılandırmaları bir projeden diğerine taşıyabilir veya yeni bir projeyi, mevcut bir projenin parametreleri ve değerleriyle doldurabilirsiniz.

Bir denemede varyant olarak özel olarak oluşturulan parametreler ve parametre değerleri, dışa aktarılan şablonlara dahil edilmez.A/B Testing

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 > Remote Config > 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üzde aralığındaki kullanıcı kuralını kullanan koşullar içe aktarılabilir ancak desteklenmeyen koşullar yükleme sırasında hataya neden olur. Başlangıçta bir müşteri şablonundan dışa aktarılan bir şablonu yayınlamaya çalışıyorsanız öncelikle 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 bir projede yayınlayabilirsiniz.

Bir şablonu yayınladığınızda mevcut yapılandırma şablonunun tamamı güncellenmiş dosyayla değiştirilir ve şablon sürümü bir artırılır. Yapılandırmanın tamamı değiştirildiğinden, JSON dosyasından bir parametreyi 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 tarafından hemen kullanılabilir. Gerekirse önceki bir sürüme geri dönebilirsiniz.

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

  1. Firebase konsolunda DevOps & Engagement > Remote Config > 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 gidip dosyayı seçin ve 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