| Selecciona el tipo de plantilla: | Plantillas de cliente Plantillas de servidor |
Las plantillas de Remote Config son conjuntos de parámetros y condiciones en formato JSON creados para tu proyecto de Firebase. Las plantillas de servidor entregan configuraciones a las instancias del servidor con Firebase Admin SDK para Remote Config (disponible para Node.js, Java, Python y Go).
Puedes usar la consola de Firebase para modificar y administrar tu plantilla de servidor. Ve a DevOps e interacción > Remote Config para ver el contenido de la plantilla en formato gráfico en la página Parámetros y la página 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 en la consola de Firebase (navega a DevOps y participación > Remote Config):
- Crear una lista con todas las versiones de plantilla almacenadas
- Recuperar una versión específica
- Cómo revertir a una versión específica del servidor
- Borra las 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 en la página Historial de cambios de DevOps y participación > Remote Config > Historial de cambios de la consola de Firebase.
Administra las versiones de plantillas de Remote Config
En esta sección, se describe cómo administrar las versiones de tu plantilla de servidor 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 hacer lo siguiente:
En la consola de Firebase, ve a la página DevOps y participación > Remote Config > 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, en la que 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. Sigue estos pasos para recuperar una versión de plantilla almacenada:
En la consola de Firebase, ve a la página Historial de cambios en Remote Config > DevOps y participación.
De forma predeterminada, la página muestra la plantilla activa actual. Para ver una versión diferente, selecciónala en el panel de detalles de la derecha.
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 revertir a cualquier versión almacenada de la plantilla. Sigue estos pasos para revertir una plantilla:
En la consola de Firebase, ve a la página Historial de cambios en Remote Config > DevOps y participación.
Busca el botón de opción en la parte superior derecha de la página para las versiones anteriores de la plantilla aptas para la reversión.
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 con la consola de Firebase. Sigue estos pasos para borrar una plantilla:
En la consola de Firebase, ve a la página DevOps y participación > Remote Config > Parámetros.
Haz clic en
Historial de cambios .Ve a la plantilla que deseas borrar, haz clic en
Más y, luego, selecciona Borrar.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.
Por ejemplo, supongamos que tienes varios proyectos que representan diferentes etapas del ciclo de vida del desarrollo de 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:
- Descarga la plantilla de Remote Config actual.
- Valida la plantilla de Remote Config.
- 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:
En la consola de Firebase, ve a la página DevOps y participación > Remote Config > Parámetros o condiciones.
Abre el
Menú y selecciona Descargar archivo de configuración actual.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. Se pueden importar las condiciones que usan la regla Usuario en porcentaje aleatorio, pero cualquier condición no admitida genera 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.
Sigue estos pasos para publicar tu plantilla:
En la consola de Firebase, ve a la página DevOps y participación > Remote Config > Parámetros o condiciones.
Abre el
Menú y selecciona Publicar desde un archivo.Cuando se te solicite, haz clic en Explorar, navega hasta el archivo de Remote Config que quieres publicar y haz clic en Seleccionar.
Se valida el archivo. Si la validación se realiza correctamente, haz clic en Publicar para que la configuración esté disponible de inmediato para tus apps y usuarios.
Próximos pasos
- Obtén más información para usar Remote Config en entornos de servidor.
- Prueba Remote Config del servidor con Cloud Functions for Firebase y Agent Platform.