6f52bb46cd
Source commit: a43e907efd9d1561c23fe73499478e881f868355 Public tree identity: sha256:453dea30195485dd8939f575a69b39f4bb7acd84c4df23f8aa29b55d044f2673
36 lines
1.4 KiB
Markdown
36 lines
1.4 KiB
Markdown
# Artifacts
|
|
|
|
Clusterflux separates artifact metadata from artifact bytes.
|
|
|
|
## Publish metadata
|
|
|
|
"flush()" makes a VFS artifact visible to downstream tasks and records its
|
|
digest, size, producer task and attempt, and retaining locations. It does not
|
|
upload bytes to the coordinator by default.
|
|
|
|
Your node retains artifact bytes on a best-effort basis. If every retaining node
|
|
is lost, stale, revoked, or garbage-collects the bytes, the artifact is
|
|
unavailable. Clusterflux reports that state instead of inventing durable
|
|
storage.
|
|
|
|
## Move bytes explicitly
|
|
|
|
Use "sync()" or an explicit export when you need another node or your own storage
|
|
system to hold the bytes. Same-node reuse avoids a coordinator transfer.
|
|
|
|
## Download
|
|
|
|
~~~bash
|
|
clusterflux artifact list --process <process-id>
|
|
clusterflux artifact download <artifact-id> --to ./output.bin --max-bytes 67108864
|
|
~~~
|
|
|
|
Before returning a link, the service checks authorization, current retention,
|
|
source-node liveness, live size, project quota, and relay capacity. It reserves
|
|
the affordable ingress and egress budget atomically. The scoped link is
|
|
unguessable, expires, can be revoked, and is bound to the actor, tenant, project,
|
|
process, artifact, and policy context.
|
|
|
|
The reverse stream counts framing, base64 expansion, failed bytes, and abandoned
|
|
transfers. The CLI verifies the final digest. Hosted policy may impose stricter
|
|
size, concurrency, and period limits or disable relay traffic globally.
|