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:
aggrega scaffold --example postgres-three-realizationsDespués imprime los comandos que hay que ejecutar a continuación:
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: 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: appusery 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: 0Las 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 settingspec: extends: ./release-base.yaml boundaries: stack: components: db: infra: storage: size: 500GiEl 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.
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.0Las 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.