Pular para o conteúdo
AggregaAggrega
Selecionar língua: Português (Portugal)
Esta página foi traduzida automaticamente. Ler o original em inglês.

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

PropriedadeTipoObrigatóriaDescrição
kindenumsimO 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"
urlstringsimO 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_urlstringnãoApenas 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.
versionstringsimA 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: ^([^/\\.]|\.[^/\\.])*\.?$.
digeststringsimDigest de conteúdo do arquivo .tar.gz em cache na forma sha256:. A verificação em tempo de compilação calcula o SHA-256 de blob.tgz, compara-o com este campo E com o digest da entrada do ficheiro de bloqueio, e interrompe a compilação, reportando uma divergência do digest de conteúdo, quando qualquer um deles difere. Padrão: ^sha256:[a-f0-9]{64}$.
mediatypestringsimTipo 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_atstringsimCarimbo 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.