# upgrade

**Repository Path**: rippleos/upgrade

## Basic Information

- **Project Name**: upgrade
- **Description**: MOSS 远程升级管理
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-12
- **Last Updated**: 2026-05-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# mupgrade

MOSS Remote Management CLI - SSH-based node control, upgrade, and monitoring for automotive middleware.

## Features

- **Node Management**: Start, stop, restart nodes with cascade dependency handling
- **Upgrade Management**: Atomic upgrade with automatic rollback on failure
- **Log Streaming**: Real-time log viewing with filtering
- **Config Management**: Remote configuration read/write with permission control
- **System Monitoring**: CPU, memory, disk, load average monitoring

## Security Model

| Permission Level | Linux User/Group | Capabilities |
|-----------------|------------------|--------------|
| READONLY | Any SSH user | View status, logs, config |
| OPERATOR | `mupgrade` group | + Node start/stop/restart |
| ADMIN | `root` | + Upgrade, rollback, critical config |

## Build

```bash
mkdir build && cd build
cmake .. -DCMAKE_PREFIX_PATH="/path/to/log/build"
make -j$(nproc)
```

## Usage

```bash
# Node management
mupgrade node.list
mupgrade node.start perception
mupgrade node.stop planning --no-cascade
mupgrade node.restart control

# Upgrade
mupgrade upgrade.start perception /tmp/perception_v2.pkg --sha256 abc123
mupgrade upgrade.progress perception
mupgrade upgrade.rollback perception

# Logs
mupgrade log.get --level warn --tail 100
mupgrade log.stream --node perception

# Config
mupgrade config.get system.domain_id
mupgrade config.set log.level debug

# System
mupgrade system.status
mupgrade system.top
mupgrade system.degrade    # Enter critical-only mode
```

## Architecture

```
┌─────────────────────────────────────────┐
│           SSH Layer (sshd)              │
│         (Authentication by OS)          │
└─────────────────────────────────────────┘
                    │
                    ▼
┌─────────────────────────────────────────┐
│           mupgrade CLI                   │
└─────────────────────────────────────────┘
                    │
                    ▼
┌─────────────────────────────────────────┐
│           RemoteAgent                    │
│  (Permission check, audit, dispatch)    │
└──────┬─────────┬─────────┬──────────────┘
       │         │         │
       ▼         ▼         ▼
┌──────────┐┌──────────┐┌──────────┐
│NodeCtrl  ││LogStream ││ConfigProx│
└──────────┘└──────────┘└──────────┘
       │         │         │
       ▼         ▼         ▼
┌──────────┐┌──────────┐┌──────────┐
│  mexem   ││   mlog   ││config_srv│
└──────────┘└──────────┘└──────────┘
```

## Dependencies

- mlog (MOSS logging library)
- mexem (optional, for node orchestration)
- C++17 compiler
- CMake 3.14+

## License

MIT