Por qué usar Systemplane
En un despliegue tradicional, cambiar un valor de configuración implica actualizar variables de entorno y reiniciar el servicio. Systemplane elimina ese tiempo de inactividad para muchos ajustes:
- Ajusta los rate limits durante los picos de tráfico sin un redespliegue
- Ajusta los intervalos de los workers según la carga de trabajo observada. Una recarga de configuración sincroniza el worker afectado y lo reinicia cuando su configuración en ejecución cambia
- Actualiza el número máximo de pools de tenants a medida que cambian los patrones de tráfico. Los ajustes de conexiones por pool de PostgreSQL requieren un cambio de entorno y un reinicio
- Inspecciona los valores actuales en tiempo de ejecución para diagnosticar problemas de producción sin bucear en los logs
Cómo funciona
Systemplane ofrece una API de gestión de clave-valor plana. Todas las claves de configuración están en un único namespace bajo
/system/matcher.
Endpoints
La instancia de Matcher en ejecución sirve estos endpoints directamente. No están bajo
/v1. Usa las rutas anteriores exactamente como se muestran.Permisos
Las rutas de configuración y de catálogo de Systemplane usan la misma autenticación que las rutas de la API de Matcher. Con la autenticación habilitada, estas rutas requieren el permiso RBAC
system-runtime-config:admin (recurso system-runtime-config, acción admin). GET /system/matcher/streaming/manifest es una ruta aparte y requiere streaming-manifest:read.
Con la autenticación deshabilitada, todos los endpoints son accesibles sin restricción.
Comportamientos de aplicación
Solo puedes cambiar algunos valores de configuración en tiempo de ejecución. Cada clave tiene un comportamiento de aplicación que indica cuándo los cambios tienen efecto:
La API de systemplane NO registra la mayoría de las claves solo de bootstrap. Las gestionas exclusivamente mediante variables de entorno. Esto evita una trampa en la que un PUT de administrador parecería tener éxito mientras el proceso en ejecución seguiría usando en silencio el valor de arranque. Las claves de Swagger registradas son una excepción: son visibles en Systemplane pero siguen siendo solo de bootstrap (consulta la nota más abajo).
Claves de configuración comunes
A continuación están las claves que ajustas con más frecuencia, organizadas por categoría. Para obtener la lista completa, llama a
GET /system/matcher.
Claves ajustables en tiempo de ejecución
Puedes cambiar estas claves sin reiniciar Matcher:swagger.enabled, swagger.host y swagger.schemes están registradas y son visibles en Systemplane, pero no son controles en vivo. Matcher captura el montaje de Swagger y los valores del handler en el bootstrap, así que un PUT en tiempo de ejecución no cambia la UI en vivo ni el comportamiento de la especificación. En su lugar, cambia su configuración de arranque y reinicia Matcher.Claves multi-tenant (ajustables en tiempo de ejecución)
Estas claves controlan el comportamiento multi-tenant y puedes ajustarlas sin reiniciar. Consulta Modo multi-tenant para más detalles.Habilitar el modo multi-tenant en sí (
tenancy.multi_tenant_enabled / MULTI_TENANT_ENABLED) es solo de bootstrap. Matcher lo lee una vez al arrancar. Un cambio en él requiere un reinicio. La API de Systemplane no lo registra y no puedes cambiarlo en tiempo de ejecución. Consulta la tabla de claves solo de bootstrap más abajo.Claves solo de bootstrap (requieren reinicio)
La API de systemplane no registra estas claves. Cámbialas mediante variables de entorno y reinicia:Mejores prácticas
Inspecciona los valores actuales antes de cambiarlos
Inspecciona los valores actuales antes de cambiarlos
Llama a
GET /system/matcher para ver todos los valores actuales en tiempo de ejecución antes de hacer cualquier cambio. Esto confirma lo que el proceso usa de verdad. Puede diferir de las variables de entorno después de llamadas PUT previas.Prueba los cambios primero en staging
Prueba los cambios primero en staging
El comportamiento de aplicación en tiempo de ejecución varía según la clave, y los cambios en un worker pueden reiniciar el worker afectado. Prueba en un entorno de staging antes de aplicar a producción.
Reinicia para las claves solo de bootstrap
Reinicia para las claves solo de bootstrap
Si una clave no es visible en
GET /system/matcher, es solo de bootstrap. Actualiza la variable de entorno y reinicia el servicio. No hay una vía en tiempo de ejecución para esos valores. Una clave visible puede seguir siendo solo de bootstrap cuando su documentación lo dice: las claves de Swagger registradas aceptan un PUT en tiempo de ejecución pero solo tienen efecto después de un reinicio.Próximos pasos
Modo multi-tenant
Habilita y configura el aislamiento de tenants.
Enrutamiento de excepciones
Configura el despacho de excepciones a sistemas externos.
Reglas de coincidencia
Configura las reglas de coincidencia de transacciones.
Seguridad
Autenticación, autorización y protección de datos.