Struct S3Storage 

pub struct S3Storage { /* private fields */ }

S3-compatible object storage backend.

Implementations

impl S3Storage

pub fn new( bucket: String, region: String, endpoint: Option<String>, ) -> Result<Self, CacheError>

Create a new S3 storage backend.

Uses AWS default credential chain (IRSA, env vars, instance profile). Set endpoint for non-AWS S3-compatible services (MinIO, RustFS, R2).

pub fn bucket(&self) -> &str

Return the bucket name.

pub fn region(&self) -> &str

Return the region.

pub fn endpoint(&self) -> Option<&str>

Return the custom endpoint, if any.

Trait Implementations

impl StorageBackend for S3Storage

fn get_narinfo<'life0, 'life1, 'async_trait>( &'life0 self, hash: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Option<String>, CacheError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Retrieve narinfo text by store path hash.

fn put_narinfo<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, hash: &'life1 str, content: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<(), CacheError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Store narinfo text keyed by store path hash.

fn get_nar<'life0, 'life1, 'async_trait>( &'life0 self, nar_path: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Option<Vec<u8>>, CacheError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Retrieve a NAR blob by its relative path.

fn put_nar<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, nar_path: &'life1 str, data: &'life2 [u8], ) -> Pin<Box<dyn Future<Output = Result<(), CacheError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Store a NAR blob at the given relative path.

fn delete<'life0, 'life1, 'async_trait>( &'life0 self, hash: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<(), CacheError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Delete a store path’s narinfo and associated NAR blob.

fn list_narinfos<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Vec<String>, CacheError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

List all stored narinfo hashes.

fn wipe_all<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<usize, CacheError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Clear EVERY narinfo and NAR blob from this backend (all tiers, for a TieredBackend). Returns the number of narinfos removed.