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

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

PropiedadTipoObligatoriaDescripción
apiVersionconst “aggrega.ai/v1beta1”síConstante: "aggrega.ai/v1beta1"
kindconst “Manifest”síConstante: "Manifest"
metadataobjectsí
defsstring[]noBloque 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.
specobjectsí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

PropiedadTipoObligatoriaDescripción
namestringsíAl menos 1 carácter de longitud.
versionstringsí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-]+)*))?$.
descriptionstringnoQué 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.
maintainersobject[]noLista de mantenedores responsables de esta entidad.
licensestringnoIdentificador 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.
repositorystringnoLa URL del repositorio Git donde se encuentran los archivos fuente.
homestringnoLa URL de la página de inicio, la wiki o la documentación de esta entidad.
keywordsstring[]noUna lista de palabras clave descriptivas para facilitar el descubrimiento en la interfaz de usuario.

No se permiten propiedades adicionales.

manifest.metadata.maintainers[]
PropiedadTipoObligatoriaDescripción
namestringsí
emailstringno
urlstringno

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.

PropiedadTipoObligatoriaDescripción
extendsstringnoURI de un Manifest base del que heredar los mapeos. El mapeo de un hijo reemplaza al de la base para la misma clave.
mappingsobjectsí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.

PropiedadTipoObligatoriaDescripción
componentsmapping_tiernoMapeo 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.
featuresmapping_tiernoMapeo 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.

PropiedadTipoObligatoriaDescripción
typemapa de stringnoAsigna 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.
namemapa de stringnoAsigna nombres de instancia concretos a URI de Recipe. Tiene prioridad sobre el mapeo basado en el tipo.
annotationsmapa de objectnoAtajos 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.. de la Feature de destino; el enlace solo declara el enrutamiento. El URI de Feature al que hace referencia ‘feature’ DEBE aparecer también en la sección ‘type’ (ahí es donde reside el enlace con la versión de la FeatureRecipe).

No se permiten propiedades adicionales.