Instalación
26.1 25.2 25.1
26.1 25.2 25.1 Spanish English

Avanzado k8s

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.user y persistences.bbdd.pass: credenciales de acceso a PostgreSQL. Las usan el StatefulSet de PostgreSQL in-cluster y el Job anjana-db-schemas. Los servicios usan DB_URL, DB_USER y DB_PASS, que sirve Horus.

  • persistences.bbdd.url: URL de conexión en formato host:port/db. Ejemplo: postgresql:5432/anjana. En despliegues cloud apunta a RDS.

  • persistences.mongodb.user y persistences.mongodb.pass: credenciales de MongoDB.

  • persistences.rabbitmq.user y persistences.rabbitmq.pass: credenciales de RabbitMQ.

  • persistences.valkey.pass: contraseña de Valkey (Redis compatible).

  • persistences.s3.access_key y persistences.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 por anjana setup para 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.

YAML
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 TLS internal, el ClusterIssuer y los Secrets de keystorePasswordSecret, truststore y caSource; con el backend native, el Secret anjana-config; sin backend cloud, que global.horus.config.envSecretName esté definido; y que hay exactamente un backend de Config Server habilitado.

  • permissive: solo avisa. Útil para validar en local (make test) o en laboratorio.

YAML
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.

YAML
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:

Bash
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:

Bash
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:

YAML
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:

YAML
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:

  1. Deshabilita PostgreSQL en cluster en el fichero de values:

YAML
anjana-persistences:
  postgresql:
    enabled: false
  1. Actualiza la URL de conexión en el bundle de credenciales:

Bash
# 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:

YAML
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 anjana y un usuario readWrite en admin.

  • MONGO_URI con authSource=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:

YAML
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

tp-jdbc

5.2.0

15001

tp-gcp-bigquery

5.2.0

15002

tp-gcp-storage

5.2.0

15003

tp-jdbc-sqlserver

5.2.0

15005

tp-aws-s3

5.1.0

15007

tp-aws-iam

5.2.0

15008

tp-az-ad

5.1.0

15009

tp-gcp-iam

5.1.0

15010

tp-az-storage

5.1.0

15012

tp-jdbc-oracle

5.2.0

15013

tp-ldap

5.2.0

15015

tp-powerbi

5.2.0

15016

tp-jdbc-redshift

5.2.0

15017

tp-jdbc-denodo

5.2.1

15018

tp-aws-glue

5.2.1

15019

tp-aqtiva

5.0.0

15020

tp-databricks

1.1.0

15021

tp-tableau

5.2.1

15022

tp-jdbc-snowflake

5.1.0

15025

tp-snowflake

1.0.0

15030

Para activar un conector hacen falta tres ajustes:

  1. Habilitar el subchart en el fichero de values:

YAML
anjana-plugins:
  enabled: true
  1. Comprobar la versión del conector en global.version.plugins. El kit trae fijada la de cada conector (ver tabla):

YAML
global:
  version:
    plugins:
      tp-jdbc: "5.2.0"
  1. Marcar enabled: true en la entrada del conector dentro de la lista plugins de charts/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-creds con las claves accessKeyId / 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.

YAML
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:

YAML
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.

YAML
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:

YAML
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:

Bash
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):

Bash
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:

Bash
# Consultar Horus Config Server directamente
kubectl -n anjana-data exec -it horus-0 -- curl -sk https://horus:9999/portuno/default | jq

Last updated: