mirror of
https://github.com/compute-blade-community/compute-blade-agent.git
synced 2026-04-16 15:35:42 +02:00
781ded8e43
This PR introduces a comprehensive set of new subcommands to bladectl, expanding its capabilities for querying and managing compute blade state. It also includes an internal refactor to simplify interface management across the gRPC API.
* `get`
* `fan`: Returns current fan speed.
* `identify`: Indicates whether the identify mode is active.
* `stealth`: Shows if stealth mode is currently enabled.
* `status`: Prints a full blade status report.
* `temperature`: Retrieves current SoC temperature.
* `critical`: Shows whether critical mode is active.
* `power`: Reports the current power source (e.g., PoE+ or USB).
* `set`
* `stealth`: Enables stealth mode.
* `remove`
* `stealth`: Disables stealth mode.
* `describe`
* `fan`: Outputs the current fan curve configuration.
* `monitor`: plot some charts about the state of the compute-blade-agent
* **gRPC API refactor**: The gRPC service definitions previously located in `internal/api` have been folded into `internal/agent`. This eliminates redundant interface declarations and ensures that all ComputeBladeAgent implementations are directly compatible with the gRPC API.
This reduces duplication and improves long-term maintainability and clarity of the interface contract.
```bash
bladectl set fan --percent 90 --blade 1 --blade 2
bladectl unset identify --blade 1 --blade 2 --blade 3 --blade 4
bladectl set stealth --blade 1 --blade 2 --blade 3 --blade 4
bladectl get status --blade 1 --blade 2 --blade 3 --blade 4
┌───────┬─────────────┬────────────────────┬───────────────┬──────────────┬──────────┬───────────────┬──────────────┐
│ BLADE │ TEMPERATURE │ FAN SPEED OVERRIDE │ FAN SPEED │ STEALTH MODE │ IDENTIFY │ CRITICAL MODE │ POWER STATUS │
├───────┼─────────────┼────────────────────┼───────────────┼──────────────┼──────────┼───────────────┼──────────────┤
│ 1 │ 50°C │ 90% │ 5825 RPM(90%) │ Active │ Off │ Off │ poe+ │
│ 2 │ 48°C │ 90% │ 5825 RPM(90%) │ Active │ Off │ Off │ poe+ │
│ 3 │ 49°C │ Not set │ 4643 RPM(56%) │ Active │ Off │ Off │ poe+ │
│ 4 │ 49°C │ Not set │ 4774 RPM(58%) │ Active │ Off │ Off │ poe+ │
└───────┴─────────────┴────────────────────┴───────────────┴──────────────┴──────────┴───────────────┴──────────────┘
bladectl rm stealth --blade 1 --blade 2 --blade 3 --blade 4
bladectl rm fan --blade 1 --blade 2 --blade 3 --blade 4
bladectl get status --blade 1 --blade 2 --blade 3 --blade 4
┌───────┬─────────────┬────────────────────┬───────────────┬──────────────┬──────────┬───────────────┬──────────────┐
│ BLADE │ TEMPERATURE │ FAN SPEED OVERRIDE │ FAN SPEED │ STEALTH MODE │ IDENTIFY │ CRITICAL MODE │ POWER STATUS │
├───────┼─────────────┼────────────────────┼───────────────┼──────────────┼──────────┼───────────────┼──────────────┤
│ 1 │ 51°C │ Not set │ 5177 RPM(66%) │ Off │ Off │ Off │ poe+ │
│ 2 │ 49°C │ Not set │ 5177 RPM(58%) │ Off │ Off │ Off │ poe+ │
│ 3 │ 50°C │ Not set │ 4659 RPM(60%) │ Off │ Off │ Off │ poe+ │
│ 4 │ 48°C │ Not set │ 4659 RPM(54%) │ Off │ Off │ Off │ poe+ │
└───────┴─────────────┴────────────────────┴───────────────┴──────────────┴──────────┴───────────────┴──────────────┘
```
when having multiple compute-blades in your bladeconfig:
```yaml
blades:
- name: 1
blade:
server: blade-pi1:8081
cert:
certificate-authority-data: <redacted>
client-certificate-data: <redacted>
client-key-data: <redacted>
- name: 2
blade:
server: blade-pi2:8081
cert:
certificate-authority-data: <redacted>
client-certificate-data: <redacted>
client-key-data: <redacted>
- name: 3
blade:
server: blade-pi3:8081
cert:
certificate-authority-data: <redacted>
client-certificate-data: <redacted>
client-key-data: <redacted>
- name: 4
blade:
server: blade-pi4:8081
cert:
certificate-authority-data: <redacted>
client-certificate-data: <redacted>
client-key-data: <redacted>
- name: 4
blade:
server: blade-pi4:8081
cert:
certificate-authority-data: <redacted>
client-certificate-data: <redacted>
client-key-data: <redacted>
current-blade: 1
```
Fixes #4, #9 (partially), should help with #5
* test: improve unit-testing
* fix: pin github.com/warthog618/gpiod
---------
Co-authored-by: Cedric Kienzler <cedric@specht-labs.de>
79 lines
1.9 KiB
Protocol Buffer
79 lines
1.9 KiB
Protocol Buffer
syntax = "proto3";
|
|
|
|
import "google/protobuf/empty.proto";
|
|
package api.bladeapi.v1alpha1;
|
|
|
|
option go_package = "github.com/uptime-induestries/compute-blade-agent/api/blade/v1alpha1;bladeapiv1alpha1";
|
|
|
|
// Event is an event the agent reacts to
|
|
enum Event {
|
|
IDENTIFY = 0;
|
|
IDENTIFY_CONFIRM = 1;
|
|
CRITICAL = 2;
|
|
CRITICAL_RESET = 3;
|
|
}
|
|
|
|
// FanUnit defines the fan unit detected by the blade
|
|
enum FanUnit {
|
|
DEFAULT = 0;
|
|
SMART = 1;
|
|
}
|
|
|
|
// PowerStatus defines the power status of the blade
|
|
enum PowerStatus {
|
|
POE_OR_USBC = 0;
|
|
POE_802_AT = 1;
|
|
}
|
|
|
|
message StealthModeRequest {
|
|
bool enable = 1;
|
|
}
|
|
|
|
message SetFanSpeedRequest {
|
|
int64 percent = 1;
|
|
}
|
|
|
|
message EmitEventRequest {
|
|
Event event = 1;
|
|
}
|
|
|
|
message FanCurveStep {
|
|
int64 temperature = 1;
|
|
uint32 percent = 2;
|
|
}
|
|
|
|
message StatusResponse {
|
|
bool stealth_mode = 1;
|
|
bool identify_active = 2;
|
|
bool critical_active = 3;
|
|
int64 temperature = 4;
|
|
int64 fan_rpm = 5;
|
|
PowerStatus power_status = 6;
|
|
uint32 fan_percent = 7;
|
|
bool fan_speed_automatic = 8;
|
|
int64 critical_temperature_threshold = 9;
|
|
repeated FanCurveStep fan_curve_steps = 10;
|
|
}
|
|
|
|
service BladeAgentService {
|
|
// EmitEvent emits an event to the blade
|
|
rpc EmitEvent(EmitEventRequest) returns (google.protobuf.Empty) {}
|
|
|
|
// WaitForIdentifyConfirm blocks until the blades button is pressed
|
|
rpc WaitForIdentifyConfirm(google.protobuf.Empty) returns (google.protobuf.Empty) {}
|
|
|
|
// Sets the fan speed to a specific value.
|
|
rpc SetFanSpeed(SetFanSpeedRequest) returns (google.protobuf.Empty) {}
|
|
|
|
// Sets the fan speed to automatic mode.
|
|
//
|
|
// Internally, this is equivalent to calling SetFanSpeed with a nil/empty value.
|
|
rpc SetFanSpeedAuto(google.protobuf.Empty) returns (google.protobuf.Empty) {}
|
|
|
|
// Sets the blade to stealth mode (disables all LEDs)
|
|
rpc SetStealthMode(StealthModeRequest) returns (google.protobuf.Empty) {}
|
|
|
|
// Gets the current status of the blade
|
|
rpc GetStatus(google.protobuf.Empty) returns (StatusResponse) {}
|
|
}
|