Control de versiones y plantillas de Remote Config


Las plantillas de Remote Config son conjuntos de parámetros y condiciones en formato JSON que creaste para tu proyecto de Firebase. Puedes crear plantillas de cliente, desde las que tu app recupera valores, y plantillas de servidor, desde las que los clientes del servidor pueden recuperar valores.

En esta sección, se analizan las plantillas de servidor. Para obtener información sobre las plantillas específicas del cliente, haz clic en Plantillas de cliente.

Puedes modificar y administrar la plantilla con Firebase console, que muestra el contenido de la plantilla en formato gráfico en las pestañas Parámetros y Condiciones.

Este es un ejemplo de un archivo de plantilla de servidor:

{
  "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
  }
}

Puedes realizar estas tareas de administración de versiones con Firebase console:

  • Crear una lista con todas las versiones de plantilla almacenadas
  • Recuperar una versión específica
  • Revertir a una versión de cliente específica
  • Borrar plantillas de Remote Config de la página Historial de cambios

Hay un límite total de 300 versiones almacenadas desde el principio por tipo de plantilla (300 plantillas de cliente y 300 plantillas de servidor), que incluyen los números de versión almacenados para las plantillas borradas. Si publicas más de 300 versiones de plantilla por tipo de plantilla durante el ciclo de vida de un proyecto, las versiones más antiguas se borran y se mantiene un máximo de 300 versiones de ese tipo.

Cada vez que actualizas los parámetros, Remote Config crea una nueva plantilla de Remote Config con versión y almacena la anterior como una versión que puedes recuperar o revertir según sea necesario. Los números de versión aumentan de manera secuencial a partir del valor inicial que almacenó Remote Config. Todas las plantillas incluyen un campo version que contiene metadatos sobre esa versión específica.

Puedes borrar las plantillas de Remote Config según sea necesario desde la página Historial de cambios de Remote Config console.

Administra las versiones de plantillas de Remote Config

En esta sección, se describe cómo administrar las versiones de tu plantilla de Remote Config.

Genera una lista con todas las versiones almacenadas de la plantilla de Remote Config

Puedes recuperar una lista de todas las versiones almacenadas de la plantilla de Remote Config. Para ello, sigue estos pasos:

  1. En Firebase console, abre Remote Config.

  2. Luego, en la pestaña Parámetros, selecciona el ícono de reloj que se muestra en la esquina superior derecha.

    Esta acción abrirá la página Historial de cambios, donde encontrarás una lista de todas las versiones de la plantilla en un menú de lista a la derecha.

    La lista de plantillas incluye los metadatos de todas las versiones almacenadas, entre ellos la hora de actualización, el usuario que la realizó y cómo se hizo.

Recupera una versión específica de la plantilla de Remote Config

Puedes recuperar cualquier versión específica almacenada de la plantilla de Remote Config. Para recuperar una versión de plantilla almacenada, haz lo siguiente:

  1. Abre el panel de detalles del Historial de cambios.

  2. Para ver los detalles de otra versión de la lista, selecciónala en el menú de la derecha.

  3. Para ver las diferencias detalladas entre la plantilla activa y cualquier otra versión almacenada, coloca el cursor sobre el menú contextual de cualquier versión que no esté elegida y selecciona Comparar con la versión seleccionada.

Revierte a una versión almacenada específica de la plantilla de Remote Config

Puedes realizar una reversión a cualquier versión almacenada de la plantilla. Para revertir una plantilla, haz lo siguiente:

  1. Busca el botón de opción en la parte superior derecha de la página Historial de cambios. Haz clic en el botón y confirma la operación solo si estás seguro de que quieres realizar la reversión y usar esos valores de inmediato en todos los usuarios y las apps.

Ten en cuenta que revertir la plantilla crea efectivamente una versión numerada nueva. Por ejemplo, revertir de la versión 10 a la 6 crea una copia nueva de la versión 6, cuya única diferencia con la versión original es que su número de versión será 11. La versión 6 original seguirá almacenada (si no llegó al límite de vencimiento) y la versión 11 de la plantilla será la activa.

Borra una plantilla de Remote Config

Puedes borrar plantillas de Remote Config desde Firebase console. Para borrar una plantilla de Remote Config, sigue estos pasos:

 1. En la página Parámetros de Remote Config, haz clic en Historial de cambios.

  1. Ve a la plantilla que deseas borrar, haz clic en Más y, luego, selecciona Borrar.

  2. Cuando se te solicite confirmar la eliminación, haz clic en Borrar.

Descarga y publica plantillas de Remote Config

Descarga y publica plantillas de Remote Config para integrarlas en tus sistemas de compilación y de control de origen, automatizar las actualizaciones de configuración y mantener los parámetros y valores sincronizados en múltiples proyectos.

Puedes descargar la plantilla de Remote Config activa actualmente desde Firebase console. Luego, puedes actualizar el archivo JSON exportado y publicarlo en el mismo proyecto, o en uno nuevo o existente.

Supongamos que tienes múltiples proyectos que representan diferentes etapas del ciclo de vida del desarrollo de un software, como los entornos de desarrollo, prueba, etapa de pruebas y producción. En este caso, puedes ascender una plantilla completamente probada del entorno de etapa de pruebas a tu entorno de producción si la descargas desde el proyecto de etapa de pruebas y la publicas en el de producción.

También puedes usar este método para migrar parámetros de configuración de un proyecto a otro o propagar un proyecto nuevo con parámetros y valores de un proyecto establecido.

En las plantillas exportadas, no se incluyen los parámetros ni valores de parámetros creados específicamente como variantes en un experimento de A/B Testing.

Para exportar y para importar plantillas de Remote Config, sigue estos pasos:

  1. Descarga la plantilla de configuración de Remote Config actual.
  2. Valida la plantilla de Remote Config.
  3. Publica la plantilla de Remote Config.

Descarga la plantilla actual de Remote Config

Usa el siguiente comando para descargar la plantilla de Remote Config activa en formato JSON:

  1. En la pestaña Parámetros o Condiciones de Remote Config, abre el Menú y selecciona Descargar archivo de configuración actual.
  2. Cuando se te solicite, haz clic en Descargar archivo de configuración, elige la ubicación en la que deseas guardar el archivo y, luego, haz clic en Guardar.

Valida la plantilla de Remote Config

Las plantillas de servidor se validan cuando intentas realizar publicaciones desde Firebase console. Ten en cuenta que se pueden importar las condiciones de usuario en porcentaje aleatorio, pero cualquier condición no admitida generará un error durante la carga. Si intentas publicar una plantilla que se exportó originalmente desde una plantilla de cliente, asegúrate de quitar primero las condiciones específicas del cliente.

Publica la plantilla de Remote Config

Después de descargar una plantilla, realizar los cambios necesarios en el contenido JSON y validarla, puedes publicarla en un proyecto.

Publicar una plantilla reemplaza toda la plantilla de configuración existente por el archivo actualizado y aumenta la versión de la plantilla en uno. Debido a que se reemplaza toda la configuración, si borras un parámetro del archivo JSON y lo publicas, el parámetro se borra del servidor y deja de estar disponible para los clientes.

Después de la publicación, los cambios en los parámetros y los valores estarán disponibles de inmediato para tus apps y usuarios. Si es necesario, puedes revertir a una versión anterior.

Usa los siguientes comandos para publicar tu plantilla:

  1. En la pestaña Parámetros o Condiciones de Remote Config, abre el Menú y selecciona Publicar desde un archivo.
  2. Cuando se te solicite, haz clic en Explorar, navega hasta el archivo de Remote Config que quieres publicar y haz clic en Seleccionar.
  3. El archivo se validará y, si se ejecuta correctamente, puedes hacer clic en Publicar a fin de que la configuración esté disponible inmediatamente para tus apps y usuarios.

Próximos pasos