Ir al contenido
AggregaAggrega
Seleccionar idioma: Español
Esta página se tradujo automáticamente. Lee el original en inglés.

Modelo de datos

Esta página explica una sola idea, quién escribe qué datos sobre un componente, y no es un espacio de trabajo ejecutable. Un contrato, tres realizaciones la muestra en un espacio de trabajo que compilas; escríbelo en una carpeta propia con:

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

Después imprime los comandos que hay que ejecutar a continuación:

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: dos espacios de nombres, dos autores

Un Component declara dos conjuntos de ajustes separados. Sus values son del desarrollador y se escriben en el Aggregate: lo que necesita la aplicación, igual en todos los entornos. Sus infra son del operador y se escriben en la Release: dimensionamiento y ubicación, que difieren de un entorno a otro. Los esquemas mantienen ambos separados — el esquema del Aggregate no tiene infra en un componente y el esquema de la Release no tiene values —, así que ningún autor puede establecer los campos del otro. Una Recipe recibe ambos, como dos objetos separados, .values y .infra.

En el ejemplo, el desarrollador nombra la base de datos y su rol de inicio de sesión, de aggregate.yaml:

spec:
components:
db:
type: core/datastore/postgres
values:
database: appdb
user: appuser

y la Release que compila una instancia gestionada la dimensiona, de release-managed.yaml sin sus comentarios:

spec:
boundaries:
stack:
directory: stack
components:
db:
infra:
engine_version: "16"
storage:
size: 100Gi
type: gp3
ha:
enabled: true
read_replicas: 0

Las otras dos Releases del ejemplo compilan el mismo Aggregate en un clúster y contra un servidor que ya existe, cada una con sus propios infra; el Aggregate no cambia.

Un valor que aun así deba variar según el entorno se eleva: el Aggregate declara un parámetro, lo escribe en el valor y cada Release satisface el parámetro (consulta Los archivos de una compilación).

Una Release construida sobre otra

Una Release puede nombrar otra Release como su base con extends: y cambiar solo lo que difiere. La hija hereda los límites, la ubicación y los parámetros de la base, y el esquema de la Release rechaza que se declare aggregate: junto a extends:, porque la hija debe compilar el mismo Aggregate que su base. Puede nombrar un Manifest propio, u omitir manifest: y heredar el de la base.

# release-prod.yaml: the base gives every other setting
spec:
extends: ./release-base.yaml
boundaries:
stack:
components:
db:
infra:
storage:
size: 500Gi

El directory: de un límite se hereda como cualquier otro ajuste, así que una hija que hereda un directorio literal renderiza en el mismo lugar que su base. Escribir el directorio en función de un parámetro es lo que envía la salida de cada Release a un lugar propio; consulta Release compuesta y herencia con extends.

Un Manifest construido sobre otro

Un Manifest puede extender otro del mismo modo, y sus entradas reemplazan la entrada de la base para la misma clave. Un Manifest de desarrollo puede conservar todos los vínculos del de producción y cambiar cómo se realizan las credenciales: aquí un adjunto core/referenced-secret se obtiene de un almacén de secretos en producción y se escribe en un Secret a partir del valor que un autor proporciona en desarrollo.

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

Las dos realizaciones publican el nombre del Secret del mismo modo, así que un componente que lee la credencial renderiza la misma referencia sea cual sea el Manifest; Una intención del desarrollador, dos formas de entrega de credenciales compila ambas y las compara.

Dos etiquetas: el tipo y la categoría

Cada Component lleva un valor de un conjunto cerrado en la etiqueta reservada component.aggrega.ai/type: server, un endpoint de larga duración; worker, un consumidor en segundo plano; stateful-server, algo que conserva sus propios datos duraderos; task, que se ejecuta hasta completarse; function, una función dirigida por eventos; y resource, un recurso de nube gestionado que no ejecuta cómputo propio. El valor está en la entidad del catálogo, nunca en la instancia de un Aggregate.

El tipo dice cómo debe tratar la infraestructura a un componente, no para qué sirve el componente. Un broker de mensajes que tiene su propio disco es un stateful-server, exactamente igual que una base de datos: core/messaging/kafka y core/datastore/postgres llevan el mismo tipo. Por lo que navega un lector es la otra etiqueta, component.aggrega.ai/category — messaging para el broker, datastore para la base de datos —, que es también el directorio del catálogo en el que está la entidad. Un selector escrito contra una etiqueta nunca coincide en la otra.