Struct podman_api::api::Manifest

source · [−]

pub struct Manifest<'podman> { /* private fields */ }

Expand description

Interface for accessing and manipulating Podman Manifest.

Api Reference

Implementations

source

impl<'podman> Manifest<'podman>

source

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

Exports an interface exposing operations against a Manifest instance.

source

pub fn name(&self) -> &Id

A getter for Manifest name

source

impl<'podman> Manifest<'podman>

source

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),
    }
};

source

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),
    }
};

source

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),
    }
};

source

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

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(id) => println!("{:?}", id),
        Err(e) => eprintln!("{}", e),
    }
};

source

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),
    }
};