Configuración de ejecución y variables de entorno

Los administradores pueden consultar y modificar mediante interfaces las opciones admitidas de ems.yaml, conservando los comentarios del archivo original. En despliegues por lotes también pueden sustituirse valores mediante variables de entorno.

Identificar el origen de la configuración

La consulta muestra el valor del archivo, el valor en ejecución, el origen de la sustitución y si puede editarse:

Campo	Uso
value	Valor guardado en el archivo; los datos sensibles se muestran enmascarados
runtimeValue	Valor actual dentro del proceso
effectiveSource / envName	Indica si una variable de entorno sustituye el valor y cuál es su nombre
editable	Indica si la interfaz de configuración permite modificarlo actualmente

Los valores sustituidos por variables de entorno no pueden modificarse desde la página ni la interfaz de configuración. Cambia la variable correspondiente en el entorno de despliegue y reinicia cuando sea necesario.

Aplicación de los cambios

Una opción puede aplicarse inmediatamente, requerir un reinicio o solo escribirse en el archivo. Consulta los metadatos y los mensajes de respuesta de la interfaz. Que cambie el valor en ejecución no implica que se hayan recreado recursos inicializados al arrancar, como grupos de conexiones o directorios.

La máscara de un campo sensible no es la credencial real; no la envíes como un nuevo valor.

Interfaces de integración

Consulta mediante GET /ems-yaml-config/list y actualiza mediante POST /ems-yaml-config/update, enviando {"values":{"<clave-de-configuración>":"<nuevo-valor>"}}. Ambas operaciones requieren permisos de administrador.

Antes de ajustar parámetros de almacenamiento, consulta Capacidad y retención. Para restauraciones, consulta Congelación para mantenimiento.