pptx704
7753938044
Implements Phase 1: boot a Firecracker microVM, execute a command inside it via envd, and get the output back. Uses raw Firecracker HTTP API via Unix socket (not the Go SDK) for full control over the VM lifecycle. - internal/vm: VM manager with create/pause/resume/destroy, Firecracker HTTP client, process launcher with unshare + ip netns exec isolation - internal/network: per-sandbox network namespace with veth pair, TAP device, NAT rules, and IP forwarding - internal/envdclient: Connect RPC client for envd process/filesystem services with health check retry - cmd/host-agent: demo binary that boots a VM, runs "echo hello", prints output, and cleans up - proto/envd: canonical proto files with buf + protoc-gen-connect-go code generation - images/wrenn-init.sh: minimal PID 1 init script for guest VMs - CLAUDE.md: updated architecture to reflect TAP networking (not vsock) and Firecracker HTTP API (not Go SDK)
136 lines
2.5 KiB
Protocol Buffer
136 lines
2.5 KiB
Protocol Buffer
syntax = "proto3";
|
|
|
|
package filesystem;
|
|
|
|
import "google/protobuf/timestamp.proto";
|
|
|
|
service Filesystem {
|
|
rpc Stat(StatRequest) returns (StatResponse);
|
|
rpc MakeDir(MakeDirRequest) returns (MakeDirResponse);
|
|
rpc Move(MoveRequest) returns (MoveResponse);
|
|
rpc ListDir(ListDirRequest) returns (ListDirResponse);
|
|
rpc Remove(RemoveRequest) returns (RemoveResponse);
|
|
|
|
rpc WatchDir(WatchDirRequest) returns (stream WatchDirResponse);
|
|
|
|
// Non-streaming versions of WatchDir
|
|
rpc CreateWatcher(CreateWatcherRequest) returns (CreateWatcherResponse);
|
|
rpc GetWatcherEvents(GetWatcherEventsRequest) returns (GetWatcherEventsResponse);
|
|
rpc RemoveWatcher(RemoveWatcherRequest) returns (RemoveWatcherResponse);
|
|
}
|
|
|
|
message MoveRequest {
|
|
string source = 1;
|
|
string destination = 2;
|
|
}
|
|
|
|
message MoveResponse {
|
|
EntryInfo entry = 1;
|
|
}
|
|
|
|
message MakeDirRequest {
|
|
string path = 1;
|
|
}
|
|
|
|
message MakeDirResponse {
|
|
EntryInfo entry = 1;
|
|
}
|
|
|
|
message RemoveRequest {
|
|
string path = 1;
|
|
}
|
|
|
|
message RemoveResponse {}
|
|
|
|
message StatRequest {
|
|
string path = 1;
|
|
}
|
|
|
|
message StatResponse {
|
|
EntryInfo entry = 1;
|
|
}
|
|
|
|
message EntryInfo {
|
|
string name = 1;
|
|
FileType type = 2;
|
|
string path = 3;
|
|
int64 size = 4;
|
|
uint32 mode = 5;
|
|
string permissions = 6;
|
|
string owner = 7;
|
|
string group = 8;
|
|
google.protobuf.Timestamp modified_time = 9;
|
|
// If the entry is a symlink, this field contains the target of the symlink.
|
|
optional string symlink_target = 10;
|
|
}
|
|
|
|
enum FileType {
|
|
FILE_TYPE_UNSPECIFIED = 0;
|
|
FILE_TYPE_FILE = 1;
|
|
FILE_TYPE_DIRECTORY = 2;
|
|
FILE_TYPE_SYMLINK = 3;
|
|
}
|
|
|
|
message ListDirRequest {
|
|
string path = 1;
|
|
uint32 depth = 2;
|
|
}
|
|
|
|
message ListDirResponse {
|
|
repeated EntryInfo entries = 1;
|
|
}
|
|
|
|
message WatchDirRequest {
|
|
string path = 1;
|
|
bool recursive = 2;
|
|
}
|
|
|
|
message FilesystemEvent {
|
|
string name = 1;
|
|
EventType type = 2;
|
|
}
|
|
|
|
message WatchDirResponse {
|
|
oneof event {
|
|
StartEvent start = 1;
|
|
FilesystemEvent filesystem = 2;
|
|
KeepAlive keepalive = 3;
|
|
}
|
|
|
|
message StartEvent {}
|
|
|
|
message KeepAlive {}
|
|
}
|
|
|
|
message CreateWatcherRequest {
|
|
string path = 1;
|
|
bool recursive = 2;
|
|
}
|
|
|
|
message CreateWatcherResponse {
|
|
string watcher_id = 1;
|
|
}
|
|
|
|
message GetWatcherEventsRequest {
|
|
string watcher_id = 1;
|
|
}
|
|
|
|
message GetWatcherEventsResponse {
|
|
repeated FilesystemEvent events = 1;
|
|
}
|
|
|
|
message RemoveWatcherRequest {
|
|
string watcher_id = 1;
|
|
}
|
|
|
|
message RemoveWatcherResponse {}
|
|
|
|
enum EventType {
|
|
EVENT_TYPE_UNSPECIFIED = 0;
|
|
EVENT_TYPE_CREATE = 1;
|
|
EVENT_TYPE_WRITE = 2;
|
|
EVENT_TYPE_REMOVE = 3;
|
|
EVENT_TYPE_RENAME = 4;
|
|
EVENT_TYPE_CHMOD = 5;
|
|
}
|