Ir para o conteúdo

federated-package-experiment-service

Papel

Serviço Java para armazenar e resolver artefatos de experimento no filesystem configurado. Calcula referências de conteúdo e restringe caminhos; não é um banco Fabric nem um registry remoto de objetos.

API e configuração

LocalArtifactExperimentService.store(namespace, filename, bytes) grava e retorna ArtifactReference (URI, SHA-256 e sizeBytes). read(reference) recupera o conteúdo validando confinamento sob a raiz (com fallback BL-117 resolveAcrossForeignRoot para bind mounts), e readIfPresent(namespace, filename) oferece leitura opcional sem exceção. A raiz padrão é target/artifacts, alterável por HDT_AF_ARTIFACT_ROOT. O método interno resolveSecure(...) é privado.

ArtifactRetentionPolicy compara validTo do contrato e pode remover a pasta do experimento expirado. O monitor chama essa política no bootstrap/manutenção. Erros parciais de exclusão são reportados; não se deve afirmar remoção garantida em qualquer falha de filesystem.

Integração

Orquestrador, cliente Docker e alguns caminhos de experimento guardam/resolvem updates, modelos e relatórios fora do payload MQTT. Fabric recebe referências e evidências conforme a operação, não executa armazenamento de arquivo deste serviço. O armazenamento local persistente permanece uma limitação frente ao objetivo arquitetural de staging temporário, registrada em BL-298.

Entrada: bytes, namespace/nome e datas de retenção. Saída: referência endereçável, bytes verificados ou resultado de retenção.

Build e teste

Maven/JDK 25:

mvn -pl modules/federated-package-experiment-service -am test

Veja serviço de artefatos.

Documentação relacionada