Ciclos de vida Day-2
Ciclos de vida Day-2 e execução temporal
Um compilador antecipado (Ahead-of-Time, AOT) agnóstico em relação às capacidades cria inerentemente uma lacuna entre a intenção declarativa (Day-1) e a realidade operacional (Day-2). A nuvem não é perfeitamente determinística, o deploy exige sequenciamento temporal e os desenvolvedores precisam de gatilhos imperativos para tarefas de manutenção.
O Aggrega preenche estruturalmente essas lacunas por meio de polyfills arquiteturais específicos e de um roteamento nativo de GitOps, de modo que as configurações geradas atendam a essas necessidades operacionais sem comprometer a pureza do compilador central.
1. O modelo de execução DAG (sequenciamento temporal)
O problema: o deploy de infraestrutura é um grafo acíclico dirigido (DAG) do tempo. Uma task de migração de banco de dados precisa ser executada até o fim antes que o server web inicie. No entanto, os compiladores AOT geram pastas planas de YAML estático ou Terraform. Se você entregar essas pastas planas a um controlador GitOps (como o ArgoCD), ele aplica tudo simultaneamente, fazendo o servidor web entrar em um loop de falhas enquanto espera o banco de dados.
A solução: syncWave por fronteira na Release O Aggregate do desenvolvedor permanece intocado. Como o sequenciamento é uma realidade operacional física, ele é gerenciado estritamente no Domínio 4 (a Release). Cada fronteira da Release carrega um campo opcional syncWave: <integer>, que permite ao operador de plataforma escalonar explicitamente a ordem de rollout no nível da fronteira.
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 do valor da onda:
- A onda é um inteiro com sinal; o padrão é
0. Valores negativos são executados antes de todo o resto (CRDs, namespaces, RBAC); valores maiores são executados depois dos menores. Os operadores definem os valores conforme sua topologia de deploy. - Cada instância de componente contida diretamente em uma fronteira herda o valor da onda da fronteira em seu nó de IR. Não há substituição por componente na camada de autoria — a ordenação por recurso interna ao provider dentro de uma única fronteira é responsabilidade do provider.
- Fronteiras aninhadas não herdam implicitamente. Uma fronteira aninhada que não declara
syncWaveassume o padrão0, independentemente da declaração da fronteira externa. Operadores que querem “todo oouteré a onda 1, incluindo sua subfronteirainner” declaramsyncWave: 1em ambas.
O efeito do compilador: O compilador propaga o valor de wave de cada boundary para os manifestos renderizados nesse boundary. Os Providers emitem primitivas de sequenciamento nativas:
- Para Kubernetes (ArgoCD/Flux): o provider helm emite
argocd.argoproj.io/sync-wave: "<N>"como uma entrada demetadata.annotationsem cada manifesto renderizado, e um recurso que o chart marca como hook do Helm recebe tambémhelm.sh/hook-weight: "<N>"para a ordenação nativa de hooks do Helm. O provider helm-chart emite a anotação apenas nos arquivos de template que uma Recipe adiciona a um chart por meio deartifacts:; ele copia sem alterações os templates próprios do chart, então estes não carregam nenhuma wave. - Para Compose: o provider compose expressa a ordenação como
depends_onentre os serviços do arquivo no qual uma fronteira é renderizada, condicionada à saúde do destino quando o destino declara umhealthchecke à sua inicialização quando não declara.depends_onnomeia um serviço dentro de um único arquivo, então a ordenação entre dois arquivos compose não é expressável; os operadores sequenciam projetos compose separados na camada de invocação dedocker compose up. - Para CloudFormation: o provider cloudformation expressa a ordenação como
DependsOnentre os recursos do template de stack no qual um grupo de despacho é montado, com cada recurso nomeando os recursos da onda populada imediatamente anterior e o destino encadeando o restante. O atributo rege a ordem de exclusão, de forma inversa, além da ordem de criação; ele não expressa nenhuma condição de prontidão, porque um template não tem noção de um recurso estar operacional.DependsOnnomeia um recurso dentro de um único template, então a ordenação entre duas stacks não é expressável; os operadores sequenciam stacks separadas na camada de deploy. - Para Terraform: o provider terraform expressa a ordenação como
depends_onentre os blocosmoduleda configuração raiz na qual um boundary é montado, com cada módulo nomeando os módulos da wave povoada imediatamente anterior e o Terraform encadeando o restante. Ela ordena as ações que o Terraform executa e não expressa nenhuma condição de prontidão, porque uma configuração não tem noção de um recurso estar apto a atender.depends_onnomeia um módulo dentro de uma configuração, então a ordenação entre duas configurações raiz não é expressável; sequenciá-las é responsabilidade do operador.
A chave interna do Aggrega aggrega.ai/sync-wave: "<N>" é entregue junto com a anotação do ArgoCD para fins de observabilidade e procedência — como anotação na saída do helm e nos arquivos de template que uma Recipe adiciona a um chart do helm-chart, como label de serviço no compose, como uma linha do comentário de proveniência em cada módulo do terraform e sob o Metadata."aggrega.ai/provenance" de cada recurso do cloudformation —, enquanto a anotação do ArgoCD é o que os controladores GitOps consomem.
Unidade de autoria de ondas vs. unidade implantável
A fronteira é a unidade de autoria de ondas. A unidade implantável é o caminho de montagem — a saída em disco produzida pelo compilador sobre a qual um pipeline de CI/CD faz a orquestração. Por padrão, uma fronteira corresponde a um caminho de montagem: os componentes de cada fronteira são emitidos em boundaries/<boundary-name>/<provider>/, e helm install / docker compose up é executado nesse caminho.
Os operadores podem colapsar esse mapeamento 1:1. As fronteiras podem declarar campos de template de caminho directory: (e subDirectory:) que, quando compartilhados entre fronteiras, encaminham os componentes dessas fronteiras para uma única saída montada no caminho compartilhado. Duas fronteiras que declaram directory: "deploy/cluster" produzem uma única saída montada com componentes de ambas — a unidade implantável passa a ser o caminho de montagem, não a identidade da fronteira.
Manifestos com ondas mistas dentro de uma única saída montada são normais e suportados. Quando a fronteira A declara syncWave: 1 e a fronteira B declara syncWave: 2, e ambas compartilham directory: "deploy/cluster", a unidade implantável resultante contém os componentes das duas fronteiras; cada manifesto carrega a anotação de onda de sua fronteira de origem. As ferramentas de runtime leem as anotações por recurso e ordenam dentro da unidade de deploy montada — o contexto de sincronização por Application do ArgoCD processa os manifestos da onda 1, espera que estejam Healthy e então processa a onda 2; a ordenação de hooks do Helm lê helm.sh/hook-weight por recurso de hook. Esse é o padrão do ArgoCD: a emissão por recurso é exatamente a entrada que os consumidores das outras ferramentas esperam.
O sequenciamento entre Applications (quando um operador executa várias Applications do ArgoCD sobre saídas montadas separadas) é configuração de CI no nível do operador — o Aggrega produz os artefatos; o operador conecta suas Applications do ArgoCD em torno deles via app-of-apps ou Progressive Sync. O padrão de anotação por recurso do Aggrega é o formato de entrada padrão que todo consumidor das outras ferramentas espera.
2. O polyfill de endereçamento dinâmico
O problema: a nuvem não é determinística no momento da criação. Recursos como instâncias do AWS RDS ou buckets do S3 geram hashes de URL aleatórios somente depois de serem provisionados fisicamente. Como o compilador AOT gera a configuração antes de a nuvem provisionar qualquer coisa, é fisicamente impossível para o compilador injetar a URL literal do banco de dados na variável de ambiente de um contêiner.
A solução: ponteiros determinísticos via Features de credencial O Aggrega resolve isso aproveitando as Features de credencial existentes, deslocando a definição de “determinístico” de um endereço IP literal para um ponteiro determinístico. A configuração gerada não passa a URL; ela passa o caminho para um Cloud Vault onde a URL vai existir.
- Exemplo 1: a geração da saída (Terraform RDS) A Recipe de Ops do banco de dados cria a instância do AWS RDS. O ponto crucial é que a Recipe é escrita para enviar nativamente essa URL dinâmica recém-gerada ao AWS Systems Manager (SSM) Parameter Store, em um caminho com nome determinístico (por exemplo,
/aggrega/prod/db-url). - Exemplo 2: a injeção de entrada (aplicação Kubernetes) O desenvolvedor anexa a Feature de credencial
core/referenced-secretao worker, em um slot que seu Component declara, comorigindefinido como a string do ponteiro determinístico ("/aggrega/prod/db-url"). Em um destino Kubernetes, o Manifest vincula esse anexo ahelm/k8s-external-secret, que renderiza umExternalSecretdo Kubernetes pedindo ao operador de secret store do cluster que busque essa entrada em um Secret, e publica o nome do Secret e sua chave de dados; a Recipe do worker os lê por meio dosattachments:do seu contêiner e renderiza uma variável de ambiente do Pod mapeada paravalueFrom: secretKeyRef(consulte Como uma credencial chega a um contêiner). O compilador encaminha a string do ponteiro e nunca lê a URL.
Em runtime, o Terraform provisiona o banco de dados e salva a URL no vault. O contêiner inicia, lê o Secret reconciliado a partir do vault e se conecta. O compilador AOT gerou os relacionamentos por meio de strings de ponteiro estáveis, sem nunca precisar do endereço IP literal.
3. Ações imperativas (a entrega executável)
O problema: o estado declarativo é perfeito para o provisionamento Day-1, mas os desenvolvedores precisam executar ações imperativas: “Faça um backup do banco agora.” Um pipeline GitOps estritamente declarativo não tem nenhum mecanismo nativo para disparar novamente um script estático.
A solução: tarefas dormentes e o comando próprio do destino O Aggrega resolve isso preservando a pureza AOT estrita. Ele gera a configuração de uma tarefa que é implantada sem iniciar, e cada execução é iniciada no destino com o comando próprio do destino.
- A intenção do desenvolvedor: o desenvolvedor declara o script como uma
tasknoAggregatee anexa uma Feature pedindo que ele seja executado sob demanda (por exemplo,core/manual-trigger). Ser executada sob demanda faz parte do que a tarefa é, então quem a anexa é o desenvolvedor; uma Feature cujas entradas são todas operacionais é anexada, em vez disso, pela equipe de operações, na Release. - A forma dormente: a Recipe própria da tarefa em cada destino lê o anexo e renderiza a tarefa em uma forma que é implantada sem iniciar uma execução. No Kubernetes a tarefa é um
CronJobmantido comsuspend: true, em um agendamento que indica uma data que nunca chega, no lugar doJobque seria executado assim que fosse implantado. No Docker Compose o serviço da tarefa, que o Compose não reinicia depois que termina, carrega o perfilmanual, de modo quedocker compose upo deixa parado. No Amazon ECS, via Terraform ou CloudFormation, a definição de tarefa é implantada sozinha, sem agendamento que a inicie. A FeatureRecipe que o Manifest vincula para o anexo não adiciona nenhum arquivo próprio em nenhum destino: a mudança está na saída própria da tarefa. - A entrega: o compilador não alcança nenhum cluster e não chama nenhuma API de nuvem, e o build não inicia nenhuma execução nem escreve nenhum script. Cada execução é iniciada pelo operador, com o comando próprio do destino:
kubectl create job <run-name> --from=cronjob/<cronjob>no Kubernetes,docker compose run --rm <service>no Docker Compose eaws ecs run-taskno Amazon ECS, ao qual se passam o cluster, a definição de tarefa e a configuração de rede que a Release define eminfra.overridesda tarefa. A geração de configuração e a execução em runtime permanecem separadas.
(Observação: no Kubernetes e no Amazon ECS, uma tarefa que tem um agendamento é executada conforme ele, esteja o anexo presente ou não, e o mesmo comando inicia uma execução extra entre as agendadas; no Docker Compose, que não tem agendador, a Recipe da tarefa recusa um agendamento. O exemplo completo task-run-on-demand compila um Aggregate para Kubernetes, Docker Compose, Terraform e CloudFormation e mostra em cada um a saída renderizada e o comando que inicia uma execução.)
4. Pré-análise: o hook do workspace (RBAC e cotas da plataforma)
O problema: algumas mudanças provisionam infraestrutura cara ou crítica para a produção — um grande cluster de GPU, por exemplo — e não devem entrar no pipeline GitOps sem revisão. Quais colaboradores podem promover quais mudanças para quais ambientes é uma decisão de política organizacional; o compilador não deve codificá-la de forma fixa.
A solução: um compilador AOT puro não pode consultar o Active Directory nem buscar credenciais de nuvem para descobrir quem está executando o build. Para impedir a geração não autorizada antes mesmo de a CI/CD ser executada, a arquitetura se baseia em uma injeção explícita de contexto.
Quando aggrega build é invocado por um runner de CI/CD, o pipeline grava o contexto de execução em um arquivo de configuração que passa com --config, como as with.settings da vinculação de governança que o julga (por exemplo, approval: standard). O arquivo lista suas vinculações em governance_append, de modo que elas se somam aos plugins de governança que a própria configuração do workspace vincula em vez de serem substituídas por eles. Uma política no papel ir-verdict lê essas configurações como input.settings. Ela recebe o grafo montado e não a Release, então o ambiente da Release chega até ela como um rótulo: uma política no papel label-transform lê input.compilation_context.environment e rotula cada nó com ele. O veredito compara os dois e interrompe o build quando discordam — aqui, um build de produção cujas configurações não trazem 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."}Uma execução cujas configurações não trazem nenhuma aprovação também é recusada, porque a regra pergunta se a aprovação está presente, e não se uma diferente está. Isso isola o RBAC da lógica nativa do compilador, garantindo que o compilador atue puramente como um avaliador determinístico dos dados fornecidos.
5. FinOps shift-left (estimativa de custos por meio de políticas)
O problema: configurações incorretas acidentais (por exemplo, solicitar workers: 500) podem contornar salvaguardas financeiras e provocar grandes estouros de custos na nuvem.
A solução (políticas Wasm corporativas): como o grafo de IR contém a topologia completa e a Release contém o mapeamento físico (.infra), as empresas podem avaliar o custo exato do que uma Release implanta antes da geração, sem precisar de um recurso do compilador codificado de forma fixa. As empresas simplesmente escrevem um plugin WebAssembly de FinOps personalizado e o anexam ao socket de governança em um papel de veredito. Esse plugin personalizado pode ler os payloads .infra, calcular o custo mensal estimado e interromper o build se o custo calculado exceder os limites de orçamento definidos internamente pela empresa.
6. O ciclo de vida de importação “brownfield”
O problema: as empresas já têm a maior parte de sua infraestrutura em execução. Embora o Aggrega seja projetado para conectar um build a infraestrutura não gerenciada por meio de um workload de referência (rede pass-through; consulte workloads de referência), levar um banco de dados Oracle existente para o estado do Terraform gerado pelo Aggrega normalmente faz os orquestradores tentarem recriar o banco de dados, destruindo os dados existentes.
A solução (planejada): Está planejada uma Feature core/resource-adoption para gerenciar o ciclo de vida de importação.
Quando um desenvolvedor modela o banco de dados existente em seu Aggregate e anexa o recurso resource-adoption em um pipeline executado sequencialmente, o plugin de renderização Wasm é projetado para avaliar o payload base de Ops da Recipe. Em vez de emitir as configurações de criação padrão, o plugin é projetado para emitir a sintaxe de adoção explícita da plataforma de destino (por exemplo, retornando um JSONPatch com blocos import {} do Terraform ou políticas de gerenciamento ObserveOnly do Crossplane). Isso permite que as empresas gerem com segurança configurações que absorvem a arquitetura legada no plano de controle GitOps sem tempo de inatividade.
7. Boas práticas de Ops e nomenclatura determinística
Enquanto o compilador central se baseia em IDs de nó internos e estáveis (por exemplo, support-db) no grafo de IR plano, os provedores de nuvem físicos (como AWS, Azure e GCP) costumam exigir strings globalmente únicas para a infraestrutura física (por exemplo, nomes de buckets do S3, nomes de funções do IAM ou domínios do API Gateway).
Se um engenheiro de Platform Ops codificar de forma fixa um nome físico em seu template base (por exemplo, bucket_name: "enterprise-data-bucket"), os artefatos gerados serão aplicados sem problemas na primeira vez. No entanto, se um desenvolvedor implantar um segundo ambiente (por exemplo, staging vs. prod), o provedor de nuvem rejeitará os recursos do segundo ambiente em runtime por causa de uma colisão de nomes.
A regra da saída determinística (segurança do GitOps): como os controladores GitOps (ArgoCD, Flux) fazem detecção de diferenças em nível de byte nos artefatos renderizados, o compilador garante que entradas idênticas produzam saídas idênticas byte a byte. Os mapas que fluem pelo contexto do template (.context.inject.env, .values, .infra e o restante da visão de runtime) são sustentados por estruturas de mapa ordenado que preservam a ordem de inserção do autor em toda a camada de dados, e a fronteira do template é a única exceção: {{ range }} sobre esses mapas itera em ordem alfabética de chaves, como fazem os templates de Go, não na ordem do autor. Os engenheiros de Ops podem contar com essa ordem de iteração ser determinística entre execuções da mesma entrada; onde a sequência tem significado, ela é escrita como uma lista em vez de ser recuperada de um mapa. A função keys do Sprig, porém, retorna a ordem de iteração dos mapas de Go (que não é determinística por design da linguagem); templates que compõem uma sequência determinística de chaves a partir da saída de keys devem passá-la por sortAlpha (por exemplo, {{ keys .values | sortAlpha }}) para recuperar o determinismo.
A regra de ouro das Recipes de Ops (o padrão do Helm): os engenheiros de Platform Ops nunca devem codificar de forma fixa nomes físicos de recursos de nuvem. Em vez disso, devem construir nomes únicos de forma determinística concatenando o contexto de deploy do Aggrega durante a fase de avaliação do template. Esta é uma regra de reutilização e de segurança contra colisões, não uma regra de determinismo — nomes codificados de forma fixa produzem saída estável, mas colidem fatalmente quando a mesma Recipe renderiza várias instâncias de componente ou quando o mesmo Aggregate é implantado em várias Releases.
O compilador fornece exatamente duas variáveis para garantir a unicidade global:
{{ .metadata.release_name }}: o nome daReleaseque conduz o deploy (por exemplo,prod-billing).{{ .context.instance_id }}: o ID específico do Component noAggregatedo desenvolvedor (por exemplo,receipt-storage).
Ao concatená-las (por exemplo, {{ .metadata.release_name }}-{{ .context.instance_id }}), a equipe de Ops garante que as configurações geradas pelos plugins Wasm usem nomes de recurso únicos por ambiente e por componente, sem exigir que o desenvolvedor gerencie convenções de nomenclatura físicas.