Esquema dos metadados do slot do cache do Aggrega
Referência gerada. Não edite à mão — gere novamente a partir do JSON Schema publicado.
ID do esquema: https://aggrega.ai/schemas/cache-metadata-v1beta1.schema.json
O arquivo metadata.yaml escrito em cada slot do cache de artefatos de fonte junto a blob.tgz. Registra a tupla de identidade {kind, url, version, digest, mediatype, pulled_at} para que a inspeção do cache e a verificação de integridade em tempo de build tenham um único registro canônico. O formato serializado é fechado (additionalProperties: false) e todos os seis campos são obrigatórios. Disciplina de evolução do esquema: adicionar 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 do cache. Espelha o enum source_artifacts[].kind do arquivo de bloqueio; o tipo correspondente é o que todo consumidor em tempo de build 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 | A URL escrita pelo autor — a URL de identidade como está escrita 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, a URL clonável do repositório. Para helm-oci-chart, a referência do registro. Para compose-https-fragment, a URL HTTPS do fragmento. O local resolvido do artefato para uma fonte helm de raiz do repositório é registrado separadamente em resolved_url: como procedência. |
resolved_url | string | não | Apenas procedência: o local concreto do artefato para o qual a URL escrita pelo autor foi resolvida no momento do pull. Para uma fonte helm de raiz do repositório, é a URL direta do .tgz para a qual o índice do repositório resolveu chart+versão. Registrado para diagnóstico; não faz parte de nenhum contrato de integridade. Ausente quando o local resolvido é igual à URL escrita 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. Registrada como um único segmento de caminho, porque ela forma o slot do cache em que estes metadados ficam, então não contém /, nem \, nem ... Padrão: ^([^/\\.]|\.[^/\\.])*\.?$. |
digest | string | sim | Digest de conteúdo do arquivo compactado .tar.gz em cache no formato sha256:^sha256:[a-f0-9]{64}$. |
mediatype | string | sim | Tipo de mídia canônico anunciado pelo registro (ou o padrão do tipo para tipos sem metadados de registro). Registrado como procedência para diagnóstico. |
pulled_at | string | sim | Carimbo de tempo RFC 3339 que registra o horário real no momento do pull. Apenas procedência para diagnóstico — não faz parte de nenhum contrato de integridade. O padrão restringe o valor ao formato 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.