Esta documentación recoge los requerimientos técnicos y arquitectónicos necesarios para desplegar la plataforma Anjana Data y/o sus plugins en infraestructuras del cliente, ya sea en entornos IaaS, PaaS, SaaS Hybrid u OnPremise.
El objetivo es ofrecer una guía clara y estructurada sobre:
-
Sistemas operativos, bases de datos y tecnologías soportadas.
-
Condiciones y prerequisitos para el despliegue.
-
Mapa de software y componentes principales.
-
Conectividad necesaria entre nodos y servicios externos.
-
Arquitecturas recomendadas según el tipo de entorno.
De esta manera, los equipos de infraestructura y operaciones del cliente podrán preparar correctamente sus entornos antes de iniciar la instalación, asegurando un despliegue exitoso y alineado con las buenas prácticas de Anjana Data.
Pre-requisitos del despliegue
Sistemas Operativos y Tecnologías Soportadas
-
Sistemas Operativos: Ubuntu, RedHat .
-
Bases de Datos Relacionales: PostgreSQL , AWS RDS/Aurora PostgreSQL, AzureDB for PostgreSQL, GCP Cloud SQL for PostgreSQL, Embedded en VM
-
Persistencias S3: AWS S3, MinIO
-
Indexador: SolR
-
Otros componentes: Ansible, Python, Zookeeper
Nota: Todo el detalle acerca de las versiones soportadas está disponible en la documentación de Ansible
Ajustes de Sistema Operativo Requeridos
Además de la versión de SO soportada, es necesario validar los siguientes ajustes en cada nodo antes de lanzar el despliegue:
-
SELinux (RedHat): debe estar en modo Permissive o Disabled. En modo Enforcing el despliegue falla. Este ajuste es un prerequisito, no una incidencia del kit.
-
Parámetros de kernel: se recomienda ajustar
vm.max_map_counta al menos 262144 (valor recomendado para el correcto funcionamiento de Solr como motor de indexación). -
Ulimits: se recomienda que el usuario de servicio (
anjana) disponga, como mínimo, denofile(ficheros abiertos): 65536 ynproc(procesos): 4096. -
Sincronización horaria (NTP): todos los nodos del entorno deben tener el reloj sincronizado (chronyd/ntpd activo). Un desajuste de reloj entre nodos puede provocar fallos de validación de certificados TLS y de coordinación en Zookeeper.
Los valores de vm.max_map_count y de ulimits son los mínimos recomendados según buenas prácticas habituales para este tipo de despliegues (Solr/Java). Anjana Data no dispone de cifras propias validadas distintas a estas.
Requerimientos de Despliegue
-
Usuario con acceso SSH y permisos root en todas las máquinas y servicios gestionados provisionados.
-
No es imprescindible autenticar directamente como
rootpor SSH. Es válido un usuario con sudo sin contraseña (NOPASSWD) para las tareas de plataformado y despliegue, siempre que tenga privilegios de escalado completos. Debe utilizarse autenticación por clave SSH (fichero .pem): no se ha verificado que la autenticación por contraseña funcione correctamente con Ansible, por lo que actualmente la clave SSH es la única vía confirmada.
-
-
Conectividad requerida hacia:
-
https://releases.anjanadata.compara descarga del instalador, artefactos y paquetes de software. -
https://veltesta.anjanadata.compara activación y validación de licencias. -
Entre los nodos con los servicios gestionados RDS y S3, si aplica.
-
Entre todos los nodos provisionados en arquitecturas Standard y Balanced, por SSH.
-
En modalidad SaaS Hybrid, desde los nodos de plugins (puertos 15001+) hacia los sistemas de datos gobernados y hasta el módulo Tot. Ver documentación de Plugins TOT.
-
Desde nodos Anjana (Zeus) hacia/desde los sistemas de gestión de identidades. Ver documentación de Autenticación.
-
Descarga de software desde los repositorios del sistema operativo (ver lista en la documentación de los kits de Ansible).
-
-
Firewall de host y puertos entre nodos: en arquitecturas Distribuidas o Balanceadas, el firewall local de cada máquina (firewalld/iptables/security groups) debe permitir el tráfico entre los nodos del propio entorno Anjana en los puertos de los microservicios y persistencias desplegados, además de la conectividad externa indicada arriba. Un firewall de host mal configurado es una causa habitual de fallos de arranque en entornos multi-nodo aunque la conectividad de red a nivel de VPC/subnet sea correcta.
-
Acceso tras despliegue a portales:
-
443 → /login,/configpanel,/swagger/swagger-ui.html -
9001 (Minio) -
8983 (SolR) -
9999 (Horus)
-
-
En caso de BBDD gestionada: debe existir una base de datos llamada anjana y un usuario con permisos de creación.
-
En caso de S3 gestionado: deben existir 7 buckets (
CDN,DSA,IMPORTS,TEXTAREA,WORKFLOWS,ANJANABACKUPS,ANJANALOGS). -
El despliegue se realiza mediante un kit Ansible ejecutado desde un nodo central.
-
La máquina que ejecute el kit Ansible debe disponer de salida a Internet.
-
Arquitectura requerida: x86_64 (Intel/AMD 64 bits).
-
Espacio en disco: todo montado en el directorio raíz, con uso de
/opty/tmp.
Requisitos de Navegador
Para el acceso a las interfaces web de Anjana Data (Anjana UI y Portuno UI/configpanel), el navegador soportado oficialmente es:
-
Google Chrome - última versión estable
No se garantiza el correcto funcionamiento en otros navegadores (Firefox, Edge, Safari, etc.), al no estar contemplados en el soporte oficial de Anjana Data.
Mapa de Software
La plataforma Anjana Data está organizada en distintas zonas funcionales, cada una compuesta por módulos especializados que cubren la experiencia completa de gobierno de datos e inteligencia artificial. En la Descripción General encontrarás la explicación detallada de cada módulo (funcionalidades, tecnologías y casos de uso).
Arquitectura de Conexiones
La arquitectura de Anjana Data está diseñada para gobernar diferentes tecnologías, clústeres y entornos de manera agnóstica y flexible, permitiendo su despliegue en escenarios complejos como entornos multi-cloud, híbridos, big data o on-premise, y ofreciendo la capacidad de evolucionar junto con las nuevas tecnologías.
Gracias a su diseño modular basado en Spring Cloud y microservicios, Anjana Data Platform asegura:
-
Independencia de versiones de productos de terceros.
-
Alta disponibilidad y escalabilidad horizontal prácticamente ilimitada.
-
Despliegues adaptables tanto a entornos gestionados en la nube como a infraestructuras on-premise.
-
Interoperabilidad y extensibilidad mediante APIs y conectores/plugins.
Para una descripción completa de la arquitectura técnica y funcional, consulta la documentación oficial de Descripción general.
Diagrama de Conectividad de Red
Para facilitar el proceso de apertura de accesos con el equipo de seguridad del cliente, se detalla a continuación la tabla completa de conectividad: origen, destino, protocolo, puerto, dirección y condición de aplicabilidad de cada regla.
1. Conectividad requerida durante la instalación
|
# |
Origen |
Destino |
Protocolo |
Puerto |
Descripción |
Dir. |
|---|---|---|---|---|---|---|
|
1 |
Nodo Ansible |
releases.anjanadata.com |
HTTPS |
443 |
Descarga del kit, artefactos y paquetes de Anjana Data |
OUT |
|
2 |
Nodo Ansible |
Repositorios del SO (apt.ubuntu.com, rpm mirrors, etc.) |
HTTP/S |
80, 443 |
Instalación de paquetes del sistema operativo (Python, Java, etc.) |
OUT |
|
3 |
Nodo Ansible |
Todos los nodos del despliegue |
SSH |
22 |
Acceso SSH para despliegue automatizado (Ansible). Requerido desde nodo central hacia todos los nodos |
OUT |
2. Conectividad requerida en operación (runtime)
|
# |
Origen |
Destino |
Protocolo |
Puerto |
Descripción |
Dir. |
|---|---|---|---|---|---|---|
|
4 |
Nodo Anjana (core) |
veltesta.anjanadata.com |
HTTPS |
443 |
Activación y validación de licencia de producto. Periódico, no continuo |
OUT |
|
5 |
Nodo Anjana (core) |
Servidor PostgreSQL / RDS gestionado |
TCP |
5432 |
Base de datos relacional. Solo si se usa BBDD gestionada externa (no aplica en arquitectura Test/POC con BBDD en la misma VM) |
OUT |
|
6a |
Nodo Anjana (core) |
AWS S3 |
HTTPS |
443 |
Almacenamiento de objetos en AWS S3 (CDN, DSA, IMPORTS, TEXTAREA, WORKFLOWS, backups, logs). Solo si se usa AWS S3 como persistencia gestionada |
OUT |
|
6b |
Nodo Anjana (core) |
MinIO externo |
TCP |
9000 |
Almacenamiento de objetos en MinIO externo. Solo si se usa MinIO como servicio gestionado en otra máquina. MinIO embebido en la misma VM no requiere regla de firewall |
OUT |
|
7 |
Nodo Anjana (core) |
Servidor LDAP / Active Directory del cliente |
LDAP |
389 / 636 |
Autenticación de usuarios vía LDAP (389) o LDAPS con SSL (636). Solo si se configura autenticación LDAP/AD corporativa. No requerido si se usan usuarios locales de Anjana |
OUT |
|
8 |
Nodo Anjana (core) |
Servidor IdP OIDC / SSO (Azure AD, Keycloak, etc.) |
HTTPS |
443 |
Autenticación federada OIDC/SSO. Solo si se configura SSO corporativo. No requerido si se usan usuarios locales de Anjana |
OUT |
3. Conectividad de acceso de usuarios y administración
|
# |
Origen |
Destino |
Protocolo |
Puerto |
Descripción |
Dir. |
|---|---|---|---|---|---|---|
|
9 |
Navegador de usuario final |
Nodo Anjana |
HTTPS |
443 |
Acceso a la plataforma Anjana Data (UI web, API REST) |
IN |
|
10 |
Administrador / Equipo técnico |
Nodo MinIO |
TCP |
9001 |
Consola de administración MinIO. Solo uso administrativo, recomendado restringir a red interna o VPN |
IN |
|
11 |
Administrador / Equipo técnico |
Nodo SolR |
TCP |
8983 |
Consola de administración SolR. Solo uso administrativo, recomendado restringir a red interna o VPN |
IN |
|
12 |
Administrador / Equipo técnico |
Nodo Horus |
TCP |
9999 |
Consola de monitorización y métricas. Solo uso administrativo, recomendado restringir a red interna o VPN |
IN |
4. Conectividad adicional en modalidad SaaS Hybrid (solo si aplica)
|
# |
Origen |
Destino |
Protocolo |
Puerto |
Descripción |
Dir. |
|---|---|---|---|---|---|---|
|
13 |
Nodo Plugins (infraestructura cliente) |
Módulo Tot (SaaS Anjana) |
HTTPS |
443 |
Los plugins se registran en Tot al arrancar. Conexión saliente del cliente hacia Anjana SaaS |
OUT |
|
14 |
Módulo Tot (SaaS Anjana) |
Nodo Plugins (infraestructura cliente) |
HTTPS |
15001-15025 |
Tot orquesta los plugins: lanza extracciones y consultas llamando directamente al plugin registrado. El puerto exacto depende del plugin instalado; consultar a Anjana Data según los plugins requeridos |
IN |
Notas adicionales:
-
SSL/TLS obligatorio: todas las conexiones se securizan mediante SSL/TLS. Se requiere certificado wildcard del dominio del cliente (
fullchain.pem+privatekey.pem). -
Salida a Internet obligatoria: el nodo Anjana necesita salida a Internet para contactar
releases.anjanadata.com(instalación) yveltesta.anjanadata.com(licencias). -
Filas 5, 6a y 6b (BBDD y S3 gestionados): solo aplican si el cliente usa servicios gestionados externos. En arquitectura Test/POC (1 VM), PostgreSQL y MinIO corren en la misma máquina y no requieren regla de firewall.
-
Filas 7-8 (LDAP/OIDC): solo aplican si el cliente configura autenticación corporativa. Anjana soporta usuarios locales sin necesidad de LDAP ni SSO.
-
Filas 10-12 (puertos admin): se recomienda restringir su acceso a red interna o VPN del cliente. No deben exponerse a Internet.
-
Sección 4 (SaaS Hybrid): solo aplica en modalidad híbrida (plugins en cliente, núcleo Anjana en SaaS). En despliegue IaaS puro todos los plugins corren en la misma infraestructura del cliente y no requieren apertura de puertos hacia Internet.
Arquitecturas recomendadas
Anjana Data proporciona diferentes configuraciones recomendadas para entornos que permiten adaptar el despliegue a distintos volúmenes de usuarios y datos.
Estas arquitecturas están pensadas para garantizar:
-
Correcta distribución de cargas.
-
Escalabilidad y redundancia según la criticidad del entorno.
-
Integración con servicios gestionados de BBDD y almacenamiento S3.
Todo el detalle acerca de las arquitecturas recomendadas se encuentra en la documentación de Despliegue.
Certificados
Todas las conexiones entre los componentes de Anjana Data se securizan mediante SSL/TLS, por lo que es imprescindible disponer de un certificado wildcard asociado al dominio de cada instancia de la plataforma o de los plugins en caso de despliegues SaaS híbridos
(ejemplo: *.anjanadata.cliente.com o *.pluginsanjana.cliente.com).
Para el correcto despliegue se requieren exclusivamente los ficheros:
-
fullchain.pem -
privatekey.pem
Importante:
-
Los certificados que se utilizan en infraestructura del cliente deben ser proporcionados y gestionados por el cliente. Anjana Data no realiza en ningún caso la generación del CSR.
-
El despliegue no utiliza en ningún caso el CSR.
El detalle completo de cómo generar, ubicar e integrar los certificados se encuentra en la documentación oficial: