Ciclos de vida Day-2
Ciclos de vida Day-2 y ejecución temporal
Un compilador anticipado (Ahead-of-Time, AOT) agnóstico respecto a las capacidades crea inherentemente una brecha entre la intención declarativa (Day-1) y la realidad operativa (Day-2). La nube no es perfectamente determinista, el despliegue requiere una secuenciación temporal y los desarrolladores necesitan disparadores imperativos para las tareas de mantenimiento.
Aggrega salva estructuralmente estas brechas mediante polyfills arquitectónicos específicos y un enrutamiento nativo de GitOps, de modo que las configuraciones generadas satisfacen estas necesidades operativas sin comprometer la pureza del compilador central.
1. El modelo de ejecución DAG (secuenciación temporal)
El problema: el despliegue de infraestructura es un grafo acíclico dirigido (DAG) del tiempo. Una task de migración de base de datos debe ejecutarse hasta completarse antes de que arranque el server web. Sin embargo, los compiladores AOT generan carpetas planas de YAML estático o Terraform. Si entregas estas carpetas planas a un controlador GitOps (como ArgoCD), lo aplica todo simultáneamente, y el servidor web entra en un bucle de fallos mientras espera a la base de datos.
La solución: syncWave por frontera en la Release El Aggregate del desarrollador queda intacto. Como la secuenciación es una realidad operativa física, se gestiona estrictamente en el Dominio 4 (la Release). Cada frontera de la Release lleva un campo opcional syncWave: <integer>, que permite al operador de plataforma escalonar explícitamente el orden de despliegue a nivel de frontera.
apiVersion: aggrega.ai/v1beta1kind: Releasemetadata: name: sequenced-release version: 1.0.0 environment: productionspec: aggregate: my-app manifest: prod-manifest boundaries: infra: syncWave: 0 components: core-vpc: {} postgres-db: {} migrations: syncWave: 1 components: db-migration-task: {} apps: syncWave: 2 components: web-server: {} support-agent: {}Semántica del valor de oleada:
- La oleada es un entero con signo; el valor predeterminado es
0. Los valores negativos se ejecutan antes que todo lo demás (CRD, namespaces, RBAC); los valores mayores se ejecutan después de los menores. Los operadores fijan los valores según su topología de despliegue. - Cada instancia de componente contenida directamente en una frontera hereda el valor de oleada de la frontera en su nodo IR. No existe una anulación por componente en la capa de autoría — el orden por recurso interno del provider dentro de una misma frontera es asunto del provider.
- Las fronteras anidadas no heredan implícitamente. Una frontera anidada que no declara
syncWavetoma el valor predeterminado0, independientemente de la declaración de la frontera exterior. Los operadores que quieren «todoouteres la oleada 1, incluida su subfronterainner» declaransyncWave: 1en ambas.
El efecto del compilador: El compilador propaga el valor de wave de cada boundary a los manifiestos renderizados en ese boundary. Los Providers emiten primitivas de secuenciación nativas:
- Para Kubernetes (ArgoCD/Flux): el provider helm emite
argocd.argoproj.io/sync-wave: "<N>"como entrada demetadata.annotationsen cada manifiesto renderizado, y un recurso que el chart marca como hook de Helm recibe ademáshelm.sh/hook-weight: "<N>"para el orden nativo de los hooks de Helm. El provider helm-chart emite la anotación solo en los archivos de plantilla que una Recipe añade a un chart medianteartifacts:; copia sin cambios las plantillas propias del chart, por lo que estas no llevan ninguna wave. - Para Compose: el provider compose expresa el orden como
depends_onentre los servicios del archivo en el que se renderiza una frontera, condicionado al estado de salud del destino cuando el destino declara unhealthchecky a su arranque cuando no lo declara.depends_onnombra un servicio dentro de un solo archivo, por lo que el orden entre dos archivos compose no es expresable; los operadores secuencian proyectos compose separados en la capa de invocación dedocker compose up. - Para CloudFormation: el provider cloudformation expresa el orden como
DependsOnentre los recursos de la plantilla de stack en la que se ensambla un grupo de despacho; cada recurso nombra los recursos de la oleada poblada inmediatamente anterior y el destino encadena el resto. El atributo rige el orden de eliminación, a la inversa, además del orden de creación; no expresa ninguna condición de disponibilidad, porque una plantilla no tiene noción de que un recurso esté operativo.DependsOnnombra un recurso dentro de una sola plantilla, por lo que el orden entre dos stacks no es expresable; los operadores secuencian stacks separados en la capa de despliegue. - Para Terraform: el provider terraform expresa el orden como
depends_onentre los bloquesmodulede la configuración raíz en la que se ensambla un boundary, y cada módulo nombra los módulos de la wave poblada inmediatamente anterior mientras Terraform encadena el resto. Ordena las acciones que Terraform realiza y no expresa ninguna condición de disponibilidad, porque una configuración no tiene noción de que un recurso esté en condiciones de servir.depends_onnombra un módulo dentro de una configuración, por lo que el orden entre dos configuraciones raíz no es expresable; secuenciarlas es responsabilidad del operador.
La clave interna de Aggrega aggrega.ai/sync-wave: "<N>" se distribuye junto a la anotación de ArgoCD con fines de observabilidad y procedencia —como anotación en la salida de helm y en los archivos de plantilla que una Recipe añade a un chart de helm-chart, como etiqueta de servicio en compose, como una línea del comentario de procedencia en cada módulo de terraform y bajo el Metadata."aggrega.ai/provenance" de cada recurso de cloudformation—, mientras que la anotación de ArgoCD es lo que consumen los controladores GitOps.
Unidad de autoría de oleadas frente a unidad desplegable
La frontera es la unidad de autoría de oleadas. La unidad desplegable es la ruta de ensamblado — la salida en disco producida por el compilador sobre la que orquesta una pipeline de CI/CD. De forma predeterminada, una frontera corresponde a una ruta de ensamblado: los componentes de cada frontera se emiten en boundaries/<boundary-name>/<provider>/, y helm install / docker compose up se ejecuta sobre esa ruta.
Los operadores pueden colapsar esta correspondencia 1:1. Las fronteras pueden declarar campos de plantilla de ruta directory: (y subDirectory:) que, cuando se comparten entre fronteras, dirigen los componentes de esas fronteras a una única salida ensamblada en la ruta compartida. Dos fronteras que declaran directory: "deploy/cluster" producen una única salida ensamblada que contiene componentes de ambas — la unidad desplegable pasa a ser la ruta de ensamblado, no la identidad de la frontera.
Los manifiestos con oleadas mixtas dentro de una misma salida ensamblada son normales y están admitidos. Cuando la frontera A declara syncWave: 1 y la frontera B declara syncWave: 2, y ambas comparten directory: "deploy/cluster", la unidad desplegable resultante contiene los componentes de ambas fronteras; cada manifiesto lleva la anotación de oleada de su frontera de origen. Las herramientas de tiempo de ejecución leen las anotaciones por recurso y ordenan dentro de la unidad de despliegue ensamblada — el contexto de sincronización por Application de ArgoCD procesa los manifiestos de la oleada 1, espera a que estén Healthy y luego procesa la oleada 2; el orden de hooks de Helm lee helm.sh/hook-weight por recurso de hook. Este es el patrón estándar de ArgoCD: la emisión por recurso es exactamente la entrada que esperan los consumidores de otras herramientas.
La secuenciación entre Applications (cuando un operador ejecuta varias Applications de ArgoCD sobre salidas ensambladas separadas) es configuración de CI a nivel del operador — Aggrega produce los artefactos; el operador conecta sus Applications de ArgoCD en torno a ellos mediante app-of-apps o Progressive Sync. El patrón de anotación por recurso de Aggrega es la forma de entrada estándar que espera todo consumidor de otras herramientas.
2. El polyfill de direccionamiento dinámico
El problema: la nube no es determinista en el momento de la creación. Recursos como las instancias de AWS RDS o los buckets de S3 generan hashes de URL aleatorios solo después de haberse aprovisionado físicamente. Como el compilador AOT genera la configuración antes de que la nube aprovisione nada, es físicamente imposible que el compilador inyecte la URL literal de la base de datos en la variable de entorno de un contenedor.
La solución: punteros deterministas mediante las Features de credenciales Aggrega lo resuelve aprovechando las Features de credenciales existentes y trasladando la definición de «determinista» de una dirección IP literal a un puntero determinista. La configuración generada no pasa la URL; pasa la ruta a un Cloud Vault donde la URL existirá.
- Ejemplo 1: la generación de la salida (Terraform RDS) La Recipe de Ops de la base de datos crea la instancia de AWS RDS. Lo fundamental es que la Recipe está escrita para enviar de forma nativa esa URL dinámica recién generada a AWS Systems Manager (SSM) Parameter Store, en una ruta con nombre determinista (p. ej.,
/aggrega/prod/db-url). - Ejemplo 2: la inyección de la entrada (aplicación de Kubernetes) El desarrollador adjunta la Feature de credencial
core/referenced-secretal worker, en un slot que declara su Component, conoriginestablecido en la cadena del puntero determinista ("/aggrega/prod/db-url"). En un destino Kubernetes, el Manifest enlaza ese adjunto ahelm/k8s-external-secret, que renderiza unExternalSecretde Kubernetes que pide al operador del almacén de secretos del clúster que traiga esa entrada a un Secret, y publica el nombre del Secret y su clave de datos; la Recipe del worker los lee a través de losattachments:de su contenedor y renderiza una variable de entorno del Pod asignada avalueFrom: secretKeyRef(consulta Cómo llega una credencial a un contenedor). El compilador canaliza la cadena del puntero y nunca lee la URL.
En tiempo de ejecución, Terraform aprovisiona la base de datos y guarda la URL en el vault. El contenedor arranca, lee el Secret reconciliado desde el vault y se conecta. El compilador AOT generó las relaciones mediante cadenas de puntero estables sin necesitar nunca la dirección IP literal.
3. Acciones imperativas (el traspaso ejecutable)
El problema: el estado declarativo es perfecto para el aprovisionamiento Day-1, pero los desarrolladores necesitan ejecutar acciones imperativas: «Haz una copia de seguridad de la base de datos ahora mismo.» Una pipeline GitOps estrictamente declarativa no tiene un mecanismo nativo para volver a disparar un script estático.
La solución: tareas latentes y el comando propio del destino Aggrega lo resuelve preservando una estricta pureza AOT. Genera la configuración de una tarea que se despliega sin iniciarse, y cada ejecución se inicia en el destino con el comando propio del destino.
- La intención del desarrollador: el desarrollador declara el script como una
tasken elAggregatey adjunta una Feature que pide que se ejecute bajo demanda (p. ej.,core/manual-trigger). Ejecutarse bajo demanda forma parte de lo que es la tarea, así que la adjunta el desarrollador; una Feature cuyas entradas son todas operativas la adjunta, en cambio, operaciones, en la Release. - La forma latente: La Recipe propia de la tarea en cada destino lee el adjunto y renderiza la tarea en una forma que se despliega sin iniciar una ejecución. En Kubernetes la tarea es un
CronJobretenido consuspend: true, con una programación que indica una fecha que nunca llega, en lugar delJobque se ejecutaría en cuanto se desplegara. En Docker Compose el servicio de la tarea, que Compose no reinicia una vez que termina, lleva el perfilmanual, así quedocker compose uplo deja detenido. En Amazon ECS, mediante Terraform o CloudFormation, la definición de tarea se despliega sola, sin ninguna programación que la inicie. La FeatureRecipe que el Manifest vincula para el adjunto no añade ningún archivo propio en ningún destino: el cambio está en la salida propia de la tarea. - La entrega: El compilador no llega a ningún clúster ni llama a ninguna API de la nube, y la compilación no inicia ninguna ejecución ni escribe ningún script. Cada ejecución la inicia el operador, con el comando propio del destino:
kubectl create job <run-name> --from=cronjob/<cronjob>en Kubernetes,docker compose run --rm <service>en Docker Compose yaws ecs run-tasken Amazon ECS, al que se le pasan el clúster, la definición de tarea y la configuración de red que la Release establece eninfra.overridesde la tarea. La generación de la configuración y la ejecución en runtime permanecen separadas.
(Nota: en Kubernetes y Amazon ECS, una tarea que lleva una programación se ejecuta según ella tanto si el adjunto está como si no, y el mismo comando inicia una ejecución adicional entre las programadas; en Docker Compose, que no tiene planificador, la Recipe de la tarea rechaza una programación. El ejemplo completo task-run-on-demand compila un Aggregate para Kubernetes, Docker Compose, Terraform y CloudFormation, y muestra en cada uno la salida renderizada y el comando que inicia una ejecución.)
4. Preanálisis: el hook del workspace (RBAC y cuotas de la plataforma)
El problema: algunos cambios aprovisionan infraestructura cara o crítica para producción — un gran clúster de GPU, por ejemplo — y no deben llegar a la pipeline GitOps sin revisión. Qué colaboradores pueden promover qué cambios a qué entornos es una decisión de política organizativa; el compilador no debe codificarla de forma fija.
La solución: un compilador AOT puro no puede consultar Active Directory ni obtener credenciales de la nube para averiguar quién ejecuta la compilación. Para impedir la generación no autorizada antes incluso de que se ejecute la CI/CD, la arquitectura se apoya en una inyección explícita de contexto.
Cuando un runner de CI/CD invoca aggrega build, el pipeline escribe el contexto de ejecución en un archivo de configuración que pasa con --config, como with.settings de la asociación de gobernanza que lo juzga (p. ej., approval: standard). El archivo enumera sus asociaciones bajo governance_append, de modo que se suman a los plugins de gobernanza que asocia la propia configuración del espacio de trabajo en lugar de ser reemplazadas por ellos. Una política en el rol ir-verdict lee esos ajustes como input.settings. Recibe el grafo ensamblado y no la Release, así que el entorno de la Release le llega como etiqueta: una política en el rol label-transform lee input.compilation_context.environment y etiqueta con él cada nodo. El veredicto compara ambos y detiene la compilación cuando no coinciden —aquí, una compilación de producción cuyos ajustes no llevan approval: platform-approved:
# ci-governance.yaml — written by the CI/CD runner, passed as `aggrega build --config ci-governance.yaml`plugins: governance_append: - uri: governance/rego:<version> role: label-transform with: sources: - policies/environment.rego - uri: governance/rego:<version> role: ir-verdict with: sources: - policies/approval.rego settings: approval: standard# policies/environment.rego — evaluated by the governance label-transform role, during topology constructionpackage acme.context
import rego.v1
labels contains {"node": id, "key": "acme.com/environment", "value": input.compilation_context.environment} if { some id, _ in input.graph.nodes}# policies/approval.rego — evaluated by the governance ir-verdict role over the assembled graphpackage acme.approval
import rego.v1
approved if input.settings.approval == "platform-approved"
deny contains msg if { not approved some node in input.graph.spec.nodes node.labels["acme.com/environment"] == "production" msg := "a production build needs the approval platform-approved in the pipeline's governance settings."}También se rechaza una ejecución cuyos ajustes no llevan ninguna aprobación, porque la regla pregunta si la aprobación está presente y no si lo está una distinta. Esto aísla el RBAC de la lógica nativa del compilador y garantiza que el compilador actúe puramente como un evaluador determinista de los datos proporcionados.
5. FinOps shift-left (estimación de costes mediante políticas)
El problema: las configuraciones erróneas accidentales (p. ej., solicitar workers: 500) pueden eludir las salvaguardas financieras y provocar grandes sobrecostes en la nube.
La solución (políticas Wasm empresariales): como el grafo IR contiene la topología completa y la Release contiene el mapeo físico (.infra), las empresas pueden evaluar el coste exacto de lo que despliega una Release antes de la generación sin necesitar una funcionalidad del compilador codificada de forma fija. Las empresas simplemente escriben un plugin WebAssembly de FinOps personalizado y lo adjuntan al socket de gobernanza en un rol de veredicto. Este plugin personalizado puede leer las cargas útiles .infra, calcular el coste mensual estimado y detener la compilación si el coste calculado supera los límites de presupuesto definidos internamente por la empresa.
6. El ciclo de vida de importación «brownfield»
El problema: las empresas ya tienen en ejecución la mayor parte de su infraestructura. Aunque Aggrega está diseñado para conectar una build a infraestructura no gestionada mediante un workload de referencia (red pass-through; consulta workloads de referencia), trasladar una base de datos Oracle existente al estado de Terraform generado por Aggrega suele hacer que los orquestadores intenten recrear la base de datos, destruyendo los datos existentes.
La solución (prevista): Está prevista una Feature core/resource-adoption para gestionar el ciclo de vida de importación.
Cuando un desarrollador modela la base de datos existente en su Aggregate y adjunta la funcionalidad resource-adoption en una pipeline ejecutada secuencialmente, el plugin de renderizado Wasm está diseñado para evaluar la carga útil de Ops de base de la Recipe. En lugar de emitir las configuraciones de creación estándar, el plugin está diseñado para emitir la sintaxis de adopción explícita de la plataforma de destino (p. ej., devolviendo un JSONPatch con bloques import {} de Terraform o políticas de gestión ObserveOnly de Crossplane). Esto permite a las empresas generar de forma segura configuraciones que incorporan la arquitectura heredada al plano de control GitOps sin tiempo de inactividad.
7. Buenas prácticas de Ops y nomenclatura determinista
Mientras que el compilador central se basa en ID de nodo internos y estables (p. ej., support-db) en el grafo IR plano, los proveedores de nube físicos (como AWS, Azure y GCP) a menudo exigen cadenas globalmente únicas para la infraestructura física (p. ej., nombres de buckets de S3, nombres de roles de IAM o dominios de API Gateway).
Si un ingeniero de Platform Ops codifica de forma fija un nombre físico en su plantilla de base (p. ej., bucket_name: "enterprise-data-bucket"), los artefactos generados se aplicarán sin problemas la primera vez. Sin embargo, si un desarrollador despliega un segundo entorno (p. ej., staging frente a prod), el proveedor de nube rechazará los recursos del segundo entorno en tiempo de ejecución por una colisión de nombres.
La regla de la salida determinista (seguridad de GitOps): como los controladores GitOps (ArgoCD, Flux) detectan diferencias a nivel de byte en los artefactos renderizados, el compilador garantiza que entradas idénticas produzcan salidas idénticas byte a byte. Los mapas que fluyen por el contexto de la plantilla (.context.inject.env, .values, .infra y el resto de la vista de tiempo de ejecución) se respaldan en estructuras de mapa ordenado que conservan el orden de inserción del autor en toda la capa de datos, y la frontera de la plantilla es la única excepción: {{ range }} sobre esos mapas itera en orden alfabético de claves, como hacen las plantillas de Go, no en el orden del autor. Los ingenieros de Ops pueden confiar en que ese orden de iteración es determinista entre ejecuciones de la misma entrada; donde la secuencia tiene significado, se escribe como una lista en lugar de recuperarse de un mapa. Sin embargo, la función keys de Sprig devuelve el orden de iteración de los mapas de Go (que no es determinista por diseño del lenguaje); las plantillas que componen una secuencia de claves determinista a partir de la salida de keys deben canalizarla a través de sortAlpha (p. ej., {{ keys .values | sortAlpha }}) para recuperar el determinismo.
La regla de oro de las Recipes de Ops (el patrón de Helm): los ingenieros de Platform Ops nunca deben codificar de forma fija los nombres físicos de los recursos de nube. En su lugar, deben construir nombres únicos de forma determinista concatenando el contexto de despliegue de Aggrega durante la fase de evaluación de la plantilla. Es una regla de reutilización y de seguridad frente a colisiones, no una regla de determinismo — los nombres codificados de forma fija producen una salida estable pero colisionan fatalmente cuando la misma Recipe renderiza varias instancias de componente o cuando el mismo Aggregate se despliega en varias Releases.
El compilador proporciona exactamente dos variables para garantizar la unicidad global:
{{ .metadata.release_name }}: el nombre de laReleaseque dirige el despliegue (p. ej.,prod-billing).{{ .context.instance_id }}: el ID concreto del Component en elAggregatedel desarrollador (p. ej.,receipt-storage).
Al concatenarlas (p. ej., {{ .metadata.release_name }}-{{ .context.instance_id }}), Ops garantiza que las configuraciones generadas por los plugins Wasm usen nombres de recurso únicos por entorno y por componente, sin que el desarrollador tenga que gestionar convenciones de nomenclatura físicas.