| Выберите тип шаблона: | Клиентские шаблоны Серверные шаблоны |
Шаблоны Remote Config – это наборы параметров и условий в формате JSON, созданные для вашего проекта Firebase. Шаблоны серверов передают конфигурации экземплярам серверов с помощью Firebase Admin SDK для Remote Config (доступно для Node.js, Java, Python и Go).
Для изменения серверного шаблона и управления им можно использовать консоль Firebase. Перейдите в раздел DevOps & Engagement (DevOps и вовлечение) > 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-4-hydrogen"
},
"valueType": "STRING"
},
"generation_config": {
"defaultValue": {
"value": "{\"maxOutputTokens\": 2048}"
},
"valueType": "JSON"
}
},
"version": {
"versionNumber": "19",
"isLegacy": true
}
}
В консоли Firebase можно выполнять следующие задачи по управлению версиями (выберите DevOps & Engagement (DevOps и вовлечение) > Remote Config (Удаленная конфигурация)):
- Показать список всех сохраненных версий шаблона
- Как получить определенную версию
- Как выполнить откат до определенной версии сервера
- Удалите Remote Config шаблонов на странице История изменений.
Для каждого типа шаблонов можно сохранить не более 300 версий (300 клиентских и 300 серверных шаблонов), включая номера версий удаленных шаблонов. Если за время существования проекта вы опубликуете более 300 версий шаблонов одного типа, самые ранние версии будут удалены, чтобы сохранить максимальное количество версий этого типа (300).
При каждом обновлении параметров Remote Config создает новую версию шаблона Remote Config и сохраняет предыдущую версию, которую можно восстановить или к которой можно вернуться при необходимости. Номера версий увеличиваются последовательно, начиная с исходного значения, которое хранится в Remote Config.
Все шаблоны содержат поле version, в котором указаны метаданные о конкретной версии.
При необходимости вы можете удалить шаблоны Remote Config. Для этого в консоли Firebase перейдите в раздел DevOps & Engagement (DevOps и вовлечение) > Remote Config (Удаленная конфигурация) > Change history (История изменений).
Управление версиями шаблона "Remote Config"
В этом разделе описывается, как управлять версиями серверного шаблона Remote Config.
Список всех сохраненных версий шаблона Remote Config
Вы можете получить список всех сохраненных версий шаблона Remote Config. Вот как это сделать:
В консоли Firebase перейдите в раздел DevOps & Engagement (DevOps и вовлечение) > Remote Config (Удаленная конфигурация) > Parameters (Параметры).
Нажмите на значок часов в правом верхнем углу.
Откроется страница История изменений, на которой в меню справа будут перечислены все сохраненные версии шаблона.
В списке шаблонов содержатся метаданные для всех сохраненных версий, включая время обновления, пользователя, который его выполнил, и способ обновления.
Получить определенную версию шаблона Remote Config
Вы можете получить любую сохраненную версию шаблона Remote Config. Чтобы получить сохраненную версию шаблона, выполните следующие действия:
В консоли Firebase перейдите на страницу DevOps & Engagement (DevOps и вовлечение) > Remote Config (Удаленная конфигурация) > Change history (История изменений).
По умолчанию на странице показывается текущий активный шаблон. Чтобы посмотреть другую версию, выберите ее на панели подробностей справа.
Чтобы посмотреть подробные различия между активным шаблоном и любой другой сохраненной версией, наведите указатель мыши на контекстное меню для любой невыбранной версии и выберите Сравнить с выбранной версией.
Откат к определенной сохраненной версии шаблона Remote Config
Вы можете выполнить откат к любой сохраненной версии шаблона. Вот как это сделать:
В консоли Firebase перейдите на страницу DevOps & Engagement (DevOps и вовлечение) > Remote Config (Удаленная конфигурация) > Change history (История изменений).
Найдите кнопку в правом верхнем углу страницы, чтобы посмотреть предыдущие версии шаблона, к которым можно вернуться.
Нажимайте на эту кнопку, только если вы уверены, что хотите вернуться к предыдущей версии и немедленно применить ее значения для всех приложений и пользователей.
Обратите внимание, что при откате создается новая версия с номером. Например, если вы откатите версию 10 до версии 6, будет создана новая копия версии 6, которая будет отличаться от оригинала только номером версии (11). Исходная версия 6 по-прежнему хранится, если не истек срок ее действия, а версия 11 становится активным шаблоном.
Удалить шаблон "Remote Config"
Вы можете удалить шаблоны Remote Config в консоли Firebase. Вот как удалить шаблон:
В консоли Firebase перейдите в раздел DevOps & Engagement (DevOps и вовлечение) > Remote Config (Удаленная конфигурация) > Parameters (Параметры).
Нажмите
История изменений .Перейдите к шаблону, который нужно удалить, нажмите
Ещё и выберите Удалить.Подтвердите удаление, нажав Удалить.
Скачать и опубликовать Remote Config шаблонов
Скачайте и опубликуйте шаблоны Remote Config, чтобы интегрировать их в системы контроля версий и сборки, автоматизировать обновление конфигураций и синхронизировать параметры и значения в нескольких проектах.
Вы можете скачать активный шаблон Remote Config из консоли Firebase. Затем вы можете обновить экспортированный JSON-файл и опубликовать его в том же проекте или опубликовать его в новом или существующем проекте.
Например, у вас может быть несколько проектов, представляющих разные этапы жизненного цикла разработки ПО, такие как разработка, тестирование, промежуточная и рабочая среды. В этом случае вы можете перенести полностью протестированный шаблон из тестовой среды в рабочую, скачав его из тестового проекта и опубликовав в рабочем.
Этот метод также можно использовать для переноса конфигураций из одного проекта в другой или для заполнения нового проекта параметрами и значениями из существующего проекта.
Параметры и значения параметров, созданные специально в качестве вариантов в эксперименте
Чтобы экспортировать и импортировать шаблоны Remote Config, выполните следующие действия:
- Скачайте текущий шаблон Remote Config.
- Проверьте шаблон Remote Config.
- Опубликуйте шаблон Remote Config.
Скачайте текущий шаблон Remote Config
Чтобы скачать активный шаблон Remote Config в формате JSON, используйте следующий код:
В консоли Firebase перейдите на страницу DevOps & Engagement (DevOps и вовлечение) > Remote Config (Удаленная конфигурация) > Parameters or Conditions (Параметры или условия).
Откройте
меню и выберите Скачать текущий файл конфигурации.Когда появится запрос, нажмите Скачать файл конфигурации, выберите место для сохранения файла и нажмите Сохранить.
Проверьте шаблон Remote Config
Серверные шаблоны проверяются при попытке публикации из консоли Firebase. Условия, в которых используется правило Пользователь в случайной выборке, можно импортировать, но при загрузке неподдерживаемых условий возникнет ошибка. Если вы хотите опубликовать шаблон, который был экспортирован из шаблона клиента, сначала удалите все условия, относящиеся к клиенту.
Как опубликовать шаблон Remote Config
Скачав шаблон, внеся необходимые изменения в контент JSON и проверив его, вы можете опубликовать его в проекте.
При публикации шаблона весь существующий шаблон конфигурации заменяется обновленным файлом, а версия шаблона увеличивается на единицу. Поскольку конфигурация заменяется полностью, если вы удалите параметр из файла JSON и опубликуете его, параметр будет удален с сервера и станет недоступен для клиентов.
После публикации изменения параметров и значений сразу же становятся доступны приложениям и пользователям. При необходимости вы можете выполнить откат к предыдущей версии.
Чтобы опубликовать шаблон, выполните следующие действия:
В консоли Firebase перейдите на страницу DevOps & Engagement (DevOps и вовлечение) > Remote Config (Удаленная конфигурация) > Parameters or Conditions (Параметры или условия).
Откройте
меню и выберите Опубликовать из файла.В окне подтверждения нажмите Обзор, выберите файл Remote Config, который хотите опубликовать, и нажмите Выбрать.
Файл проверен. Если проверка прошла успешно, нажмите Опубликовать, чтобы конфигурация сразу стала доступна вашим приложениям и пользователям.
Дальнейшие действия
- Подробнее об использовании Remote Config в серверных средах…
- Попробуйте серверный Remote Config с Cloud Functions for Firebase и Agent Platform.