| Выберите тип шаблона: | Клиентские шаблоны Серверные шаблоны |
Шаблоны 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-3.8-flash"
},
"valueType": "STRING"
},
"generation_config": {
"defaultValue": {
"value": "{\"maxOutputTokens\": 2048}"
},
"valueType": "JSON"
}
},
"version": {
"versionNumber": "19",
"isLegacy": true
}
}
В консоли Firebase (DevOps и вовлечение > Remote Config) можно выполнять следующие задачи по управлению версиями:
- Список всех сохраненных версий шаблона
- Как получить определенную версию
- Как выполнить откат до определенной версии сервера
- Удалите Remote Config шаблонов на странице История изменений.
Для каждого типа шаблонов можно сохранить не более 300 версий (300 клиентских и 300 серверных шаблонов), включая номера версий удаленных шаблонов. Если за время существования проекта вы опубликуете более 300 версий шаблонов одного типа, самые ранние версии будут удалены, чтобы сохранить максимальное количество версий этого типа (300).
При каждом обновлении параметров Remote Config создает новую версию шаблона Remote Config и сохраняет предыдущий шаблон как версию, которую вы можете получить или к которой можете вернуться при необходимости. Номера версий увеличиваются последовательно, начиная с исходного значения, которое хранится в Remote Config.
Все шаблоны содержат поле version, в котором указаны метаданные о конкретной версии.
При необходимости вы можете удалить шаблоны Remote Config на странице DevOps & Engagement (DevOps и вовлечение) > Remote Config (Удаленная конфигурация) > Change history (История изменений) в консоли Firebase.
Управление версиями шаблона "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-файл и опубликовать его в том же проекте или опубликовать его в новом или существующем проекте.
Например, у вас может быть несколько проектов, представляющих разные этапы жизненного цикла разработки ПО, такие как разработка, тестирование, промежуточная и рабочая среды. В этом случае вы можете перенести полностью протестированный шаблон из тестовой среды в рабочую, скачав его из тестового проекта и опубликовав в рабочем.
Этот метод также можно использовать для переноса конфигураций из одного проекта в другой или для заполнения нового проекта параметрами и значениями из существующего проекта.
Параметры и значения параметров, созданные специально как варианты в эксперименте A/B Testing, не включаются в экспортируемые шаблоны.
Чтобы экспортировать и импортировать шаблоны 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.