Ciclos de vida do Dia 2
Ciclos de vida do Dia 2 e execução temporal
Um compilador Ahead-of-Time (AOT) agnóstico em relação às capacidades cria inerentemente uma lacuna entre a intenção declarativa (Dia 1) e a realidade operacional (Dia 2). A cloud não é perfeitamente determinística, a implementação exige sequenciação temporal e os programadores precisam de acionadores imperativos para tarefas de manutenção.
O Aggrega colmata estruturalmente estas lacunas através de polyfills arquiteturais específicos e de um encaminhamento nativo de GitOps, para que as configurações geradas satisfaçam estas necessidades operacionais sem comprometer a pureza do compilador central.
1. O modelo de execução DAG (sequenciação temporal)
O problema: a implementação de infraestrutura é um grafo acíclico dirigido (DAG) de tempo. Uma task de migração da base de dados tem de correr até ao fim antes de o server web arrancar. No entanto, os compiladores AOT geram pastas planas de YAML estático ou de Terraform. Se estas pastas planas forem entregues a um controlador GitOps (como o ArgoCD), este aplica tudo em simultâneo, fazendo com que o servidor web entre num ciclo de falhas enquanto espera pela base de dados.
A solução: syncWave por fronteira na Release O Aggregate do programador fica intacto. Como a sequenciação é uma realidade operacional física, é gerida estritamente no Domínio 4 (a Release). Cada fronteira na Release transporta um campo opcional syncWave: <integer>, que permite ao Platform Operator definir explicitamente a ordem de rollout ao 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 dos valores de onda:
- A onda é um inteiro com sinal; a predefinição é
0. Os valores negativos correm antes de tudo o resto (CRDs, namespaces, RBAC); os valores maiores correm depois dos valores menores. Os operadores definem os valores de acordo com a sua topologia de implementação. - Cada instância de componente contida diretamente numa fronteira herda o valor de onda da fronteira no seu nó da IR. Não existe substituição por componente na camada de autoria — a ordenação interna por recurso dentro de uma única fronteira é uma questão do provider.
- As fronteiras aninhadas não herdam implicitamente. Uma fronteira aninhada que não declare
syncWaveassume por predefinição0, independentemente da declaração da fronteira exterior. Os operadores que queiram «todo oouterna onda 1, incluindo a sua subfronteirainner» declaramsyncWave: 1em ambas.
O efeito do compilador: O compilador propaga o valor de onda de cada fronteira aos manifestos renderizados nessa fronteira. Os Providers emitem primitivas nativas de sequenciação:
- Para o Kubernetes (ArgoCD/Flux): o provider helm emite
argocd.argoproj.io/sync-wave: "<N>"como uma entradametadata.annotationsem todos os manifestos renderizados, e um recurso que o chart marque como hook do Helm recebe adicionalmentehelm.sh/hook-weight: "<N>"para a ordenação nativa de hooks do Helm. O provider helm-chart emite a anotação apenas nos ficheiros de template que uma Recipe acrescenta a um chart através deartifacts:; copia sem alterações os templates próprios do chart, pelo que estes não transportam nenhuma onda. - Para o Compose: o provider compose exprime a ordenação como
depends_onentre os serviços do ficheiro em que uma fronteira é renderizada, condicionado à saúde do destino quando este declara umhealthchecke ao seu arranque quando não declara.depends_onnomeia um serviço dentro de um ficheiro, pelo que a ordenação entre dois ficheiros compose não é exprimível; os operadores sequenciam projetos compose separados na camada de invocação dedocker compose up. - Para o CloudFormation: o provider cloudformation exprime a ordenação como
DependsOnentre os recursos do template de stack em que um grupo de despacho é montado, nomeando cada recurso os recursos da onda povoada imediatamente anterior e encadeando o destino as restantes. O atributo rege a ordem de eliminação em sentido inverso, além da ordem de criação; não exprime nenhuma condição de prontidão, porque um template não tem a noção de um recurso estar operacional.DependsOnnomeia um recurso dentro de um template, pelo que a ordenação entre duas stacks não é exprimível; os operadores sequenciam stacks separadas na camada de implementação. - Para o Terraform: o provider terraform exprime a ordenação como
depends_onentre os blocosmoduleda configuração raiz em que uma fronteira é montada, com cada módulo a nomear os módulos da onda povoada imediatamente anterior e o Terraform a encadear o resto. Ordena as ações que o Terraform executa e não exprime nenhuma condição de prontidão, porque uma configuração não tem noção de um recurso estar apto a servir.depends_onnomeia um módulo dentro de uma configuração, pelo que a ordenação entre duas configurações raiz não é exprimível; sequenciá-las cabe ao operador.
A chave interna do Aggrega aggrega.ai/sync-wave: "<N>" é emitida ao lado da anotação do ArgoCD para fins de observabilidade e proveniência — como anotação na saída helm e nos ficheiros de template que uma Recipe acrescenta a um chart helm-chart, como etiqueta de serviço no compose, como uma linha do comentário de proveniência em cada módulo terraform e sob o Metadata."aggrega.ai/provenance" de cada recurso cloudformation —, enquanto a anotação do ArgoCD é o que os controladores GitOps consomem.
Unidade de autoria de ondas vs unidade implementável
A fronteira é a unidade de autoria de ondas. A unidade implementável é o caminho de montagem — a saída em disco produzida pelo compilador sobre a qual um pipeline de CI/CD orquestra. Por predefiniçã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 corre sobre esse caminho.
Os operadores podem fundir esta correspondência 1:1. As fronteiras podem declarar campos de template de caminho directory: (e subDirectory:) que, quando partilhados entre fronteiras, encaminham os componentes dessas fronteiras para uma única saída montada no caminho partilhado. Duas fronteiras que declarem directory: "deploy/cluster" produzem uma saída montada que contém componentes de ambas — o implementável passa a ser o caminho de montagem, não a identidade da fronteira.
Manifestos com ondas mistas dentro de uma saída montada são normais e suportados. Quando a fronteira A declara syncWave: 1 e a fronteira B declara syncWave: 2, e ambas partilham directory: "deploy/cluster", o implementável resultante contém os componentes de ambas as fronteiras; cada manifesto transporta a anotação de onda da sua fronteira de autoria. As ferramentas de tempo de execução leem as anotações por recurso e ordenam dentro da unidade de implementação montada — o contexto de sincronização por Application do ArgoCD processa os manifestos da onda 1, espera que fiquem Healthy e depois processa a onda 2; a ordenação de hooks do Helm lê helm.sh/hook-weight por recurso de hook. Este é o padrão normal do ArgoCD: a emissão por recurso é exatamente o input que os consumidores entre ferramentas esperam.
A sequenciação entre Applications (quando um operador executa várias Applications do ArgoCD sobre saídas montadas separadas) é configuração de CI ao nível do operador — o Aggrega produz os artefactos; o operador liga as suas Applications do ArgoCD em torno deles através de app-of-apps ou do Progressive Sync. O padrão de anotações por recurso do Aggrega é a forma de input normal que todos os consumidores entre ferramentas esperam.
2. O polyfill de endereçamento dinâmico
O problema: a cloud não é determinística no momento da criação. Recursos como instâncias AWS RDS ou buckets S3 geram hashes de URL aleatórios só depois de serem fisicamente aprovisionados. Como o compilador AOT gera a configuração antes de a cloud aprovisionar o que quer que seja, é fisicamente impossível ao compilador injetar o URL literal da base de dados na variável de ambiente de um contentor.
A solução: ponteiros determinísticos através das Features de credenciais O Aggrega resolve isto tirando partido das Features de credenciais 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 o URL; passa o caminho para um cofre da cloud onde o URL irá existir.
- Exemplo 1: a geração do output (Terraform RDS) A Recipe de Ops da base de dados cria a instância AWS RDS. Crucialmente, a Recipe é escrita para enviar nativamente esse URL dinâmico recém-gerado para o AWS Systems Manager (SSM) Parameter Store, num caminho com nome determinístico (por exemplo,
/aggrega/prod/db-url). - Exemplo 2: a injeção de entrada (aplicação Kubernetes) O programador anexa a Feature de credencial
core/referenced-secretao worker, num slot que o seu Component declara, comorigindefinido como a cadeia do ponteiro determinístico ("/aggrega/prod/db-url"). Num destino Kubernetes, o Manifest associa esse anexo ahelm/k8s-external-secret, que renderiza umExternalSecretdo Kubernetes a pedir ao operador do secret store do cluster que obtenha essa entrada para um Secret, e publica o nome do Secret e a sua chave de dados; a Recipe do worker lê-os através dosattachments:do seu contentor e renderiza uma variável de ambiente do Pod mapeada paravalueFrom: secretKeyRef(ver Como uma credencial chega a um contentor). O compilador encaminha a cadeia do ponteiro e nunca lê o URL.
Em tempo de execução, o Terraform aprovisiona a base de dados e guarda o URL no cofre. O contentor arranca, lê o Secret reconciliado a partir do cofre e liga-se. O compilador AOT gerou as relações através de cadeias de ponteiros estáveis sem nunca precisar do endereço IP literal.
3. Ações imperativas (a passagem executável)
O problema: o estado declarativo é perfeito para o aprovisionamento do Dia 1, mas os programadores precisam de executar ações imperativas: «Fazer já uma cópia de segurança da base de dados.» Um pipeline GitOps estritamente declarativo não tem nenhum mecanismo nativo para voltar a acionar um script estático.
A solução: tarefas dormentes e o comando próprio do destino O Aggrega resolve isto preservando a pureza AOT estrita. Gera a configuração de uma tarefa que é implementada sem arrancar, e cada execução é iniciada no destino com o comando próprio do destino.
- A intenção do programador: o programador declara o script como uma
tasknoAggregatee anexa uma Feature que pede que seja executado a pedido (por exemplo,core/manual-trigger). Ser executado a pedido faz parte daquilo que a tarefa é, pelo que é o programador que a anexa; uma Feature cujos inputs sejam todos operacionais é, em vez disso, anexada pelas operações, na Release. - A forma dormente: a Recipe própria da tarefa em cada destino lê o anexo e renderiza a tarefa numa forma que é implementada sem iniciar uma execução. No Kubernetes, a tarefa é um
CronJobretido comsuspend: true, num agendamento que indica uma data que nunca chega, em vez doJobque seria executado assim que fosse implementado. No Docker Compose, o serviço da tarefa, que o Compose não reinicia depois de terminar, transporta o perfilmanual, pelo quedocker compose upo deixa parado. No Amazon ECS, através de Terraform ou CloudFormation, a definição de tarefa é implementada sozinha, sem agendamento que a inicie. A FeatureRecipe que o Manifest associa para o anexo não acrescenta nenhum ficheiro próprio em nenhum destino: a alteração está na saída própria da tarefa. - A passagem de testemunho: o compilador não chega a nenhum cluster nem chama nenhuma API de cloud, e a compilação 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 indicam o cluster, a definição de tarefa e a configuração de rede que a Release define eminfra.overridesda tarefa. A geração da configuração e a execução em tempo de execução permanecem separadas.
(Nota: no Kubernetes e no Amazon ECS, uma tarefa que tenha um agendamento é executada segundo ele, quer o anexo esteja presente quer não, e o mesmo comando inicia uma execução adicional 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 espaço de trabalho (RBAC e quotas da plataforma)
O problema: algumas alterações aprovisionam 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. Que contribuidores podem promover que alterações para que ambientes é uma decisão de política organizacional; o compilador não a deve codificar.
A solução: um compilador AOT puro não pode contactar o Active Directory nem obter credenciais da cloud para descobrir quem está a executar a compilação. Para impedir uma geração não autorizada antes de a CI/CD sequer correr, a arquitetura depende da injeção explícita de contexto.
Quando aggrega build é invocado por um runner de CI/CD, o pipeline escreve o contexto de execução num ficheiro de configuração que passa com --config, como as with.settings do anexo de governação que o julga (por exemplo, approval: standard). O ficheiro lista os seus anexos em governance_append, para que se somem aos plugins de governação que a própria configuração do workspace anexa em vez de serem substituídos por eles. Uma política no papel ir-verdict lê essas definições como input.settings. Recebe o grafo montado e não a Release, pelo que o ambiente da Release lhe chega como etiqueta: uma política no papel label-transform lê input.compilation_context.environment e etiqueta cada nó com ele. O veredicto compara os dois e interrompe a compilação quando divergem — aqui, uma compilação de produção cujas definições não transportam 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 definições não transportem nenhuma aprovação também é recusada, porque a regra pergunta se a aprovação está presente e não se está presente uma diferente. Isto isola o RBAC da lógica nativa do compilador, garantindo que o compilador atua puramente como um avaliador determinístico dos dados fornecidos.
5. FinOps shift-left (estimativa de custos através de políticas)
O problema: configurações erradas acidentais (por exemplo, pedir workers: 500) podem contornar as salvaguardas financeiras e provocar grandes derrapagens nos custos da cloud.
A solução (políticas Wasm empresariais): como o grafo 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 implementa antes da geração, sem precisarem de uma funcionalidade codificada no compilador. As empresas limitam-se a escrever um plugin WebAssembly de FinOps personalizado e a anexá-lo ao socket de governação num papel de veredicto. Este plugin personalizado pode ler os payloads .infra, calcular o custo mensal estimado e interromper a compilação se o custo calculado exceder os limites orçamentais definidos internamente pela empresa.
6. O ciclo de vida de importação «brownfield»
O problema: as empresas já têm a maior parte da sua infraestrutura em funcionamento. Embora o Aggrega esteja concebido para ligar uma compilação a infraestrutura não gerida através de um workload de referência (rede de passagem direta; ver workloads de referência), mover uma base de dados Oracle existente para o estado Terraform gerado pelo Aggrega faz tipicamente com que os orquestradores tentem recriar a base de dados, destruindo os dados existentes.
A solução (planeada): Está planeada uma Feature core/resource-adoption para gerir o ciclo de vida de importação.
Quando um programador modela a base de dados existente no seu Aggregate e anexa a feature resource-adoption num pipeline executado sequencialmente, o plugin de renderização Wasm está concebido para avaliar o payload base da Recipe de Ops. Em vez de emitir configurações de criação normais, o plugin está concebido para produzir a sintaxe de adoção explícita da plataforma de destino (por exemplo, devolvendo um JSONPatch com blocos import {} do Terraform ou políticas de gestão ObserveOnly do Crossplane). Isto permite às empresas gerar em segurança configurações que absorvem a arquitetura legada no plano de controlo GitOps sem tempo de inatividade.
7. Boas práticas de Ops e nomenclatura determinística
Embora o compilador central dependa de IDs de nós internos e estáveis (por exemplo, support-db) no grafo IR plano, os fornecedores de cloud físicos (como a AWS, o Azure e a GCP) exigem frequentemente cadeias globalmente únicas para a infraestrutura física (por exemplo, nomes de buckets S3, nomes de funções IAM ou domínios do API Gateway).
Se um engenheiro de Platform Ops codificar um nome físico no seu template base (por exemplo, bucket_name: "enterprise-data-bucket"), os artefactos gerados serão aplicados sem problemas da primeira vez. No entanto, se um programador implementar um segundo ambiente (por exemplo, staging vs prod), o fornecedor de cloud rejeitará os recursos do segundo ambiente em tempo de execução devido a uma colisão de nomes.
A regra da saída determinística (segurança GitOps): como os controladores GitOps (ArgoCD, Flux) fazem deteção de diferenças ao nível do byte nos artefactos renderizados, o compilador garante que inputs idênticos produzem outputs idênticos byte a byte. Os mapas que fluem pelo contexto de templates (.context.inject.env, .values, .infra e o resto da vista de tempo de execução) assentam em estruturas de mapas ordenados que preservam a ordem de inserção do autor em toda a camada de dados, e a fronteira dos templates é a única exceção: {{ range }} sobre esses mapas itera por ordem alfabética das chaves, como fazem os templates do Go, não pela ordem do autor. Os engenheiros de Ops podem contar com essa ordem de iteração ser determinística entre execuções do mesmo input; quando a sequência tem significado, é escrita como uma lista em vez de ser recuperada de um mapa. A função keys do Sprig, no entanto, devolve a ordem de iteração de mapas do Go (que é não determinística por design da linguagem); os templates que compõem uma sequência de chaves determinística a partir do output de keys têm de o encaminhar por sortAlpha (por exemplo, {{ keys .values | sortAlpha }}) para recuperar o determinismo.
A regra de ouro para as Recipes de Ops (o padrão Helm): os engenheiros de Platform Ops nunca devem codificar nomes de recursos físicos da cloud. Em vez disso, devem construir nomes únicos de forma determinística, concatenando o contexto de implementação do Aggrega durante a fase de avaliação de templates. Isto é uma regra de reutilização e de segurança contra colisões, não uma regra de determinismo — os nomes codificados produzem uma saída estável, mas colidem fatalmente quando a mesma Recipe renderiza várias instâncias de componentes ou quando o mesmo Aggregate é implementado em várias Releases.
O compilador fornece exatamente duas variáveis para garantir a unicidade global:
{{ .metadata.release_name }}: o nome daReleaseque conduz a implementação (por exemplo,prod-billing).{{ .context.instance_id }}: o ID específico do Component noAggregatedo programador (por exemplo,receipt-storage).
Ao concatená-las (por exemplo, {{ .metadata.release_name }}-{{ .context.instance_id }}), Ops garante que as configurações geradas pelos plugins Wasm utilizam nomes de recursos únicos por ambiente e por componente, sem exigir que o programador faça a gestão das convenções de nomenclatura física.