Modelo de dados
Esta página explica uma única ideia, quem escreve quais dados sobre um componente, e não é um espaço de trabalho executável. Um contrato, três realizações mostra isso em um espaço de trabalho que você compila; escreva-o em uma pasta sua com:
aggrega scaffold --example postgres-three-realizationsEm seguida ele imprime os próximos comandos a executar:
cd postgres-three-realizationsaggrega build --release release-selfhosted.yaml --auto-pullaggrega build --release release-managed.yaml --auto-pullaggrega build --release release-managed-dns.yaml --auto-pullaggrega build --release release-external.yaml --auto-pullvalues e infra: dois namespaces, dois autores
Um Component declara dois conjuntos separados de configurações. Seus values são do desenvolvedor, escritos no Aggregate: o que a aplicação precisa, igual em todos os ambientes. Seus infra são do operador, escritos na Release: dimensionamento e posicionamento, que diferem de um ambiente para outro. Os esquemas mantêm os dois separados — o esquema do Aggregate não tem infra em um componente e o esquema da Release não tem values —, então nenhum autor pode definir os campos do outro. Uma Recipe recebe ambos, como dois objetos separados, .values e .infra.
No exemplo, o desenvolvedor nomeia o banco de dados e seu papel de login, de aggregate.yaml:
spec: components: db: type: core/datastore/postgres values: database: appdb user: appusere a Release que compila uma instância gerenciada a dimensiona, de release-managed.yaml sem os comentários:
spec: boundaries: stack: directory: stack components: db: infra: engine_version: "16" storage: size: 100Gi type: gp3 ha: enabled: true read_replicas: 0As outras duas Releases do exemplo compilam o mesmo Aggregate em um cluster e contra um servidor que já existe, cada uma com seus próprios infra; o Aggregate não muda.
Um valor que ainda assim deva variar por ambiente é elevado: o Aggregate declara um parâmetro, escreve-o no valor, e cada Release preenche o parâmetro (veja Os arquivos de um build).
Uma Release construída sobre outra
Uma Release pode nomear outra Release como sua base com extends: e mudar apenas o que difere. A filha herda as fronteiras, o posicionamento e os parâmetros da base, e declarar aggregate: ao lado de extends: é recusado pelo esquema da Release, porque a filha deve compilar o mesmo Aggregate que sua base. Ela pode nomear um Manifest próprio, ou omitir manifest: e herdar o da base.
# release-prod.yaml: the base gives every other settingspec: extends: ./release-base.yaml boundaries: stack: components: db: infra: storage: size: 500GiO directory: de uma fronteira é herdado como qualquer outra configuração, então uma filha que herda um diretório literal renderiza no mesmo lugar que a sua base. Escrever o diretório em função de um parâmetro é o que envia a saída de cada Release para um lugar próprio; veja Release composta e herança com extends.
Um Manifest construído sobre outro
Um Manifest pode estender outro da mesma forma, e suas entradas substituem a entrada da base para a mesma chave. Um Manifest de desenvolvimento pode manter todos os vínculos do de produção e mudar como as credenciais são realizadas: aqui um anexo core/referenced-secret é buscado em um repositório de segredos em produção e escrito em um Secret a partir do valor que um autor fornece em desenvolvimento.
spec: mappings: components: type: core/datastore/postgres:1.0.0: helm/postgres:1.0.0 features: type: core/referenced-secret:1.0.0: helm/k8s-external-secret:1.0.0---# manifest-dev.yamlspec: extends: ./manifest-prod.yaml mappings: features: type: core/referenced-secret:1.0.0: helm/k8s-secret-from-parameter:1.0.0As duas realizações publicam o nome do Secret da mesma forma, então um componente que lê a credencial renderiza a mesma referência seja qual for o Manifest; Uma intenção do desenvolvedor, duas formas de entrega de credenciais compila as duas e as compara.
Dois rótulos: o tipo e a categoria
Todo Component carrega um valor de um conjunto fechado no rótulo reservado component.aggrega.ai/type: server, um endpoint de longa duração; worker, um consumidor em segundo plano; stateful-server, algo que mantém seus próprios dados duráveis; task, que executa até a conclusão; function, uma função orientada a eventos; e resource, um recurso de nuvem gerenciado que não executa computação própria. O valor fica na entidade do catálogo, nunca na instância em um Aggregate.
O tipo diz como a infraestrutura deve tratar um componente, não para que serve o componente. Um broker de mensagens que mantém seu próprio disco é um stateful-server, exatamente como um banco de dados: core/messaging/kafka e core/datastore/postgres carregam o mesmo tipo. O que um leitor usa para navegar é o outro rótulo, component.aggrega.ai/category — messaging para o broker, datastore para o banco de dados —, que é também o diretório do catálogo onde a entidade fica. Um seletor escrito contra um rótulo nunca corresponde no outro.