Struct podman_api::api::Containers

pub struct Containers<'podman> { /* fields omitted */ }

Handle for Podman Containers.

Implementations

impl<'podman> Containers<'podman>

pub fn new(podman: &'podman Podman) -> Self

Exports an interface for interacting with Podman Containers.

pub fn get(&self, id: impl Into<Id>) -> Container<'podman>

Returns a reference to a set of operations available to a specific Container.

impl<'podman> Containers<'podman>

pub async fn create(
    &self,
    opts: &ContainerCreateOpts
) -> Result<ContainerCreateCreatedBody>

Api Reference

Create a container with specified options.

Examples:

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

if let Err(e) = podman
    .containers()
    .create(
        &ContainerCreateOpts::builder()
            .image("debian:11")
            .command(
                ["/usr/bin/httpd"]
            )
            .env([
                ("app", "web"),
            ])
            .build(),
    )
    .await
{
    eprintln!("{}", e);
}

pub async fn list(&self, opts: &ContainerListOpts) -> Result<Vec<ListContainer>>

Api Reference

Returns a list of containers.

Examples:

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

for container in podman
    .containers()
    .list(
        &ContainerListOpts::builder()
            .all(true)
            .filter([ContainerListFilter::LabelKeyVal("app".into(), "web".into())])
            .build(),
    )
    .await
    .unwrap()
{
    println!("{:?}", container);
}

Trait Implementations

impl<'podman> Debug for Containers<'podman>

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

Formats the value using the given formatter.