Struct Client

pub struct Client {
    pub cache: Cache,
    pub opts: ClientOpts,
    /* private fields */
}

Client for interacting with an OCI registry for Spin applications.

Fields

cache: Cache

Global cache for the metadata, Wasm modules, and static assets pulled from OCI registries.

opts: ClientOpts

Client options

Implementations

impl Client

pub async fn new(insecure: bool, cache_root: Option<PathBuf>) -> Result<Self>

Create a new instance of an OCI client for distributing Spin applications.

pub async fn push( &mut self, manifest_path: &Path, reference: impl AsRef<str>, annotations: Option<BTreeMap<String, String>>, infer_annotations: InferPredefinedAnnotations, ) -> Result<Option<String>>

Push a Spin application to an OCI registry and return the digest (or None if the digest cannot be determined).

pub async fn push_locked( &mut self, locked: LockedApp, reference: impl AsRef<str>, annotations: Option<BTreeMap<String, String>>, infer_annotations: InferPredefinedAnnotations, ) -> Result<Option<String>>

Push a Spin application to an OCI registry and return the digest (or None if the digest cannot be determined).

pub async fn pull(&mut self, reference: &str) -> Result<()>

Pull a Spin application from an OCI registry.

pub async fn lockfile_path(&self, reference: impl AsRef<str>) -> Result<PathBuf>

Get the file path to the OCI configuration object given a reference.

pub async fn login( server: impl AsRef<str>, username: impl AsRef<str>, password: impl AsRef<str>, ) -> Result<()>

Save a credential set containing the registry username and password.

pub async fn insert_token( &mut self, reference: &Reference, op: RegistryOperation, token: RegistryTokenType, )

Insert a token in the OCI client token cache.