Instalación
26.1 25.2 25.1
26.1 25.2 25.1 Spanish English

Casos de uso k8s

AWS S3 como almacenamiento de objetos

En entornos cloud o cuando se dispone de buckets en AWS S3, el kit puede configurarse para usar S3 directamente en lugar de SeaweedFS.

Para activar el modo AWS S3, modifica el fichero de values:

YAML
global:
  cdnProxy:
    mode: aws_s3
    bucket: "anjana-prod-cdn"
    aws_s3:
      region: "eu-central-1"

anjana-persistences:
  seaweedfs:
    enabled: false

Las credenciales de acceso a S3 (S3_ACCESS_KEY y S3_SECRET_KEY) deben estar presentes en el bundle de configuración. El proxy /cdn/ no firma las peticiones: el bucket CDN debe permitir GetObject anónimo (se puede restringir al VPC endpoint). Más detalles sobre la configuración pueden encontrarse en Avanzado k8s, apartado Buckets en AWS S3.

RECOMENDADO: el uso de buckets en AWS S3 para entornos de producción cloud. Aunque se use IRSA (EKS), S3_ACCESS_KEY y S3_SECRET_KEY son obligatorias: solo Horus usa IRSA.

SeaweedFS como almacenamiento local

Para entornos on-premise o de laboratorio, el kit incluye SeaweedFS como solución S3-compatible en cluster.

Para activar SeaweedFS, modifica el fichero de values:

YAML
global:
  cdnProxy:
    mode: seaweedfs
    bucket: "cdn"            # igual que anjana-persistences.seaweedfs.cdnBucket
    seaweedfs:
      endpoint: "https://seaweedfs:8333"

anjana-persistences:
  enabled: true
  seaweedfs:
    enabled: true
    storage:
      type: hostPath         # hostPath | pvc | emptyDir
      hostPath: /opt/data/seaweedfs

Al arrancar, SeaweedFS crea el bucket CDN y los buckets S3_BUCKET_* de anjana-secrets (ver Avanzado k8s, apartado SeaweedFS - Gestión de buckets).

NOTA: Las persistencias dentro de Kubernetes NO soportan HA por naturaleza. ✅RECOMENDADO: usar persistencias cloud (S3, RDS) en producción.

PostgreSQL RDS como sustituto de PostgreSQL

La conexión a un RDS no requiere prácticamente diferencias en la configuración, dado que la cadena de conexión es compatible directamente.

Para usar RDS, deshabilita el StatefulSet de PostgreSQL en cluster y apunta al RDS en el bundle de credenciales:

YAML
anjana-persistences:
  postgresql:
    enabled: false
Bash
# En horus.env (antes de ejecutar anjana horus update)
DB_URL=my-rds.eu-central-1.rds.amazonaws.com:5432
DB_USER=anjana
DB_PASS=<contraseña>
persistences.bbdd.url=my-rds.eu-central-1.rds.amazonaws.com:5432/anjana
persistences.bbdd.user=anjana
persistences.bbdd.pass=<contraseña>

La CA de RDS se añade con global.tls.internal.truststore.extraCaBundles. Más detalles pueden encontrarse en Avanzado k8s, apartado PostgreSQL en RDS.

Despliegue de entorno HA

Para el despliegue en modo High Availability de Anjana, se realiza un despliegue normal siguiendo los 3 pasos del Manual de despliegue. Una vez el entorno está completamente operativo, se escalan los microservicios deseados:

Bash
kubectl scale deployment/portuno  --replicas=2 -n anjana-data
kubectl scale deployment/kerno    --replicas=2 -n anjana-data
kubectl scale deployment/minerva  --replicas=2 -n anjana-data
# ... otros servicios según el SLA requerido

El chart no expone nodeSelector, affinity ni tolerations: el reparto entre nodos lo decide el scheduler. Para comprobar en qué nodos han quedado los pods:

Bash
kubectl get pods -n anjana-data -o wide

IMPORTANTE: Esperar a que el entorno esté completamente operativo antes de aplicar el escalado. Los microservicios dependen de Horus para su configuración; escalar antes de que estén listos puede provocar reinicios consecutivos.

NOTA: El microservicio Horus ya se encuentra escalado a 2 réplicas por defecto (StatefulSet). Dada la naturaleza del Config Server, es ✅RECOMENDADO dejarlo siempre en esa configuración.

Para que el escalado persista entre upgrades de Helm, ajusta el campo replicas de cada servicio en el listado anjana-core.core de tu fichero de values override. Consulta el fichero charts/anjana-core/values.yaml del kit para ver la estructura completa de cada entrada.

Para verificar el estado tras el escalado:

Bash
kubectl get pods -n anjana-data

Despliegue cloud completo (EKS + IRSA + AWS Secrets Manager)

En entornos EKS con AWS Secrets Manager, el kit puede configurarse para que Horus lea la configuración directamente de AWS SM mediante IRSA, sin necesidad de crear anjana-secrets manualmente.

En entornos EKS con AWS Secrets Manager, el kit puede configurarse para que Horus lea la configuración directamente de AWS SM mediante IRSA. anjana-secrets sigue siendo necesario: lo crea anjana setup y Solr lee de él anjana.domain.

YAML
global:
  horus:
    aws:
      region: "eu-central-1"
      prefix: "/secret/prod"
      serviceAccountName: "horus-prod-sm-sa"
      iamRoleArn: "arn:aws:iam::<AccountID>:role/<RoleName>"
    config:
      cloud: true
      secrets_backend:
        aws_secrets_manager:
          enabled: true
    config_server:
      aws_secrets_manager:
        enabled: true

anjana-persistences:
  enabled: true            # solo Solr en el clúster
  postgresql: {enabled: false}   # RDS
  mongodb: {enabled: false}      # DocumentDB
  rabbitmq: {enabled: false}     # Amazon MQ
  valkey: {enabled: false}       # ElastiCache
  seaweedfs: {enabled: false}    # S3
  solr:
    enabled: true
    storage:
      data:   {type: pvc, storageClass: gp3, size: 10Gi}
      config: {type: pvc, storageClass: gp3, size: 5Gi}

En este modo, el Job anjana-db-schemas no se renderiza: Horus lee la configuración del secreto <global.horus.aws.prefix>/application_default/ de AWS SM, y PostgreSQL, MongoDB, RabbitMQ y Valkey son servicios gestionados externos al cluster. AWS no ofrece Solr gestionado, por lo que Solr va en el clúster. El nombre termina en barra (/): sin ella Horus no encuentra el secreto.

Activación de un conector (plugin)

Para conectar Anjana con una fuente de datos externa (por ejemplo una base de datos vía JDBC), activa el conector correspondiente en el fichero de values y aplica el upgrade:

YAML
anjana-plugins:
  enabled: true

global:
  version:
    plugins:
      tp-jdbc: "5.2.0"

Marca además enabled: true en la entrada del conector en charts/anjana-plugins/values.yaml y ejecuta:

Bash
helm upgrade anjana-platform . -f values-<env>.yaml -n anjana-data --wait

La lista completa de los 20 conectores disponibles y las opciones de configuración standalone están en Avanzado k8s, apartado Activación de plugins (conectores).

Last updated: