kanade 0.4.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

use std::path::PathBuf;

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

#[derive(Args, Debug)]
pub struct DeployArgs {
    /// Path to the job YAML manifest (spec §2.4.1).
    pub yaml: PathBuf,
    /// Override the manifest's version (handy for hot-patches without editing the YAML).
    #[arg(long)]
    pub version: Option<String>,
}

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

pub async fn execute(backend_url: &str, args: DeployArgs) -> Result<()> {
    let yaml =
        std::fs::read_to_string(&args.yaml).with_context(|| format!("read {:?}", args.yaml))?;
    let mut manifest: Manifest =
        serde_yaml::from_str(&yaml).with_context(|| format!("parse {:?}", args.yaml))?;
    if let Some(v) = args.version {
        manifest.version = v;
    }
    info!(job_id = %manifest.id, version = %manifest.version, "deploying");

    let url = format!("{}/api/deploy", backend_url.trim_end_matches('/'));
    let client = crate::http_client::authed_client()?;
    let resp = client
        .post(&url)
        .json(&manifest)
        .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!("deploy rejected: {status} — {body}");
    }
    let payload: DeployResponse = resp.json().await.context("decode deploy response")?;

    println!("deploy_id     : {}", payload.deploy_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(())
}