kanade 0.18.0

Admin CLI for the kanade endpoint-management system. Deploy YAML manifests, schedule cron jobs, kill running jobs, revoke commands, publish new agent releases — over NATS + HTTP
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
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90

//! `kanade exec <job-id>` — fan out a registered job to a
//! caller-specified target. v0.18: target lives on the caller now
//! (not on the Manifest), so flags pick `--all` / `--groups` /
//! `--pcs`. Wave rollout is intentionally not exposed on the CLI —
//! use a Schedule yaml if you want waves.

use anyhow::{Context, Result};
use clap::Args;
use kanade_shared::manifest::{FanoutPlan, Target};
use serde::Deserialize;
use tracing::info;

#[derive(Args, Debug)]
pub struct ExecArgs {
    /// Id of a registered job (see `kanade job list`).
    pub job_id: String,

    /// Fire at every agent. Mutually exclusive with --groups / --pcs.
    #[arg(long, conflicts_with_all = ["groups", "pcs"])]
    pub all: bool,

    /// Comma-separated group names (e.g. `--groups canary,wave1`).
    #[arg(long, value_delimiter = ',')]
    pub groups: Vec<String>,

    /// Comma-separated pc_ids (e.g. `--pcs minipc-01,minipc-02`).
    #[arg(long, value_delimiter = ',')]
    pub pcs: Vec<String>,

    /// Humantime jitter window the agent randomises start within
    /// (e.g. `30s`, `5m`).
    #[arg(long)]
    pub jitter: Option<String>,
}

#[derive(Deserialize, Debug)]
struct ExecResponse {
    exec_id: String,
    job_id: String,
    version: String,
    target_count: u32,
    subjects: Vec<String>,
}

pub async fn execute(backend_url: &str, args: ExecArgs) -> Result<()> {
    let target = Target {
        all: args.all,
        groups: args.groups,
        pcs: args.pcs,
    };
    if !target.is_specified() {
        anyhow::bail!(
            "no target — pass --all, --groups <a,b>, or --pcs <pc1,pc2> (or use a Schedule for waves)"
        );
    }
    let plan = FanoutPlan {
        target,
        rollout: None,
        jitter: args.jitter,
    };

    info!(job_id = %args.job_id, "executing");
    let url = format!(
        "{}/api/exec/{}",
        backend_url.trim_end_matches('/'),
        args.job_id,
    );
    let resp = crate::http_client::authed_client()?
        .post(&url)
        .json(&plan)
        .send()
        .await
        .with_context(|| format!("POST {url}"))?;
    if !resp.status().is_success() {
        let status = resp.status();
        let body = resp.text().await.unwrap_or_default();
        anyhow::bail!("exec rejected: {status} — {body}");
    }
    let payload: ExecResponse = resp.json().await.context("decode exec response")?;

    println!("exec_id       : {}", payload.exec_id);
    println!("job_id        : {}", payload.job_id);
    println!("version       : {}", payload.version);
    println!("target_count  : {}", payload.target_count);
    println!("subjects      :");
    for s in &payload.subjects {
        println!("  - {s}");
    }
    Ok(())
}