Expand description
CRI image service implementation with Dragonfly-native blob fetching
Provides Kubernetes CRI-aligned APIs for managing container images. Backed by Nydus RAFS for chunk-level CAS deduplication.
§Architecture
The canonical ImageClient contract and client live in `hyprstream-rpc-std`.
│
├── list_images() → List available images
├── image_status() → Get image details
├── pull_image() → Pull from registry (Dragonfly P2P)
└── remove_image() → Remove image
│
└── RafsStore
│
├── ManifestFetcher (HTTP - manifests only)
├── nydus-storage (Dragonfly-native blob fetch)
│
├── blobs/ (layer blobs)
├── bootstrap/ (RAFS metadata)
├── cache/ (nydus blob cache)
└── refs/ (tag symlinks)§Dragonfly Integration
When ImageConfig::dragonfly_peer is set, all blob fetches route through
the Dragonfly peer for P2P distribution. This happens transparently via
nydus-storage’s blob_redirected_host configuration.
Re-exports§
pub use store_trait::ImageBackendRegistration;pub use store_trait::ImageStore;
Modules§
- store_
trait - Feature-invariant image-store trait + inventory registration.
Structs§
- GcStats
- Garbage collection statistics
- Image
Metadata - Image metadata stored in bootstrap directory
- Image
Reference - Parsed OCI image reference.
- Manifest
Fetcher - Minimal manifest fetcher using reqwest.
- OciManifest
- OCI Image Manifest (single-platform).
- Rafs
Store - RAFS-backed image store with Dragonfly-native blob fetching
- Rafs
Store Mount - A read-only 9P/VFS
Mountprojecting aRafsStore’s CAS as a browsable file tree. See module docs for the layout.
Enums§
- Manifest
Result - Result of fetching a manifest - could be single or multi-platform.
Functions§
- image_
fs_ for - Build an
ImageFsforimage_id. - image_
fs_ from_ rafs - Build an
ImageFsfrom an already-loaded RAFS lower and explicit upper/work directories.
Type Aliases§
- ImageFs
- The concrete type of a mountable OCI/RAFS image filesystem service.