Esquema de los metadatos de la ranura de la caché de Aggrega
Referencia generada. No la edites a mano — regenérala a partir del JSON Schema publicado.
ID del esquema: https://aggrega.ai/schemas/cache-metadata-v1beta1.schema.json
El archivo metadata.yaml que se escribe en cada ranura de la caché de artefactos fuente junto a blob.tgz. Registra la tupla de identidad {kind, url, version, digest, mediatype, pulled_at} para que la inspección de la caché y la verificación de integridad en tiempo de compilación tengan un único registro canónico. La forma serializada es cerrada (additionalProperties: false) y los seis campos son obligatorios. Disciplina de evolución del esquema: añadir un nuevo campo opcional es SemVer-MINOR (aditivo); eliminar un campo o endurecer una restricción es SemVer-MAJOR.
Tipo de nivel superior: object
Propiedades
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
kind | enum | sí | El tipo de fuente que produjo esta ranura de la caché. Refleja el enum source_artifacts[].kind del archivo de bloqueo; el tipo coincidente es lo que lee cada consumidor en tiempo de compilación para elegir el cargador adecuado. Valores permitidos: "helm-oci-chart", "helm-https-chart", "compose-https-fragment", "git-repository", "terraform-module-oci" |
url | string | sí | La URL escrita por el autor — la URL de identidad tal como está escrita en el spec.source.url de la Recipe. Para helm-https-chart es la raíz del repositorio (forma de raíz del repositorio) o el .tgz directo (forma directa), exactamente como se escribió. Para git-repository, la URL clonable del repositorio. Para helm-oci-chart, la referencia del registro. Para compose-https-fragment, la URL HTTPS del fragmento. La ubicación resuelta del artefacto para una fuente helm de raíz del repositorio se registra por separado bajo resolved_url: como procedencia. |
resolved_url | string | no | Solo procedencia: la ubicación concreta del artefacto a la que se resolvió la URL escrita por el autor en el momento del pull. Para una fuente helm de raíz del repositorio es la URL directa del .tgz a la que el índice del repositorio resolvió chart+versión. Se registra para diagnóstico; no forma parte de ningún contrato de integridad. Ausente cuando la ubicación resuelta es igual a la URL escrita por el autor. |
version | string | sí | La versión concreta que el resolver fijó en el momento del pull. Para los tipos helm-*, la versión del chart. Para git-repository, el commit al que se resolvió la referencia escrita por el autor. Se registra como un único segmento de ruta, porque construye la ranura de la caché en la que están estos metadatos, así que no lleva /, ni \, ni ... Patrón: ^([^/\\.]|\.[^/\\.])*\.?$. |
digest | string | sí | Digest de contenido del archivo comprimido .tar.gz en caché en la forma sha256:^sha256:[a-f0-9]{64}$. |
mediatype | string | sí | Tipo de medio canónico que anunció el registro (o el valor predeterminado del tipo para los tipos sin metadatos de registro). Se registra como procedencia de diagnóstico. |
pulled_at | string | sí | Marca de tiempo RFC 3339 que registra la hora real del momento del pull. Solo procedencia de diagnóstico — no forma parte de ningún contrato de integridad. El patrón ciñe el valor a la forma RFC 3339 cuando se leen los metadatos. Patrón: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})$. |
No se permiten propiedades adicionales.