rustfs-cli 0.1.30

A Rust S3 CLI client for S3-compatible object storage
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
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118

#![cfg(not(windows))]

mod admin_support;

use std::process::Command;
use std::time::Duration;

use admin_support::{rc_binary, rc_host_alias, start_admin_test_server};

fn run_service_action(action: &str, response_body: &'static str) -> (serde_json::Value, String) {
    let config_dir = tempfile::tempdir().expect("create config dir");
    let (endpoint, receiver, handle) = start_admin_test_server(response_body);

    let output = Command::new(rc_binary())
        .args(["--json", "admin", "service", action, "myalias"])
        .env("RC_CONFIG_DIR", config_dir.path())
        .env("RC_HOST_myalias", rc_host_alias(&endpoint))
        .output()
        .expect("run rc command");

    assert!(
        output.status.success(),
        "stderr: {}",
        String::from_utf8_lossy(&output.stderr)
    );

    let stdout = String::from_utf8(output.stdout).expect("stdout should be UTF-8");
    let payload: serde_json::Value = serde_json::from_str(&stdout).expect("JSON output");

    let request = receiver
        .recv_timeout(Duration::from_secs(5))
        .expect("captured admin request");
    assert_eq!(request.method, "POST");
    handle.join().expect("admin test server finished");

    (payload, request.target)
}

#[test]
fn service_stop_dispatches_to_service_action_stop() {
    let (payload, target) = run_service_action(
        "stop",
        r#"{"action":"stop","accepted":true,"effective":true,"message":"graceful shutdown initiated"}"#,
    );

    assert_eq!(target, "/rustfs/admin/v3/service?action=stop");
    assert_eq!(payload["action"], "stop");
    assert_eq!(payload["accepted"], true);
    assert_eq!(payload["effective"], true);
    assert_eq!(payload["message"], "graceful shutdown initiated");
}

#[test]
fn service_restart_dispatches_to_service_action_restart() {
    let (payload, target) = run_service_action(
        "restart",
        r#"{"action":"restart","accepted":true,"effective":true,"message":"graceful shutdown initiated; the supervising process manager is responsible for relaunch"}"#,
    );

    assert_eq!(target, "/rustfs/admin/v3/service?action=restart");
    assert_eq!(payload["action"], "restart");
    assert_eq!(payload["accepted"], true);
}

#[test]
fn service_freeze_reports_advisory_effectiveness() {
    let (payload, target) = run_service_action(
        "freeze",
        r#"{"action":"freeze","accepted":true,"effective":false,"message":"freeze flag recorded, but RustFS does not yet gate request admission on it (advisory only)"}"#,
    );

    assert_eq!(target, "/rustfs/admin/v3/service?action=freeze");
    assert_eq!(payload["accepted"], true);
    assert_eq!(payload["effective"], false);
}

#[test]
fn service_unfreeze_dispatches_to_service_action_unfreeze() {
    let (payload, target) = run_service_action(
        "unfreeze",
        r#"{"action":"unfreeze","accepted":true,"effective":false,"message":"freeze flag cleared (advisory only)"}"#,
    );

    assert_eq!(target, "/rustfs/admin/v3/service?action=unfreeze");
    assert_eq!(payload["action"], "unfreeze");
}

#[test]
fn service_stop_human_output_reports_success() {
    let config_dir = tempfile::tempdir().expect("create config dir");
    let (endpoint, receiver, handle) = start_admin_test_server(
        r#"{"action":"stop","accepted":true,"effective":true,"message":"graceful shutdown initiated"}"#,
    );

    let output = Command::new(rc_binary())
        .args(["admin", "service", "stop", "myalias"])
        .env("RC_CONFIG_DIR", config_dir.path())
        .env("RC_HOST_myalias", rc_host_alias(&endpoint))
        .output()
        .expect("run rc command");

    assert!(
        output.status.success(),
        "stderr: {}",
        String::from_utf8_lossy(&output.stderr)
    );

    let stdout = String::from_utf8(output.stdout).expect("stdout should be UTF-8");
    assert!(
        stdout.contains("graceful shutdown initiated"),
        "stdout: {stdout}"
    );

    receiver
        .recv_timeout(Duration::from_secs(5))
        .expect("captured admin request");
    handle.join().expect("admin test server finished");
}