Esquema del archivo de bloqueo de dependencias de Aggrega (Manifest)
Referencia generada. No la edites a mano — regenérala a partir del JSON Schema publicado.
ID del esquema: https://aggrega.ai/schemas/manifest-v1beta1.schema.json
Un único archivo de bloqueo global que vincula los tipos abstractos de componente y de Feature con implementaciones concretas de Recipe y FeatureRecipe, por tipo, con una sobrescritura por instancia según el nombre.
Consulta la referencia de autoría del Manifest para obtener orientación en prosa sobre cómo escribir entidades Manifest; esta página documenta el esquema estructural que describe esa referencia.
Tipo de nivel superior: object
Propiedades
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | sí | Constante: "aggrega.ai/v1beta1" |
kind | const “Manifest” | sí | Constante: "Manifest" |
metadata | object | sí | |
defs | string[] | no | Bloque opcional para anclas YAML estándar (& y *) que mantiene el Manifest DRY a la vez que conserva un diccionario plano O(1) para el compilador. |
spec | object | sí | Las declaraciones de mapeo del Manifest más la herencia opcional de una base: mappings conecta los tipos abstractos de componente y de funcionalidad con implementaciones concretas de Recipe y FeatureRecipe; extends hereda los mapeos de un Manifest base. |
No se permiten propiedades adicionales.
manifest.metadata
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
name | string | sí | Al menos 1 carácter de longitud. |
version | string | sí | Versionado semántico estricto del archivo de bloqueo del manifiesto (p. ej., 1.0.0). Patrón: ^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$. |
description | string | no | Qué es esta entidad y para qué sirve, escrito para quien está decidiendo si usarla. Empieza con una frase que nombre la cosa y luego añade lo que un lector necesita para elegirla y usarla correctamente — qué espera de la Release que la usa, y cualquier cosa sorprendente sobre su comportamiento. Un párrafo corto es la extensión habitual. |
maintainers | object[] | no | Lista de mantenedores responsables de esta entidad. |
license | string | no | Identificador SPDX de la licencia del software que describe esta entidad, como MIT o AGPL-3.0. Registra las condiciones de ese software, no las de este archivo. |
repository | string | no | La URL del repositorio Git donde se encuentran los archivos fuente. |
home | string | no | La URL de la página de inicio, la wiki o la documentación de esta entidad. |
keywords | string[] | no | Una lista de palabras clave descriptivas para facilitar el descubrimiento en la interfaz de usuario. |
No se permiten propiedades adicionales.
manifest.metadata.maintainers[]
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
name | string | sí | |
email | string | no | |
url | string | no |
No se permiten propiedades adicionales.
manifest.spec
Las declaraciones de mapeo del Manifest más la herencia opcional de una base: mappings conecta los tipos abstractos de componente y de funcionalidad con implementaciones concretas de Recipe y FeatureRecipe; extends hereda los mapeos de un Manifest base.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
extends | string | no | URI de un Manifest base del que heredar los mapeos. El mapeo de un hijo reemplaza al de la base para la misma clave. |
mappings | object | sí | Asigna interfaces abstractas a implementaciones concretas. Declara los mapeos bajo las claves de nivel superior ‘components’ y ‘features’, cada una de las cuales asigna directamente URI de tipo de componente / tipo de funcionalidad a URI de Recipe / FeatureRecipe. Estas dos claves son toda la superficie; aquí no se acepta ninguna otra clave. El mapeo es agnóstico respecto a la capacidad en la capa del Manifest — la determinación de la capacidad se deriva del spec.capability de cada Recipe resuelta cuando Aggrega compila la Release. Claves: una de "components", "features". |
No se permiten propiedades adicionales.
manifest.spec.mappings
Asigna interfaces abstractas a implementaciones concretas. Declara los mapeos bajo las claves de nivel superior ‘components’ y ‘features’, cada una de las cuales asigna directamente URI de tipo de componente / tipo de funcionalidad a URI de Recipe / FeatureRecipe. Estas dos claves son toda la superficie; aquí no se acepta ninguna otra clave. El mapeo es agnóstico respecto a la capacidad en la capa del Manifest — la determinación de la capacidad se deriva del spec.capability de cada Recipe resuelta cuando Aggrega compila la Release.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
components | mapping_tier | no | Mapeo del tipo de Component al URI de Recipe. Un URI de Recipe lleva como máximo dos segmentos — una capacidad inicial opcional y luego el nombre de la receta — más una versión opcional; una referencia con un tercer segmento no coincide con ninguna receta. Formas de versión: exacta (‘postgres-bitnami:1.2.0’), rango (‘postgres-bitnami:^1.2.0’) o sin versión (‘postgres-bitnami’); el resolutor fija la versión resuelta en el archivo de bloqueo en la primera resolución. Una referencia puede además estar calificada por la capacidad (‘terraform/mariadb-rds:1.0.0’, donde el segmento anterior a la primera ’/’ nombra el spec.capability de la receta) — obligatorio cuando más de una receta se publica con el mismo nombre; una referencia simple ambigua detiene la resolución de forma bien visible en lugar de elegir una en silencio. |
features | mapping_tier | no | Mapeo del tipo de Feature al URI de FeatureRecipe. Incluye tanto las Features operativas como las Features de credenciales (etiquetadas con feature.aggrega.ai/kind: secret). |
Claves: una de "components", "features".
No se permiten propiedades adicionales.
Definiciones
mapping_tier
Resolución en dos niveles: ‘type’ asigna por tipo de catálogo (en bloque, DRY), ‘name’ asigna por nombre de instancia (sobrescritura granular). Ambos son opcionales, pero al menos uno debe estar presente. Durante la resolución, name prevalece sobre type. Las claves type con versión prevalecen sobre las que no tienen versión.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
type | mapa de string | no | Asigna URI de tipos de catálogo a URI de Recipe. Admite claves con versión (‘core/api-server:1.0.0’) para una coincidencia exacta, claves de rango (‘core/api-server:^1.0.0’) para una coincidencia compatible con la versión mayor, o claves sin versión (‘core/api-server’) para una coincidencia con cualquier versión. |
name | mapa de string | no | Asigna nombres de instancia concretos a URI de Recipe. Tiene prioridad sobre el mapeo basado en el tipo. |
annotations | mapa de object | no | Atajos de Feature guiados por anotaciones. Asigna claves de anotación a un URI de Feature más una tabla de enrutamiento agrupada por pilar, desde la subclave en ruta con puntos hasta el pilar de la Feature (values o infra). La validación se deriva de la declaración spec.schema. |
No se permiten propiedades adicionales.