monocore 0.2.1

`monocore` is a secure MicroVM provisioning system for running untrusted code in isolated environments.
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
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143

use std::path::PathBuf;

use clap::Parser;
use tracing::Level;

use crate::config::{DEFAULT_MONOCORE_HOME, DEFAULT_SERVER_PORT};

use super::styles;

//-------------------------------------------------------------------------------------------------
// Types
//-------------------------------------------------------------------------------------------------

/// Monocore CLI - A lightweight orchestrator for running containers in microVMs
#[derive(Debug, Parser)]
#[command(name = "monocore", author, about, version, styles=styles::styles())]
pub struct MonocoreArgs {
    /// The subcommand to run
    #[command(subcommand)]
    pub subcommand: Option<MonocoreSubcommand>,

    /// Enable verbose logging
    #[arg(short, long)]
    pub verbose: bool,
}

/// Available subcommands for managing services
#[derive(Debug, Parser)]
pub enum MonocoreSubcommand {
    /// Start services defined in config file. If group specified, only starts services in that group
    #[command(arg_required_else_help = true)]
    Up {
        /// Config file path (default: monocore.toml)
        #[arg(short, long, default_value = "monocore.toml")]
        file: PathBuf,

        /// Only start services in this group
        #[arg(short, long)]
        group: Option<String>,

        /// Home directory for monocore state (default: ~/.monocore)
        #[arg(long, default_value = DEFAULT_MONOCORE_HOME.as_os_str())]
        home_dir: PathBuf,
    },

    /// Stop running services. If group specified, only stops services in that group
    Down {
        /// Config file path
        #[arg(short, long)]
        file: Option<PathBuf>,

        /// Only stop services in this group
        #[arg(short, long)]
        group: Option<String>,

        /// Home directory for monocore state (default: ~/.monocore)
        #[arg(long, default_value = DEFAULT_MONOCORE_HOME.as_os_str())]
        home_dir: PathBuf,
    },

    /// Pull container image from the Docker registry
    #[command(arg_required_else_help = true)]
    Pull {
        /// Image reference (e.g. 'alpine:latest')
        #[arg(required = true)]
        image: String,

        /// Home directory for monocore state (default: ~/.monocore)
        #[arg(long, default_value = DEFAULT_MONOCORE_HOME.as_os_str())]
        home_dir: PathBuf,
    },

    /// Show status of running services (CPU, memory, network, etc)
    Status {},

    /// Display service logs
    #[command(arg_required_else_help = true)]
    Log {
        /// Name of the service to show logs for
        #[arg(required = true)]
        service: String,

        /// Number of lines to show (from the end)
        #[arg(short = 'n')]
        lines: Option<usize>,

        /// Disable pager and print directly to stdout
        #[arg(long)]
        no_pager: bool,

        /// Follow log output (like tail -f)
        #[arg(short = 'f', long)]
        follow: bool,

        /// Home directory for monocore state (default: ~/.monocore)
        #[arg(long, default_value = DEFAULT_MONOCORE_HOME.as_os_str())]
        home_dir: PathBuf,
    },

    /// Remove service files (rootfs and config)
    #[command(alias = "rm", arg_required_else_help = true)]
    Remove {
        /// Names of services to remove
        #[arg(required_unless_present = "group")]
        services: Vec<String>,

        /// Remove all services in this group
        #[arg(short, long)]
        group: Option<String>,

        /// Home directory for monocore state (default: ~/.monocore)
        #[arg(long, default_value = DEFAULT_MONOCORE_HOME.as_os_str())]
        home_dir: PathBuf,
    },

    /// Start monocore in server mode
    Serve {
        /// Port to listen on
        #[arg(short, long, default_value_t = std::env::var("PORT").unwrap_or(DEFAULT_SERVER_PORT.to_string()).parse().unwrap())]
        port: u16,

        /// Home directory for monocore state (default: ~/.monocore)
        #[arg(long, default_value = DEFAULT_MONOCORE_HOME.as_os_str())]
        home_dir: PathBuf,
    },
}

//-------------------------------------------------------------------------------------------------
// Methods
//-------------------------------------------------------------------------------------------------

impl MonocoreArgs {
    /// Initialize logging system with INFO or DEBUG level based on verbose flag
    pub fn init_logging(&self) {
        let level = if self.verbose {
            Level::DEBUG
        } else {
            Level::INFO
        };

        tracing_subscriber::fmt().with_max_level(level).init();
    }
}