Modelo de dados
Esta página explica uma única ideia, quem escreve que dados sobre um componente, e não é um espaço de trabalho executável. Um contrato, três realizações mostra-a num espaço de trabalho que se compila; pode escrevê-lo numa pasta própria com:
aggrega scaffold --example postgres-three-realizationsDepois, 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 espaços de nomes, dois autores
Um Component declara dois conjuntos separados de definições. Os seus values são do programador, escritos no Aggregate: o que a aplicação precisa, igual em todos os ambientes. Os seus infra são do operador, escritos na Release: dimensionamento e colocação, que diferem de um ambiente para o seguinte. Os esquemas mantêm os dois separados — o esquema do Aggregate não tem infra num componente e o esquema da Release não tem values —, pelo que nenhum dos autores pode definir os campos do outro. Uma Recipe recebe ambos, como dois objetos separados, .values e .infra.
No exemplo, o programador nomeia a base de dados e a sua função de início de sessão, de aggregate.yaml:
spec: components: db: type: core/datastore/postgres values: database: appdb user: appusere a Release que compila uma instância gerida dimensiona-a, 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 num cluster e contra um servidor que já existe, cada uma com os seus próprios infra; o Aggregate não muda.
Um valor que ainda assim deva variar consoante o ambiente é elevado: o Aggregate declara um parâmetro, escreve-o no valor, e cada Release preenche o parâmetro (ver Os ficheiros de uma compilação).
Uma Release construída sobre outra
Uma Release pode nomear outra Release como sua base com extends: e alterar apenas o que difere. A filha herda as fronteiras, a colocação e os parâmetros da base, e declarar aggregate: ao lado de extends: é recusado pelo esquema da Release, porque a filha tem de compilar o mesmo Aggregate que a sua base. 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 definição, pelo que uma filha que herde um diretório literal renderiza no mesmo sítio 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 sítio próprio; ver Release composta e herança com extends.
Um Manifest construído sobre outro
Um Manifest pode estender outro da mesma forma, e as suas entradas substituem a entrada da base para a mesma chave. Um Manifest de desenvolvimento pode manter todas as associações do de produção e alterar a forma como as credenciais são realizadas: aqui, um anexo core/referenced-secret é obtido de um repositório de segredos em produção e escrito num 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, pelo que um componente que leia a credencial renderiza a mesma referência seja qual for o Manifest; Uma intenção do programador, duas formas de entrega de credenciais compila ambas e compara-as.
Dois rótulos: o tipo e a categoria
Cada Component tem 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 guarda os seus próprios dados duráveis; task, que é executado até à conclusão; function, uma função orientada por eventos; e resource, um recurso de nuvem gerido que não executa computação própria. O valor fica na entidade do catálogo, nunca na instância num Aggregate.
O tipo diz como a infraestrutura deve tratar um componente, não para que serve o componente. Um broker de mensagens que detém o seu próprio disco é um stateful-server, exatamente como uma base de dados: core/messaging/kafka e core/datastore/postgres têm o mesmo tipo. Aquilo pelo que um leitor navega é o outro rótulo, component.aggrega.ai/category — messaging para o broker, datastore para a base de dados —, que é também o diretório do catálogo onde a entidade se encontra. Um seletor escrito para um rótulo nunca corresponde no outro.