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 (WorkloadLibrary)

Referencia generada. No la edites a mano — regenérala a partir del JSON Schema publicado.

ID del esquema: https://aggrega.ai/schemas/workloadlibrary-v1beta1.schema.json

Una colección reutilizable de fragmentos de plantilla de Workload que las Recipes consumen en el momento del renderizado mediante workload: { $import: ... }. Nivel 3 — opcional, para catálogos que necesitan reutilizar cargas de trabajo entre una Recipe y otra. Un único modo de autoría: solo plantillas Go.

Consulta la referencia de autoría de la WorkloadLibrary para obtener orientación en prosa sobre cómo escribir entidades WorkloadLibrary; 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 “WorkloadLibrary”síConstante: "WorkloadLibrary"
metadataobjectsí
specobjectsíEl contenido de la WorkloadLibrary. spec.workloads es obligatorio y debe declarar al menos una entrada. 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 de la Recipe (plantilla Go en todo momento) y evita obligar a los autores a cambiar de modelo de evaluación a mitad del renderizado al consumir fragmentos importados.

No se permiten propiedades adicionales.

workloadlibrary.metadata

PropiedadTipoObligatoriaDescripción
namestringsíIdentificador PascalCase de la biblioteca. Es el nombre en la referencia de identidad por nombre simple #/workloads/; 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 afirmarlo como un umbral de versión mínima :<version> opcional en una referencia por nombre simple (:#/workloads/); 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.

workloadlibrary.spec

El contenido de la WorkloadLibrary. spec.workloads es obligatorio y debe declarar al menos una entrada. 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 de la Recipe (plantilla Go en todo momento) y evita obligar a los autores a cambiar de modelo de evaluación a mitad del renderizado al consumir fragmentos importados.

PropiedadTipoObligatoriaDescripción
workloadsmapa de stringsíMapa con nombre de fragmentos de plantilla de Workload reutilizables. El cuerpo de cada entrada 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 (#/workloads/<name>); la restricción a nivel del envoltorio impide que claves que no son PascalCase se propaguen por el ecosistema del catálogo. Patrón: ^[A-Z][A-Za-z0-9]*$. Al menos 1 entrada.

No se permiten propiedades adicionales.