Skip to main content

Module image

Module image 

Source
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
ImageMetadata
Image metadata stored in bootstrap directory
ImageReference
Parsed OCI image reference.
ManifestFetcher
Minimal manifest fetcher using reqwest.
OciManifest
OCI Image Manifest (single-platform).
RafsStore
RAFS-backed image store with Dragonfly-native blob fetching
RafsStoreMount
A read-only 9P/VFS Mount projecting a RafsStore’s CAS as a browsable file tree. See module docs for the layout.

Enums§

ManifestResult
Result of fetching a manifest - could be single or multi-platform.

Functions§

image_fs_for
Build an ImageFs for image_id.
image_fs_from_rafs
Build an ImageFs from an already-loaded RAFS lower and explicit upper/work directories.

Type Aliases§

ImageFs
The concrete type of a mountable OCI/RAFS image filesystem service.