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

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

PropiedadTipoObligatoriaDescripción
kindenumsí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"
urlstringsí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_urlstringnoSolo 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.
versionstringsí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: ^([^/\\.]|\.[^/\\.])*\.?$.
digeststringsíDigest de contenido del archivo comprimido .tar.gz en caché en la forma sha256:. La verificación en tiempo de compilación calcula el SHA-256 de blob.tgz, lo compara con este campo Y con el digest de la entrada del archivo de bloqueo, y detiene la compilación, informando de una discrepancia del digest de contenido, cuando alguno de los dos difiere. Patrón: ^sha256:[a-f0-9]{64}$.
mediatypestringsí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_atstringsí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.