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

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

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

PropiedadTipoObligatoriaDescripción
namestringsíIdentificador PascalCase de la biblioteca. Es el nombre en la referencia de identidad por nombre simple #/artifacts/; la versión la proporciona el archivo de bloqueo de cada Release y ningún host de registro entra en la referencia ni en ningún identificador derivado. Patrón: ^[A-Z][A-Za-z0-9]*$.
versionstringsí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 (:#/artifacts/); el archivo de bloqueo de cada Release determina la versión resuelta. 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-]+)*))?$.
descriptionstringnoUn resumen conciso de lo que cubre la biblioteca.
labelsmapa de stringnoEtiquetas 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.
annotationsmapa de stringnoAnotaciones 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.

PropiedadTipoObligatoriaDescripción
artifactsmapa de mapas de stringsí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 designa el bundle entero, nunca un archivo individual dentro de él. Patrón: ^[A-Z][A-Za-z0-9]*$. Al menos 1 entrada.

No se permiten propiedades adicionales.