Esquema del catálogo de Aggrega (ArtifactLibrary)
Referencia generada. No la edites a mano — regenérala a partir del JSON Schema publicado.
ID del esquema: https://aggrega.ai/schemas/artifactlibrary-v1beta1.schema.json
Una colección reutilizable de bundles de artefactos con nombre que las Recipes y FeatureRecipes consumen en el momento del renderizado mediante artifacts.<name>: { $import: ... }. Cada bundle es un conjunto de archivos de salida importados como una sola unidad. Nivel 3 — opcional, para catálogos que necesitan reutilizar artefactos entre una Recipe y otra. Un único modo de autoría: solo plantillas Go.
Consulta la referencia de autoría de la ArtifactLibrary para obtener orientación en prosa sobre cómo escribir entidades ArtifactLibrary; 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 “ArtifactLibrary” | sí | Constante: "ArtifactLibrary" |
metadata | object | sí | |
spec | object | sí | El contenido de la ArtifactLibrary. spec.artifacts es obligatorio y debe declarar al menos un bundle. spec lleva additionalProperties: false — no se aceptan modos de autoría paralelos a nivel del envoltorio. La postura de un único modo de autoría mantiene uniforme el renderizado (plantillas Go en todo) y evita obligar a los autores a cambiar de modelo de evaluación a mitad del renderizado al consumir bundles importados. |
No se permiten propiedades adicionales.
artifactlibrary.metadata
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
name | string | sí | Identificador PascalCase de la biblioteca. Es el nombre ^[A-Z][A-Za-z0-9]*$. |
version | string | sí | Versionado semántico estricto de la biblioteca (p. ej., 1.0.0). Un consumidor puede exigirla como versión mínima :<version> opcional en una referencia por nombre simple (^(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 | Un resumen conciso de lo que cubre la biblioteca. |
labels | mapa de string | no | Etiquetas declaradas por el autor. El compilador es neutral respecto al contenido y no interpreta los valores de las etiquetas: son metadatos opacos, transmitidos para que lo que lea la biblioteca pueda usarlos para hacer coincidencias. |
annotations | mapa de string | no | Anotaciones declaradas por el autor. La misma postura de metadatos opacos que las etiquetas. |
No se permiten propiedades adicionales.
artifactlibrary.spec
El contenido de la ArtifactLibrary. spec.artifacts es obligatorio y debe declarar al menos un bundle. spec lleva additionalProperties: false — no se aceptan modos de autoría paralelos a nivel del envoltorio. La postura de un único modo de autoría mantiene uniforme el renderizado (plantillas Go en todo) y evita obligar a los autores a cambiar de modelo de evaluación a mitad del renderizado al consumir bundles importados.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
artifacts | mapa de mapas de string | sí | Mapa con nombre de bundles de artefactos reutilizables. Cada bundle agrupa los archivos de salida que van juntos (por ejemplo, una CRD, su RBAC y un ConfigMap). El cuerpo de cada archivo es opaco para la validación del envoltorio — la semántica del contenido la gestiona el parser de plantillas Go en el momento del consumo. Claves: identificador PascalCase. Las claves de las entradas aparecen en las URL de referencia canónicas (#/artifacts/<name>); la restricción a nivel del envoltorio impide que claves que no son PascalCase se propaguen por el ecosistema del catálogo. El ^[A-Z][A-Za-z0-9]*$. Al menos 1 entrada. |
No se permiten propiedades adicionales.