Entornos

Qué es un entorno

Un complemento posee un conjunto ordenado de entornos con nombre — hasta cinco, en un orden de promoción fijo (Development, QA, Staging, UAT, Production por defecto; no tienes que llenar cada puesto, y los nombres son tuyos para editar). Un complemento nuevo empieza con un único entorno de Development.

• Cada entorno ejecuta su propio agent — su propio proceso connxl-agent (o varias réplicas), autenticado con un certificado limitado a ese único entorno. No existe un "entorno activo" ni un anclaje: Development y Production se sirven en paralelo por agents distintos, y nada de lo que hagas en uno afecta a si el otro está en vivo.
• Development (posición 1) es el origen. Es el único entorno donde creas o editas estructura — funciones, definiciones de conexión, botones de la cinta, el panel de tareas. El backend lo impone, no solo el panel.
• Cualquier otro entorno es un destino de promoción. Ahí solo editas valores específicos del entorno — credenciales, hosts, ajustes de caché. Una edición estructural (añadir una función, cambiar la forma de una conexión) se rechaza fuera del entorno de origen; traes la estructura con Promote en su lugar.

Renombrar y eliminar

Abre los ajustes de un entorno para renombrarlo. El slug — que se compara sin distinguir mayúsculas/minúsculas con el CONNXL_ENV_ID del agent al conectar — queda fijado en la creación y no puede cambiar, así que renombrar el nombre visible nunca rompe la identidad de un agent en marcha.

La caché de resultados

Cada entorno lleva su propia configuración de caché — el bloque cache del snapshot del agent, que se edita desde la pestaña Configuration de la página Agent. Controla si (y cómo) se cachean los resultados de una función antes de que una llamada vuelva a llegar a tu fuente de datos.

• Backend — disabled (por defecto; no se cachea nada), memory (en el proceso del agent — se limpia al reiniciar, por réplica), o valkey (compartida entre todas las réplicas del entorno, respaldada por una conexión Valkey que registras como cualquier otra fuente de datos).
• Defaults — el TTL y los límites de tamaño genéricos aplicados a cualquier función que ningún segmento de abajo cubra.
• Segments — una lista ordenada de reglas glob sobre ids de función (MODULE.NAME, p. ej. SALES.*). Gana el primer segmento que coincide, así que pon los patrones más estrechos por encima de los más amplios. Cada segmento puede fijar su propio TTL y límites de tamaño, anulando los valores por defecto solo para las funciones que coincide.

El cacheo solo se aplica cuando se elige un backend distinto de disabled; elegir disabled mantiene activo el selector de backend (para que puedas volver a activar la caché) pero deja inertes todos los demás campos.

Cómo se mueve la configuración entre entornos

La estructura nunca se edita sola hacia un entorno de destino — se trae deliberadamente con Promote, desde la página de ese entorno. Promote:

• Copia la estructura del entorno de origen (funciones, la forma de las conexiones, botones de la cinta, panel de tareas) al entorno destino.
• Preserva los valores propios del destino — sus credenciales, host del agent y configuración de caché quedan intactos, así que promover una función nueva a Production no sobrescribe la contraseña de la base de datos de Production.
• Publica automáticamente — un Promote actualiza la configuración de trabajo del destino y la pone en vivo en el mismo paso, registrado como una entrada promote en el historial de versiones de ese entorno.

Consulta Versiones para el flujo completo de guardar/publicar/comparar/restaurar, y cómo aparece un Promote en el historial de un entorno.