Requisitos
- Helm 3.8+
- Kubernetes 1.28+ u OpenShift 4.14+
- Para data stores en
mode: operator, el operador correspondiente instalado en el clúster
Inicio rápido (data stores integrados)
El modo por defectobundled levanta PostgreSQL (pgvector), MongoDB y RabbitMQ como
StatefulSets gestionados por el chart — el equivalente a USE_LOCAL_DB=true de
Docker Compose. Un solo comando, sin operadores:
imageTag fija la versión de Kodus para todo el stack (como el IMAGE_TAG de
Docker Compose); usa una tag real, nunca latest, en producción. Los secrets de
autenticación/cifrado se generan automáticamente con el formato correcto y se
mantienen estables entre upgrades.
Modos de data store
Cada store (postgres, mongodb, rabbitmq) tiene un mode independiente:
En producción, prefiere
external u operator — delegan la operación de la base de
datos a algo hecho para ello.
OpenShift
Añade el overlay de OpenShift — los Routes reemplazan al Ingress y los UIDs de los pods se dejan al SCC del namespace (restricted-v2), sin UIDs fijos:
route.hosts.*.host vacío para que OpenShift asigne automáticamente el
hostname <name>-<namespace>.apps…. Ten en cuenta que algunos clústeres reflejan o
bloquean imágenes library/* de Docker Hub, por lo que la imagen integrada de
mongo puede necesitar un override (--set mongodb.bundled.image=mirror.gcr.io/library/mongo:8)
o un data store external / operator.
Servicios opcionales y verificación
- MCP manager —
--set services.mcp-manager.enabled=true - Worker de analytics —
--set services.worker-analytics.enabled=true - Health check —
../../scripts/doctor-k8s.sh -n kodusinspecciona workloads, configuración y los endpoints reales de salud.
Referencia completa de Helm
Configuración de los operadores de data store, reutilización de bases existentes,
instalaciones air-gapped, secrets con ExternalSecrets, observabilidad y valores de
seguridad por defecto.