Esquema do catálogo do Aggrega (WorkloadLibrary)
Referência gerada. Não editar à mão — gerar novamente a partir do JSON Schema publicado.
ID do esquema: https://aggrega.ai/schemas/workloadlibrary-v1beta1.schema.json
Uma coleção reutilizável de fragmentos de template de Workload que as Recipes consomem no momento da renderização através de workload: { $import: ... }. Camada 3 — opcional, para catálogos que precisem de reutilizar cargas de trabalho entre uma Recipe e outra. Um único modo de autoria: apenas templates Go.
Consulte-se a referência de autoria da WorkloadLibrary para orientações em prosa sobre como escrever entidades WorkloadLibrary; esta página documenta o esquema estrutural que essa referência descreve.
Tipo de nível superior: object
Propriedades
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | sim | Constante: "aggrega.ai/v1beta1" |
kind | const “WorkloadLibrary” | sim | Constante: "WorkloadLibrary" |
metadata | objeto | sim | |
spec | objeto | sim | O conteúdo da WorkloadLibrary. spec.workloads é obrigatório e tem de declarar pelo menos uma entrada. spec tem additionalProperties: false — não é aceite nenhum modo de autoria paralelo ao nível do envelope. A opção por um modo de autoria único mantém uniforme a renderização da Recipe (template Go em todo o lado) e evita obrigar os autores a mudar de modelo de avaliação a meio da renderização quando consomem fragmentos importados. |
Não são permitidas propriedades adicionais.
workloadlibrary.metadata
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
name | string | sim | Identificador PascalCase da biblioteca. É o nome ^[A-Z][A-Za-z0-9]*$. |
version | string | sim | Versionamento semântico estrito da biblioteca (por exemplo, 1.0.0). Um consumidor pode afirmá-la como um limiar de versão mínima :<version> opcional numa referência por nome simples (^(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 | não | Um resumo conciso do que a biblioteca abrange. |
labels | mapa de string | não | Etiquetas declaradas pelo autor. O compilador é neutro quanto ao conteúdo e não interpreta os valores das etiquetas: são metadados opacos, transportados para que aquilo que ler a biblioteca os possa usar na correspondência. |
annotations | mapa de string | não | Anotações declaradas pelo autor. A mesma postura de metadados opacos das etiquetas. |
Não são permitidas propriedades adicionais.
workloadlibrary.spec
O conteúdo da WorkloadLibrary. spec.workloads é obrigatório e tem de declarar pelo menos uma entrada. spec tem additionalProperties: false — não é aceite nenhum modo de autoria paralelo ao nível do envelope. A opção por um modo de autoria único mantém uniforme a renderização da Recipe (template Go em todo o lado) e evita obrigar os autores a mudar de modelo de avaliação a meio da renderização quando consomem fragmentos importados.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
workloads | mapa de string | sim | Mapa com nome de fragmentos de template de Workload reutilizáveis. O corpo de cada entrada é opaco para a validação do envelope — a semântica do conteúdo é tratada pelo parser de templates Go no momento do consumo. Chaves: identificador PascalCase. As chaves das entradas aparecem nos URL de referência canónicos (#/workloads/<name>); a restrição ao nível do envelope impede que chaves que não sejam PascalCase se propaguem pelo ecossistema do catálogo. Padrão: ^[A-Z][A-Za-z0-9]*$. Pelo menos 1 entrada. |
Não são permitidas propriedades adicionais.