Configuración como código

La configuración de un proyecto puede vivir en un solo archivo que confirmas y subes. Producción cambia cuando publicas una publicación, y el mismo archivo puede describir tanto staging como producción.

Qué declara el archivo

foir.config.ts declara modelos, claves de API, hooks y proveedores de inicio de sesión. También cubre operaciones, programaciones, ubicaciones, segmentos, roles para tus usuarios, instalaciones de apps, tokens de diseño, locales, dimensiones de contexto, el catálogo de variantes, el texto de los correos y los ajustes del proyecto. Para una clave de API, el archivo confirmado contiene la declaración: su nombre, tipo, alcances y la variable de entorno que se usará. La CLI aprovisiona la clave durante un push y escribe su valor en tu archivo env bajo esa variable.

Un push prepara un borrador

foir push empieza con una prueba en seco en el servidor, de modo que un rechazo llega antes de que se escriba nada. Después escribe borradores, y producción sigue sirviendo la copia publicada hasta que llega una publicación. Los modelos nuevos, las operaciones nuevas y los campos opcionales añadidos se publican con el push. Todo lo demás espera a que lo publiques.

Un push es una fusión a tres bandas del archivo, el estado actual del proyecto y tu último push. Cuando el mismo campo cambió en el archivo y en la consola, se detiene y notifica el conflicto.

Staging y producción desde una sola configuración

Una configuración puede declarar varios proyectos con nombre desde un mismo manifiesto, que es como staging y producción se mantienen idénticos. Solo pueden diferir los valores declarados como destinos: endpoints, URI de redirección, orígenes, dominios y direcciones de remitente. Cualquier otra diferencia rechaza el push y nombra el campo y ambos valores. Un push también falla cuando el proyecto contiene un modelo, una operación, un hook, una programación o una dimensión de contexto que la configuración no declara.

Quitar un campo

Quitar un campo de la configuración no elimina sus datos de inmediato. El campo se conserva como obsoleto durante 30 días, y el push escribe un archivo de decisión que pregunta qué hacer con los valores almacenados: renombrar, convertir o eliminar.

Lee el detalle

La documentación de configuración cubre el formato del archivo, cada familia que puede declarar, el push, la publicación y los proyectos con nombre.