podbox-cli 0.7.2

Declarative Podman-native container environment manager. Define an environment as a TOML file and let systemd own its lifecycle.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

use anyhow::Result;

use podbox::podman::{ContainerState, query_state};
use podbox::systemd;

pub mod clone;
pub mod context;
pub mod create;
pub mod create_init;
pub mod definition;
pub mod diff;
pub mod export;
pub mod history;
pub mod inspect;
pub mod lifecycle;
pub mod list;
pub mod migrate;
pub mod pull;
pub mod recover;
pub mod runtime;
pub mod serve;
pub mod stats;
pub mod translate;

pub const DEFAULT_START_TIMEOUT_SECS: u64 = 30;

/// Start a container if it isn't already running.
///
/// Uses `start_unit_friendly` from the systemd module when systemd is
/// available (friendly diagnostics on failure), falling back to
/// `podman start` for standalone containers.
pub fn ensure_running(name: &str, dry_run: bool, timeout_secs: u64) -> Result<()> {
    match query_state(name)? {
        ContainerState::Running => Ok(()),
        ContainerState::Stopped | ContainerState::Missing => {
            if dry_run {
                println!("podman start {name}");
                return Ok(());
            }
            if systemd::is_available() {
                systemd::start_unit_friendly(name, timeout_secs)
            } else {
                let args = podbox::process::args(&["start", name]);
                podbox::process::spawn_interactive("podman", &args)?;
                wait_for_running(name, timeout_secs)
            }
        }
    }
}

/// Poll until the container reaches Running state or timeout.
fn wait_for_running(name: &str, timeout_secs: u64) -> Result<()> {
    use std::time::{Duration, Instant};
    let deadline = Instant::now() + Duration::from_secs(timeout_secs);
    loop {
        match query_state(name)? {
            ContainerState::Running => return Ok(()),
            _ if Instant::now() >= deadline => {
                let state = query_state(name)?;
                anyhow::bail!(
                    "Container '{name}' did not become ready within {timeout_secs}s \
                     (final state: {state:?})",
                );
            }
            _ => {
                std::thread::sleep(Duration::from_millis(300));
            }
        }
    }
}