Esquema dos metadados do slot da cache do Aggrega
Referência gerada. Não editar à mão — gerar novamente a partir do JSON Schema publicado.
ID do esquema: https://aggrega.ai/schemas/cache-metadata-v1beta1.schema.json
O ficheiro metadata.yaml escrito em cada slot da cache de artefactos de fonte junto a blob.tgz. Regista a tupla de identidade {kind, url, version, digest, mediatype, pulled_at} para que a inspeção da cache e a verificação de integridade em tempo de compilação tenham um único registo canónico. A forma serializada é fechada (additionalProperties: false) e os seis campos são todos obrigatórios. Disciplina de evolução do esquema: acrescentar um novo campo opcional é SemVer-MINOR (aditivo); remover um campo ou tornar uma restrição mais rígida é SemVer-MAJOR.
Tipo de nível superior: object
Propriedades
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
kind | enum | sim | O tipo de fonte que produziu este slot da cache. Espelha o enum source_artifacts[].kind do ficheiro de bloqueio; o tipo correspondente é aquilo que cada consumidor em tempo de compilação lê para escolher o carregador certo. Valores permitidos: "helm-oci-chart", "helm-https-chart", "compose-https-fragment", "git-repository", "terraform-module-oci" |
url | string | sim | O URL escrito pelo autor — o URL de identidade tal como está escrito no spec.source.url da Recipe. Para helm-https-chart, é a raiz do repositório (forma de raiz do repositório) ou o .tgz direto (forma direta), exatamente como escrito. Para git-repository, o URL clonável do repositório. Para helm-oci-chart, a referência do registo. Para compose-https-fragment, o URL HTTPS do fragmento. A localização resolvida do artefacto para uma fonte helm de raiz do repositório é registada separadamente em resolved_url: como proveniência. |
resolved_url | string | não | Apenas proveniência: a localização concreta do artefacto para a qual o URL escrito pelo autor foi resolvido no momento do pull. Para uma fonte helm de raiz do repositório, é o URL direto do .tgz para o qual o índice do repositório resolveu chart+versão. Registada para diagnóstico; não faz parte de nenhum contrato de integridade. Ausente quando a localização resolvida é igual ao URL escrito pelo autor. |
version | string | sim | A versão concreta que o resolvedor fixou no momento do pull. Para os tipos helm-*, a versão do chart. Para git-repository, o commit para o qual a referência escrita pelo autor foi resolvida. Registada como um único segmento de caminho, porque forma o slot da cache em que estes metadados se encontram, pelo que não contém /, nem \, nem ... Padrão: ^([^/\\.]|\.[^/\\.])*\.?$. |
digest | string | sim | Digest de conteúdo do arquivo .tar.gz em cache na forma sha256:^sha256:[a-f0-9]{64}$. |
mediatype | string | sim | Tipo de media canónico anunciado pelo registo (ou a predefinição do tipo para tipos sem metadados de registo). Registado como proveniência para diagnóstico. |
pulled_at | string | sim | Carimbo temporal RFC 3339 que regista a hora real no momento do pull. Apenas proveniência para diagnóstico — não faz parte de nenhum contrato de integridade. O padrão restringe o valor à forma RFC 3339 quando os metadados são lidos. Padrão: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})$. |
Não são permitidas propriedades adicionais.