Stacks (IaC)

Los stacks te permiten definir la configuración completa de tu tenant de Cortex como código, al estilo de AWS CloudFormation: escribes un template YAML que describe tus recursos (cuentas de proveedor, modelos, secretos, skills, fuentes de tools, agentes, reglas de enrutamiento y hooks) y Cortex lo materializa por ti, en el orden correcto y con rollback automático si algo falla.

Los tres conceptos

Template. Un documento YAML con tres secciones: parameters (entradas, incluidas las sensibles marcadas noEcho), resources (los recursos a materializar) y outputs (valores que el stack expone al terminar). Las referencias entre recursos se declaran con !Ref, !GetAtt y !Sub, y de ellas Cortex deriva el grafo de dependencias y el orden de despliegue. Ver la referencia de templates.

Stack. La instancia de un template en tu tenant. Guarda el template aplicado, los parámetros resueltos (los sensibles quedan redactados), el mapeo de cada nombre lógico a su recurso físico y el estado del despliegue (CREATE_COMPLETE, UPDATE_IN_PROGRESS…).

ChangeSet. El diff calculado entre lo que hay y lo que el template propone: qué recursos se agregan, cuáles se modifican, cuáles se recrean y cuáles se eliminan. Nada se aplica sin un changeset aprobado: primero revisas el diff y luego lo ejecutas explícitamente.

Garantías del motor

• Los secretos jamás viajan en el template. Los valores sensibles (API keys, tokens) entran siempre por parámetros noEcho y quedan redactados en todo lo que el sistema persiste o expone. Ver Seguridad.
• Idempotencia por adopción. Si un recurso equivalente ya existe en tu tenant (misma clave natural, p. ej. un secreto con el mismo slug), el stack lo adopta en lugar de duplicarlo. Aplicar dos veces el mismo template produce un changeset vacío.
• Rollback automático. Si un recurso falla a mitad del despliegue, Cortex revierte lo ya aplicado y deja el tenant en el estado anterior.
• Sin lógica duplicada. El motor crea, actualiza y elimina llamando a los mismos servicios que usa el portal, así que un recurso creado por stack es idéntico a uno creado a mano — y puedes seguir gestionándolo desde su pantalla nativa.

Cómo se usa

Puedes trabajar desde el portal de Cortex (sección Stacks: galería de plantillas, editor con validación en vivo, diff visual y traza de eventos) o por API REST, ideal para CI y para agentes de IA que crean stacks por ti.