Pular para o conteúdo
AggregaAggrega
Selecionar língua: Português (Portugal)
Esta página foi traduzida automaticamente. Ler o original em inglês.

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:

Terminal window
aggrega scaffold --example postgres-three-realizations

Depois, imprime os próximos comandos a executar:

Terminal window
cd postgres-three-realizations
aggrega build --release release-selfhosted.yaml --auto-pull
aggrega build --release release-managed.yaml --auto-pull
aggrega build --release release-managed-dns.yaml --auto-pull
aggrega build --release release-external.yaml --auto-pull

values 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: appuser

e 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: 0

As 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 setting
spec:
extends: ./release-base.yaml
boundaries:
stack:
components:
db:
infra:
storage:
size: 500Gi

O 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.

manifest-prod.yaml
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.yaml
spec:
extends: ./manifest-prod.yaml
mappings:
features:
type:
core/referenced-secret:1.0.0: helm/k8s-secret-from-parameter:1.0.0

As 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.