Anjana Installer

Información general

Anjana Installer es la herramienta de despliegue de Anjana Data Platform, diseñada como evolución del kit Ansible tradicional. Se trata de una aplicación con interfaz gráfica web y línea de comandos (CLI) que permite gestionar el ciclo de vida completo de las instalaciones de Anjana en entornos IaaS, PaaS y OnPremise.

El objetivo del instalador es simplificar y estandarizar el proceso de despliegue, actualización y mantenimiento de la plataforma, eliminando la necesidad de conocimientos avanzados en Ansible y reduciendo los errores derivados de la configuración manual.

Novedades respecto al kit Ansible

Nueva experiencia de usuario

• Interfaz gráfica web: toda la configuración, despliegue y operación se realiza desde un navegador, sin necesidad de editar ficheros YAML ni ejecutar playbooks.

• Binario autónomo: se distribuye como un único ejecutable que incluye todo lo necesario, sin requerir Ansible, Python ni dependencias adicionales. Estilos unificados con la plataforma Anjana para una experiencia visual coherente.

Mejoras en el despliegue

• Gestión automática de dependencias: el instalador detecta qué persistencias están disponibles y no permite instalar el core sin que estén satisfechas.

• Dependencias a nivel descriptor de servicio: los microservicios esperan automáticamente a que sus dependencias estén arrancadas antes de iniciar, eliminando el arranque manual ordenado del kit anterior. Despliegue unificado de microservicios y plugins iterando sobre listas categorizadas (Core / Plugins).

• Adaptación automática al modo de despliegue: en entornos Single VM sin persistencias cloud no es necesario rellenar URLs de conexión.

• Fase de Preflight previa al despliegue: antes de Platform Setup y Full Install, el instalador valida la configuración y los hosts destino (conectividad, permisos, recursos, puertos, paquetes) y ofrece remediación guiada de los problemas detectados desde la propia interfaz.

Mejoras en seguridad

• Gestión encriptada de secretos: todas las credenciales se almacenan encriptadas en reposo, eliminando los ficheros de entorno en texto plano del kit anterior.

• Contraseña de keystore TLS aleatoria por despliegue (ksPass): el instalador genera una contraseña aleatoria para el keystore TLS en cada ejecución de platform setup, almacenándola encriptada en el SecretsService. Los descriptores de servicio de los microservicios nunca contienen una contraseña estática predecible.

• Compatibilidad con AWS Secrets Manager con soporte de blob JSON compartido con Horus (requiere IRSA).

• Almacenamiento local encriptado (AES-256-GCM) para entornos sin acceso a servicios cloud.

• Resolución mejorada de nombres en el fichero hosts por máquina en lugar de por microservicio.

• Rotación de credenciales de persistencias con política de seguridad obligatoria y protección de credenciales desplegadas durante la importación de configuraciones.

• Control de acceso por IP del proxy de la plataforma gestionado desde la interfaz (whitelist general e interna), con aplicación en caliente y validación automática.

Mejoras en operación y mantenimiento

• Actualización con rollback automático en caso de fallo.

• Panel de estado enriquecido cruzando múltiples fuentes (servicio, logs y registro en Eureka) con detección automática de versiones.

• Logs de auditoría separados en una pipeline independiente para integración con sistemas SIEM.

• Interfaz de línea de comandos completa para automatización e integración con pipelines de CI/CD.

• Herramientas de persistencias completas: backup, restore, restore desde fichero (.sql, .tar.gz), exportación/importación de datos para migración entre entornos, reset con modos de restauración opcionales, carga de datos de ejemplo y visor de logs en tiempo real.

• Re-población automática de la configuración de Horus tras operaciones que modifican la base de datos (RESET_ALL, RESTORE_ALL, LOAD_SAMPLE_DATA).

Importación de configuraciones

El instalador permite importar configuraciones existentes de dos formas:

• Importación desde un kit Ansible anterior (all.yaml + hosts.yaml, y opcionalmente anjanauihosts.yaml para portar las whitelists de acceso) con detección automática de topología y mapeo de valores.

• Importación desde un YAML exportado previamente por el propio instalador. Durante la importación, las credenciales de persistencias que ya estén desplegadas no se sobreescriben, mostrando un aviso al usuario para que las gestione desde Tools > Credentials.

Soporte

Versiones incluidas

Las versiones están basadas en la última release disponible en la paquetería de Ubuntu 24.04 en el momento de lanzamiento. En RedHat 9 las versiones pueden variar ligeramente según la disponibilidad de paquetes oficiales. Solr + ZooKeeper y OpenSearch son excluyentes entre sí: el asistente de configuración permite elegir uno u otro como motor de indexación/búsqueda.

NOTA: OpenSearch todavía no está disponible como opción seleccionable en el asistente (marcado "Coming soon"); el motor activo hoy es Solr + ZooKeeper.

Assets incluidos

En el instalador se incluye lo siguiente:

Recomendaciones

Control de versiones

Para garantizar un control efectivo de las versiones y cambios de las configuraciones del instalador, es crucial el uso de repositorios Git como parte del flujo de trabajo. Es recomendable que todo aquel que use este instalador disponga de un repositorio o herramienta que permita trazar los cambios en el tiempo para garantizar la integridad del trabajo y la recuperación ante cambios no deseados.

Migración desde kit Ansible

Para entornos existentes desplegados con el kit Ansible, el instalador proporciona un procedimiento de migración integrado. Desde la interfaz gráfica, el usuario puede importar los ficheros all.yaml y hosts.yaml del kit Ansible anterior (y opcionalmente anjanauihosts.yaml para portar las whitelists de acceso por IP). El instalador mapeará automáticamente la configuración, detectará la topología y ofrecerá migrar de Solr a OpenSearch si procede. Las credenciales de persistencias ya desplegadas se protegen durante la importación y no se sobreescriben. Se recomienda consultar el Manual de despliegue Installer para familiarizarse con la configuración a migrar.