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:
Veja serviço de artefatos.
Documentação relacionada¶
- Guia do componente: 02-package-experiment-service.md
- Inventário do workspace: docs/modules.md