Struct Cache

pub struct Cache { /* private fields */ }

Docker 镜像缓存管理

提供本地缓存功能，结构与 Docker Registry API 兼容，支持从 repository 或 tar 文件 获取 manifest 和 blob，并支持从缓存中推送。

缓存结构:

.cache/
  manifests/{repository}/{reference}
  blobs/sha256/{digest}
  index.json  // 缓存索引

Implementations

impl Cache

pub fn new<P: AsRef<Path>>(cache_dir: Option<P>) -> Result<Self>

创建新的缓存管理器

pub fn save_manifest( &mut self, repository: &str, reference: &str, manifest: &[u8], config_digest: &str, ) -> Result<PathBuf>

保存清单（manifest）到缓存

pub fn save_blob( &mut self, digest: &str, data: &[u8], _is_config: bool, _compressed: bool, ) -> Result<PathBuf>

保存 blob 到缓存

pub fn associate_blob_with_image( &mut self, repository: &str, reference: &str, digest: &str, size: u64, is_config: bool, compressed: bool, ) -> Result<()>

将 blob 关联到指定的镜像

pub fn add_blob( &mut self, digest: &str, data: &[u8], _is_config: bool, _compressed: bool, ) -> Result<PathBuf>

Add a blob to the cache

pub fn get_blob_path(&self, digest: &str) -> PathBuf

Get blob path from digest

pub fn has_blob(&self, digest: &str) -> bool

Check if a blob exists in cache

pub fn get_manifest(&self, repository: &str, reference: &str) -> Result<Vec<u8>>

从缓存中获取 manifest

pub fn get_blob(&self, digest: &str) -> Result<Vec<u8>>

从缓存中获取 blob

pub fn remove_manifest( &mut self, repository: &str, reference: &str, ) -> Result<()>

删除清单及其未被其他镜像引用的 blob

pub fn list_manifests(&self) -> Vec<(String, String)>

列出缓存中的所有清单

pub fn get_stats(&self) -> Result<CacheStats>

获取缓存统计信息

pub fn get_blob_size(&self, digest: &str) -> Option<u64>

从缓存中获取blob大小

pub fn get_image_blobs( &self, repository: &str, reference: &str, ) -> Result<Vec<BlobInfo>>

获取镜像的所有blob信息

pub fn is_image_complete( &self, repository: &str, reference: &str, ) -> Result<bool>

检查镜像是否完整（manifest和所有blob都存在）

pub fn cache_from_tar( &mut self, tar_path: &Path, repository: &str, reference: &str, ) -> Result<()>

从tar文件中提取blob信息并缓存