Este Anexo abarcará toda la información sobre las posibles configuraciones y utilidades no cubiertas en la página principal del kit 26.1.1.
anjana-secrets explicado
En el kit se incluye el fichero secrets/anjana.env.example, en el cual se documentan todas las claves del bundle cifrado. anjana setup crea a partir de él los Secrets anjana-secrets (todas las claves) y anjana-config (sin las claves persistences.*, para el backend native de Horus). A continuación se detallan los grupos de configuración disponibles:
Cadenas de conexión de persistencias
Todas las claves de conexión a persistencias siguen el patrón persistences.<servicio>.<propiedad>:
-
persistences.bbdd.userypersistences.bbdd.pass: credenciales de acceso a PostgreSQL. Las usan el StatefulSet de PostgreSQL in-cluster y el Jobanjana-db-schemas. Los servicios usanDB_URL,DB_USERyDB_PASS, que sirve Horus. -
persistences.bbdd.url: URL de conexión en formatohost:port/db. Ejemplo:postgresql:5432/anjana. En despliegues cloud apunta a RDS. -
persistences.mongodb.userypersistences.mongodb.pass: credenciales de MongoDB. -
persistences.rabbitmq.userypersistences.rabbitmq.pass: credenciales de RabbitMQ. -
persistences.valkey.pass: contraseña de Valkey (Redis compatible). -
persistences.s3.access_keyypersistences.s3.secret_key: credenciales de acceso a S3 (AWS S3 o SeaweedFS). Se usan para inicializar SeaweedFS y para la configuración del CDN proxy. -
anjana.domain: dominio de acceso a la instancia de Anjana. ✅RECOMENDADO: dejar el valor gestionado poranjana setuppara garantizar la coherencia con los certificados TLS.
Configuración de licencia
La licencia es requerida para el funcionamiento de la plataforma y debe incluirse en el bundle de credenciales. Consulta con el equipo de Anjana Data para obtener los valores de licencia correspondientes a tu entorno.
Configuración de Horus y servicios cloud
En modo cloud (AWS), Horus lee la configuración de servicios del secreto <global.horus.aws.prefix>/application_default/ de AWS Secrets Manager mediante IRSA. El nombre termina en barra (/): sin ella Horus no encuentra el secreto. En ese caso, solo las claves de persistencias locales son necesarias en anjana-secrets.
Plataformado de instancias
values-example.yaml como referencia
El kit incluye values-example.yaml con todas las opciones del chart comentadas. ✅RECOMENDADO: usarlo como referencia para construir el fichero values-<env>.yaml de cada entorno, sobreescribiendo solo lo necesario.
Perfiles de entorno (DEV / PRE / PRO)
El perfil activo se controla con global.environment.profile y determina los requests y limits de CPU/memoria de cada microservicio:
-
DEV: entornos de laboratorio o locales, recursos mínimos. -
PRE(por defecto): preproducción / UAT. -
PRO: producción, recursos ampliados.
global:
environment:
profile: PRO
Los valores por servicio y perfil están definidos en charts/anjana-core/values.yaml (campo resourcesProfile). Para ajustar un servicio concreto, define su bloque resources en el values override: tiene prioridad sobre el perfil. La tabla de capacidad total por perfil está en el Manual de despliegue, sección "Requisitos de recursos del cluster".
Guardrails de validación
El chart valida prerrequisitos en tiempo de renderizado (global.guardrails.mode):
-
strict(por defecto): la instalación falla si falta algún prerrequisito. Valida, entre otros: en modo TLSinternal, elClusterIssuery los Secrets dekeystorePasswordSecret, truststore ycaSource; con el backendnative, el Secretanjana-config; sin backend cloud, queglobal.horus.config.envSecretNameesté definido; y que hay exactamente un backend de Config Server habilitado. -
permissive: solo avisa. Útil para validar en local (make test) o en laboratorio.
global:
guardrails:
mode: permissive
Modo TLS: internal vs manual
El modo TLS se controla con global.tls.mode en el fichero de values:
Modo internal (recomendado): cert-manager genera y renueva automáticamente los certificados usando un ClusterIssuer. No requiere gestión manual de certificados.
NOTA: el kit no instala cert-manager. El modo internal requiere cert-manager (>= 1.14) previamente desplegado en el cluster; si no se dispone de él, usar el modo manual.
global:
tls:
mode: internal
internal:
clusterIssuerName: "anjana-internal-ca"
Modo manual: usa certificados pre-existentes. Es necesario exportar las rutas antes de ejecutar anjana setup:
export ANJANA_KEYSTORE_P12=/path/to/anjana-ssl.keystore.p12
export ANJANA_CACERTS=/path/to/cacerts
export ANJANA_FULLCHAIN_PEM=/path/to/fullchain.pem
export ANJANA_PRIVKEY_PEM=/path/to/privkey.pem
export ANJANA_CA_PEM=/path/to/ca.crt # opcional
anjana setup anjana-data
Gestión de aliases kubectl
Para un acceso rápido al namespace de Anjana, puedes configurar un alias en tu shell:
alias k='kubectl -n anjana-data'
alias kgp='kubectl get pods -n anjana-data'
alias klogs='kubectl logs -n anjana-data'
Integraciones cloud
Buckets en AWS S3
Para usar buckets en AWS S3 en lugar de SeaweedFS, configura el modo CDN en el fichero de values:
global:
cdnProxy:
mode: aws_s3
bucket: "anjana-prod-cdn"
aws_s3:
region: "eu-central-1"
En modo aws_s3 el proxy /cdn/ no firma las peticiones: el bucket CDN debe permitir GetObject anónimo (se puede restringir al VPC endpoint).
Y deshabilita las persistencias S3 en cluster:
anjana-persistences:
seaweedfs:
enabled: false
Las credenciales de acceso a S3 (S3_ACCESS_KEY y S3_SECRET_KEY) son obligatorias aunque se use IRSA: solo Horus usa IRSA. Los nombres de bucket van en S3_BUCKET_*.
PostgreSQL en RDS
Para usar RDS en lugar del StatefulSet de PostgreSQL en cluster:
-
Deshabilita PostgreSQL en cluster en el fichero de values:
anjana-persistences:
postgresql:
enabled: false
-
Actualiza la URL de conexión en el bundle de credenciales:
# En horus.env
DB_URL=my-rds-instance.eu-central-1.rds.amazonaws.com:5432
DB_USER=anjana
DB_PASS=<contraseña>
persistences.bbdd.url=my-rds-instance.eu-central-1.rds.amazonaws.com:5432/anjana
persistences.bbdd.user=anjana
persistences.bbdd.pass=<contraseña>
Versión soportada: PostgreSQL 16. Para que los servicios confíen en la CA de RDS (modo TLS internal), añadirla al truststore desde una ConfigMap:
global:
tls:
internal:
truststore:
extraCaBundles:
- configMapName: rds-ca
key: global-bundle.pem
MongoDB en DocumentDB
-
Deshabilitar MongoDB in-cluster (
anjana-persistences.mongodb.enabled: false). -
Crear a mano la base de datos
anjanay un usuarioreadWriteenadmin. -
MONGO_URIconauthSource=admin&replicaSet=rs0&tls=true&retryWrites=false. -
Añadir la CA de DocumentDB con
global.tls.internal.truststore.extraCaBundles, igual que la de RDS. -
Versión soportada: DocumentDB 8.
Resolución DNS del proxy CDN (nginxResolver)
El nginx de anjana-ui resuelve el upstream del CDN en el arranque con el resolver del sistema. Si tu distribución Kubernetes necesita un resolver explícito, fija la ClusterIP de kube-dns en el values:
global:
nginxResolver: "10.96.0.10"
Con el valor vacío (por defecto) se usa el resolver de la imagen.
Activación de plugins (conectores)
El subchart anjana-plugins incluye 20 conectores, todos desactivados por defecto:
tp-aqtiva tp-aws-glue tp-aws-iam tp-aws-s3 tp-az-ad tp-az-storage tp-gcp-bigquery tp-gcp-iam tp-gcp-storage tp-jdbc tp-jdbc-denodo tp-jdbc-oracle tp-jdbc-redshift tp-jdbc-snowflake tp-jdbc-sqlserver tp-ldap tp-powerbi tp-tableau tp-databricks tp-snowflake
La imagen de cada conector es tot-plugin-<nombre> (el nombre sin tp-; el prefijo corto tp- se debe al límite de longitud de nombres de Kubernetes). Excepción Azure: tot-plugin-azure-ad y tot-plugin-azure-storage. Los plugins se registran en tot. Versiones (global.version.plugins) y puertos por defecto:
|
Conector |
Versión |
Puerto |
|---|---|---|
|
|
5.2.0 |
15001 |
|
|
5.2.0 |
15002 |
|
|
5.2.0 |
15003 |
|
|
5.2.0 |
15005 |
|
|
5.1.0 |
15007 |
|
|
5.2.0 |
15008 |
|
|
5.1.0 |
15009 |
|
|
5.1.0 |
15010 |
|
|
5.1.0 |
15012 |
|
|
5.2.0 |
15013 |
|
|
5.2.0 |
15015 |
|
|
5.2.0 |
15016 |
|
|
5.2.0 |
15017 |
|
|
5.2.1 |
15018 |
|
|
5.2.1 |
15019 |
|
|
5.0.0 |
15020 |
|
|
1.1.0 |
15021 |
|
|
5.2.1 |
15022 |
|
|
5.1.0 |
15025 |
|
|
1.0.0 |
15030 |
Para activar un conector hacen falta tres ajustes:
-
Habilitar el subchart en el fichero de values:
anjana-plugins:
enabled: true
-
Comprobar la versión del conector en
global.version.plugins. El kit trae fijada la de cada conector (ver tabla):
global:
version:
plugins:
tp-jdbc: "5.2.0"
-
Marcar
enabled: trueen la entrada del conector dentro de la listapluginsdecharts/anjana-plugins/values.yaml.
IMPORTANTE: si se activa un conector sin fijar su versión, el renderizado falla con el error version required: set global.version.plugins.<nombre>. Ten en cuenta también que Helm sustituye las listas completas: si defines la lista plugins en un fichero override, debes copiarla entera; por eso se recomienda editar enabled directamente en el values del subchart.
NOTA: cada conector activo reserva por defecto 512Mi de RAM (requests) y 1Gi (limits).
Configuración de plugins standalone
Por defecto los plugins obtienen su configuración a través de Horus. Con global.plugins_config.standalone: true pueden leerla de un backend propio, con dos opciones excluyentes bajo global.plugins_config.secrets_backend:
-
aws_secrets_manager: credenciales AWS en un Secret de Kubernetes (plugins-aws-credscon las clavesaccessKeyId/secretAccessKey) y región configurable. -
aes_file: fichero de configuración cifrado AES montado desde un Secret (plugins-aes-config), con la passphrase en otro Secret.
global:
plugins_config:
standalone: true
secrets_backend:
aes_file:
enabled: true
secretName: plugins-aes-config
encryptedFileKey: application.yaml.aes
passphraseSecret:
name: plugins-aes-config
key: passphrase
Gestión de versiones
Las versiones se controlan de forma individual en los values del chart, sin modificación de YAMLs de manifiestos:
global:
version:
core:
horus: 6.0.0
hermes: 6.0.2
kerno: 6.0.2
minerva: 6.0.2
portuno: 6.0.1
tot: 5.2.0
viator: 6.0.0
zeus: 6.1.0
drittesta: 6.0.0
marketplace: 1.0.0
anjana-ui: 5.2.1
portuno-ui: 5.2.0
adp-mcp: 1.0.2
Para actualizar un único servicio, modifica su versión y ejecuta helm upgrade.
Gestión de la seguridad en Anjana
Gestión y renovación de certificado
IMPORTANTE: Desde 26.k1 el certificado TLS es requerido para la comunicación entre microservicios y el acceso a los frontales.
En modo internal, cert-manager gestiona la renovación automáticamente antes de que el certificado expire. No se requiere intervención manual.
En modo manual, es responsabilidad del operador renovar el certificado antes de su expiración ejecutando anjana setup con los nuevos ficheros de certificado exportados.
Restricción de CORS y protecciones del gateway
Cuando se define global.domain, el API gateway (viator) restringe CORS exclusivamente a ese origen. Con el valor vacío (por defecto) se permite cualquier origen, opción menos segura.
global:
domain: "anjana.cliente.com"
RECOMENDADO: definir siempre global.domain en entornos productivos.
Además, los frontales y el gateway incorporan de serie (sin configuración adicional): limitación de tasa de peticiones en el endpoint de login, cabeceras de seguridad HTTP y propagación del identificador de traza X-traceId para correlar peticiones en los logs al trabajar con soporte.
Seguridad en los frontales
En este kit los frontales (anjana-ui, portuno-ui) son Deployments con nginx. Para securizarlos:
RECOMENDADO: proteger los frontales mediante un proxy inverso, balanceador o WAF delante del Ingress/LoadBalancer del cluster.
Ambos frontales comparten el mismo puerto 443 y se distinguen por path (/ para anjana-ui, /configpanel para portuno-ui), no por puerto. El chart no crea Ingress ni LoadBalancer (todos los Services son ClusterIP): exponer con dos reglas, /configpanel* → portuno-ui:443 y /* → anjana-ui:443. Se recomienda un 403 fijo para /horus* en el balanceador.
Personalizar la configuración nginx de los frontales
anjana-ui monta por defecto una plantilla nginx del chart (charts/anjana-core/files/nginx/anjana-ui.conf.template). Esta plantilla devuelve 403 en /horus/balancer y /horus/eureka, y bloquea los listados de instancias y el Actuator de Spring Boot Admin bajo /horus/admin. portuno-ui usa la configuración nginx incluida en su imagen. Por defecto no hace falta tocar nada.
Si necesitas personalizarla (cabeceras extra, restricción por IP, rutas adicionales...), el chart permite sobrescribirla con tu propia ConfigMap, sin modificar la imagen ni entrar al pod manualmente:
core:
- name: portuno-ui
nginxConfigOverride:
enabled: true
configMapName: "portuno-ui-nginx-override"
La ConfigMap debe crearse antes del helm install/upgrade, con una única clave default.conf.template que contenga la configuración nginx completa (no es un parche parcial: sustituye toda la configuración del frontal). Punto de partida: para anjana-ui, copiar charts/anjana-core/files/nginx/anjana-ui.conf.template; para portuno-ui, config-reference/config-core/portuno-ui.config.yaml. Al personalizar anjana-ui, conservar los bloqueos de /horus.
IMPORTANTE: si nginxConfigOverride.enabled: true pero falta configMapName, o la ConfigMap referenciada no existe todavía en el namespace, el guardrail del chart hace fallar el helm install/upgrade en modo strict con un mensaje descriptivo (en permissive solo avisa). Crea la ConfigMap antes de aplicar el values con el override activado.
NOTA: este mecanismo no requiere ningún cambio en las imágenes de los frontales. Monta el fichero directamente en /etc/nginx/templates/default.conf.template, el mismo path que ya procesa el entrypoint estándar de la imagen nginx al arrancar el contenedor (vía envsubst) — el mismo mecanismo que ya usan internamente variables como NGINX_PORT o HEALTH_LOCATIONS_CONF.
Utilidades
SeaweedFS - Gestión de buckets
SeaweedFS crea al arrancar el bucket CDN (anjana-persistences.seaweedfs.cdnBucket, por defecto cdn) y los buckets S3_BUCKET_* definidos en anjana-secrets. Para crear un bucket adicional a mano:
kubectl exec seaweedfs-0 -n anjana-data -c seaweedfs -- sh -c \
'echo "s3.bucket.create -name <bucket>" | weed shell -master=localhost:9333 -filer=localhost:8888 2>/dev/null'
Dashboards de gobierno (Grafana)
El kit incluye en anjana-dashboards/ un despliegue de Grafana con datasources y aprovisionamiento preconfigurados, junto con el dashboard de gobierno del dato de Anjana (anjana-data-governance.yaml):
kubectl apply -f anjana-dashboards/ -n <namespace>
Referencia de configuración (config-reference/)
El directorio config-reference/ documenta las claves de configuración que espera cada servicio. Son ficheros de referencia: no se aplican durante la instalación; la fuente autoritativa de configuración es el bundle cifrado (secrets/anjana.env.aes) o AWS Secrets Manager según el modo.
Excepción: portuno-ui.config.yaml sí está pensado para aplicarse como base de nginxConfigOverride. Para anjana-ui, la base es charts/anjana-core/files/nginx/anjana-ui.conf.template (ver sección "Personalizar la configuración nginx de los frontales" más arriba).
Para inspeccionar la configuración efectiva que recibe un servicio:
# Consultar Horus Config Server directamente
kubectl -n anjana-data exec -it horus-0 -- curl -sk https://horus:9999/portuno/default | jq