Remote Config, Firebase projeniz için oluşturduğunuz JSON biçimli parametre ve koşul kümeleridir. Uygulamanızın değerleri getirdiği istemci şablonları ve sunucu istemcilerinin değerleri getirebileceği sunucu şablonları oluşturabilirsiniz.
Bu bölümde sunucu şablonları ele alınmaktadır. Müşteriye özel şablonlar hakkında bilgi edinmek için Müşteri şablonları'nı tıklayın.Şablonu 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-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 istemci sürümüne geri çekme
- Değişiklik geçmişi sayfasından Remote Config şablonlarını silin.
Şablon türü başına toplam 300 kullanıcı ömrü boyunca depolanan sürüm sınırı vardır (300 istemci şablonu ve 300 sunucu şablonu). Bu sayıya, silinen şablonların depolanan 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 şablonlarda, gösterildiği gibi, söz konusu sürümle ilgili meta verileri içeren bir version alanı bulunur.
Remote Config şablonlarını Firebase konsolunun DevOps & Engagement > Remote Config > Değişiklik geçmişi sayfası bölümünde gerektiği gibi silebilirsiniz.
Remote Config şablon sürümlerini yönetme
Bu bölümde, Remote Config şablonunuzun sürümlerini nasıl yöneteceğiniz açıklanmaktadır.
Remote Config şablonunun saklanan tüm sürümlerini listeleme
Remote Config şablonunun depolanan tüm sürümlerinin listesini alabilirsiniz. Bunun için:
Firebase konsolunda DevOps & Engagement (DevOps ve Etkileşim) > Remote Config > Parameters (Parametreler) sayfasına gidin.
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üncelleyen kullanıcı ve 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 depolanmış 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:
Firebase konsolunda DevOps & Engagement (DevOps ve Etkileşim) > Remote Config > Değişiklik geçmişi sayfasına gidin.
Sayfada varsayılan olarak 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.
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 kayıtlı sürümüne geri çekme
Şablonun depolanan herhangi bir sürümüne geri çekebilirsiniz. Şablonu geri çekmek için aşağıdaki adımları uygulayın:
Firebase konsolunda DevOps & Engagement (DevOps ve Etkileşim) > Remote Config > Değişiklik geçmişi sayfasına gidin.
Geri alma işlemine uygun önceki şablon sürümleri için sayfanın sağ üst kısmındaki seçenek düğmesini bulun.
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 numaralı 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. Orijinal 6. sürüm, geçerlilik süresi dolmamışsa saklanmaya devam eder ve 11. sürüm etkin şablon olur.
Remote Config şablonunu silme
Remote Config şablonlarını Firebase konsolunu kullanarak silebilirsiniz. Şablonu silmek için:
Firebase konsolunda DevOps & Engagement (DevOps ve Etkileşim) > Remote Config > Parameters (Parametreler) sayfasına gidin.
Değişiklik geçmişi 'ni tıklayın.Silmek istediğiniz şablona geçin,
Diğer 'i tıklayın ve Sil'i seçin.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.
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. Örneğin, geliştirme, test, hazırlık ve üretim ortamları. 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 projedeki parametreler ve değerlerle 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:
- Mevcut Remote Config yapılandırma şablonunu indirin.
- Remote Config şablonunu doğrulayın.
- Remote Config şablonunu yayınlayın.
Mevcut Remote Config şablonunu indirme
Etkin Remote Config şablonunu JSON biçiminde indirmek için aşağıdakileri kullanın:
Firebase konsolunda DevOps & Engagement (DevOps ve Etkileşim) > Remote Config > Parameters or Conditions (Parametreler veya Koşullar) sayfasına gidin.
Menü 'yü açın ve Mevcut yapılandırma dosyasını indir'i seçin.İ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üzdelik dilimdeki kullanıcı koşullarının içe aktarılabileceğini ancak desteklenmeyen koşulların yükleme sırasında hataya neden olacağını unutmayın. Başlangıçta bir istemci şablonundan dışa aktarılmış bir şablonu yayınlamaya çalışıyorsanız önce istemciye özel koşulları kaldırdığınızdan emin olun.
Remote Config şablonunu yayınlayın
Şablonu indirip JSON içeriğinde gerekli değişiklikleri yaptıktan ve doğruladıktan sonra şablonu bir projede yayınlayabilirsiniz.
Bir şablon yayınlamak, 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ınlama işleminden 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 bir sürüme geri dönebilirsiniz.
Şablonunuzu yayınlamak için aşağıdaki komutları kullanın:
Firebase konsolunda DevOps & Engagement (DevOps ve Etkileşim) > Remote Config > Parameters or Conditions (Parametreler veya Koşullar) sayfasına gidin.
Menü 'yü açın ve Dosyadan yayınla'yı seçin.İstendiğinde Göz at'ı tıklayın, yayınlamak istediğiniz Remote Config dosyasına gidin ve dosyayı seçin, ardından Seç'i tıklayın.
Dosya doğrulanır ve başarılı olursa yapılandırmayı uygulamalarınızda ve kullanıcılarınızda hemen kullanılabilir hale getirmek için Yayınla'yı tıklayabilirsiniz.
Sonraki adımlar
- Sunucu ortamlarında Remote Config kullanma hakkında daha fazla bilgi edinin.
- Cloud Functions ve Vertex AI ile sunucu tarafı Remote Config etiketlemeyi deneyin.