| Выберите тип шаблона: | Шаблоны клиента Шаблоны сервера |
Шаблоны Remote Config представляют собой наборы параметров и условий в формате JSON, созданные для вашего проекта Firebase. Серверные шаблоны предоставляют конфигурации экземплярам сервера с помощью Firebase Admin SDK для Remote Config (доступен для Node.js, Java, Python и Go).
Для изменения и управления шаблоном сервера вы можете использовать консоль Firebase . Перейдите в раздел DevOps & Engagement > Remote Config, чтобы просмотреть содержимое шаблона в графическом формате на страницах Parameters и Conditions .
Вот пример файла шаблона сервера:
{
"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
}
}
Вы можете выполнять эти задачи по управлению версиями в консоли Firebase (перейдите в раздел DevOps & Engagement > Remote Config ):
- Отобразить все сохраненные версии шаблона
- Получить конкретную версию
- Откат к определенной версии сервера
- Удалите шаблоны Remote Config со страницы истории изменений .
Существует ограничение в 300 сохраненных версий для каждого типа шаблонов за все время их существования (300 клиентских шаблонов и 300 серверных шаблонов), включая номера сохраненных версий для удаленных шаблонов. Если вы опубликуете более 300 версий шаблонов для каждого типа шаблонов за все время существования проекта, самые ранние версии будут удалены, и будет поддерживаться максимальное количество версий этого типа — 300.
При каждом обновлении параметров Remote Config создает новый версионированный шаблон Remote Config и сохраняет предыдущий шаблон в качестве версии, которую можно восстановить или откатить при необходимости. Номера версий увеличиваются последовательно от начального значения, сохраненного Remote Config . Все шаблоны содержат поле version , как показано на рисунке, содержащее метаданные о конкретной версии.
При необходимости вы можете удалить шаблоны Remote Config на странице DevOps & Engagement > Remote Config > Change history в консоли Firebase .
Управление версиями шаблонов Remote Config
В этом разделе описывается, как управлять версиями шаблона сервера Remote Config .
Отобразить список всех сохраненных версий шаблона Remote Config
Вы можете получить список всех сохраненных версий шаблона Remote Config . Для этого:
В консоли Firebase перейдите на страницу DevOps & Engagement > Remote Config > Parameters .
Выберите значок «часы», расположенный в правом верхнем углу.
Это откроет страницу истории изменений , на которой в меню справа будет перечислены все сохраненные версии шаблона.
Список шаблонов содержит метаданные для всех сохраненных версий, включая время обновления, пользователя, который его внес, и способ его выполнения.
Получить конкретную версию шаблона Remote Config
Вы можете получить доступ к любой конкретной сохраненной версии шаблона Remote Config . Вот как получить доступ к сохраненной версии шаблона:
В консоли Firebase перейдите на страницу DevOps & Engagement > Remote Config > Change history .
По умолчанию на странице отображается текущий активный шаблон. Чтобы просмотреть другую версию, выберите её в панели сведений справа.
Для просмотра подробного сравнения активного шаблона и любой другой сохраненной версии наведите курсор на контекстное меню любой невыбранной версии и выберите пункт «Сравнить с выбранной версией».
Откат к определенной сохраненной версии шаблона Remote Config
Вы можете вернуться к любой сохраненной версии шаблона. Вот как это сделать:
В консоли Firebase перейдите на страницу DevOps & Engagement > Remote Config > Change history .
Найдите кнопку в правом верхнем углу страницы, чтобы просмотреть предыдущие версии шаблона, которые можно откатить.
Нажмите и подтвердите это только в том случае, если вы уверены, что хотите вернуться к предыдущей версии и немедленно использовать эти значения для всех приложений и пользователей.
Обратите внимание, что эта операция отката фактически создает новую версию с номером. Например, откат с версии 10 до версии 6 фактически создает новую копию версии 6, отличающуюся от оригинала только тем, что ее номер версии равен 11. Оригинальная версия 6 по-прежнему сохраняется, если срок ее действия еще не истек, а версия 11 становится активным шаблоном.
Удалить шаблон Remote Config
Удалить шаблоны Remote Config можно с помощью консоли Firebase . Вот как удалить шаблон:
В консоли Firebase перейдите на страницу DevOps & Engagement > Remote Config > Parameters .
Нажмите
. Изменить историю . Переключитесь на шаблон, который хотите удалить, и нажмите
More , затем выберите Delete . Когда появится запрос на подтверждение удаления, нажмите «Удалить» .
Загрузите и опубликуйте шаблоны Remote Config .
Загрузите и опубликуйте шаблоны Remote Config , чтобы интегрировать их в ваши системы контроля версий и сборки, автоматизировать обновления конфигурации и синхронизировать параметры и значения в нескольких проектах.
Вы можете загрузить текущий активный шаблон Remote Config из консоли Firebase . Затем вы можете обновить экспортированный JSON-файл и опубликовать его в том же проекте, или опубликовать его в новом или существующем проекте.
Например, предположим, у вас есть несколько проектов, представляющих разные этапы жизненного цикла разработки программного обеспечения, такие как среда разработки, тестирования, промежуточная и производственная среды. В этом случае вы можете перенести полностью протестированный шаблон из промежуточной среды в производственную, загрузив его из промежуточного проекта и опубликовав в производственный проект.
Этот метод также можно использовать для переноса конфигураций из одного проекта в другой или для заполнения нового проекта параметрами и значениями из существующего проекта.
Параметры и значения параметров, созданные специально в качестве вариантов в эксперименте A/B Testing не включаются в экспортируемые шаблоны.
Для экспорта и импорта шаблонов Remote Config :
- Загрузите текущий шаблон Remote Config .
- Проверьте шаблон Remote Config .
- Опубликуйте шаблон Remote Config .
Загрузите текущий шаблон Remote Config .
Для загрузки активного шаблона Remote Config в формате JSON используйте следующую команду:
В консоли Firebase перейдите на страницу DevOps & Engagement > Remote Config > Parameters or Conditions .
Откройте
В меню выберите «Загрузить текущий файл конфигурации» . При появлении запроса нажмите «Скачать файл конфигурации» , выберите место, куда хотите сохранить файл, а затем нажмите «Сохранить» .
Проверьте шаблон Remote Config .
При попытке публикации из консоли Firebase серверные шаблоны проходят проверку. Условия, использующие правило « Пользователь в случайном процентном соотношении» , могут быть импортированы, но любое неподдерживаемое условие вызовет ошибку во время загрузки. Если вы пытаетесь опубликовать шаблон, который изначально был экспортирован из клиентского шаблона, обязательно сначала удалите все условия, специфичные для клиента.
Опубликуйте шаблон Remote Config .
После загрузки шаблона, внесения необходимых изменений в JSON-содержимое и его проверки, вы можете опубликовать его в проекте.
Публикация шаблона заменяет весь существующий шаблон конфигурации обновленным файлом и увеличивает номер версии шаблона на единицу. Поскольку заменяется вся конфигурация, если вы удалите параметр из JSON-файла и опубликуете его, этот параметр будет удален с сервера и больше не будет доступен клиентам.
После публикации изменения параметров и значений немедленно становятся доступны вашим приложениям и пользователям. При необходимости вы можете откатиться к предыдущей версии .
Для публикации шаблона выполните следующие действия:
В консоли Firebase перейдите на страницу DevOps & Engagement > Remote Config > Parameters or Conditions .
Откройте
В меню выберите «Опубликовать из файла» . При появлении запроса нажмите «Обзор» , найдите и выберите файл Remote Config который хотите опубликовать, затем нажмите «Выбрать» .
Файл проверен. Если проверка прошла успешно, нажмите «Опубликовать», чтобы немедленно сделать конфигурацию доступной для ваших приложений и пользователей.
Следующие шаги
- Узнайте больше об использовании Remote Config в серверных средах .
- Попробуйте Remote Config стороне сервера с помощью Cloud Functions for Firebase и Agent Platform .