Struct podman_api::api::Manifest

pub struct Manifest { /* private fields */ }

Interface for accessing and manipulating Podman Manifest.

Api Reference

Implementations

impl Manifest

pub fn new(podman: Podman, name: impl Into<Id>) -> Self

Exports an interface exposing operations against a Manifest instance.

pub fn name(&self) -> &Id

A getter for Manifest name

impl Manifest

pub async fn exists(&self) -> Result<bool>

Api Reference

Quick way to determine if a manifest exists by name or id.

Examples:

async {
    use podman_api::Podman;
    let podman = Podman::unix("/run/user/1000/podman/podman.sock");

    match podman.manifests().get("some-manifest").exists().await {
        Ok(exists) => if exists {
            println!("manifest exists!");
        } else {
            println!("manifest doesn't exists!");
        },
        Err(e) => eprintln!("check failed: {}", e),
    }
};

pub async fn inspect(&self) -> Result<Schema2List>

Api Reference

Display details about this manifest list.

Examples:

async {
    use podman_api::Podman;
    let podman = Podman::unix("/run/user/1000/podman/podman.sock");

    match podman.manifests().get("my-manifest").inspect().await {
        Ok(info) => println!("{:?}", info),
        Err(e) => eprintln!("{}", e),
    }
};

pub async fn add_image(&self, opts: &ManifestImageAddOpts) -> Result<IdResponse>

Api Reference

Add an image to this manifest list.

Examples:

async {
    use podman_api::Podman;
    use podman_api::opts::ManifestImageAddOpts;
    let podman = Podman::unix("/run/user/1000/podman/podman.sock");

    let manifest = podman.manifests().get("my-manifest");
    match manifest
        .add_image(&ManifestImageAddOpts::builder().images(["centos"]).build())
        .await
    {
        Ok(id) => println!("{:?}", id),
        Err(e) => eprintln!("{}", e),
    }
};

pub async fn remove_image(
    &self,
    digest: impl Into<String>
) -> Result<ManifestRemoveReport>

Api Reference

Remove an image digest from this manifest list.

Examples:

async {
    use podman_api::Podman;
    let podman = Podman::unix("/run/user/1000/podman/podman.sock");

    match podman
      .manifests()
      .get("my-manifest")
      .remove_image("sha256:a1801b843b1bfaf77c501e7a6d3f709401a1e0c83863037fa3aab063a7fdb9dc")
      .await {
        Ok(report) => println!("{:?}", report),
        Err(e) => eprintln!("{}", e),
    }
};

pub async fn push(&self, opts: &ManifestPushOpts) -> Result<IdResponse>

Api Reference

Push this manifest list to a registry.

Examples:

async {
    use podman_api::Podman;
    use podman_api::opts::ManifestPushOpts;
    let podman = Podman::unix("/run/user/1000/podman/podman.sock");

    let manifest = podman.manifests().get("my-manifest");
    match manifest
        .push(&ManifestPushOpts::builder("some-registry.addr").all(true).build())
        .await
    {
        Ok(id) => println!("{:?}", id),
        Err(e) => eprintln!("{}", e),
    }
};

pub async fn delete(&self) -> Result<()>

Api Reference

Delete this manifest list. Examples:

async {
    use podman_api::Podman;
    let podman = Podman::unix("/run/user/1000/podman/podman.sock");

    if let Err(e) = podman.manifests().get("my-manifest").delete().await {
        eprintln!("{}", e);
    }
};

Trait Implementations

impl Debug for Manifest

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.