initial commit

Signed-off-by: Kevin Hoffman <[email protected]>

.gitignore

@@ -0,0 +1 @@
+.task

README.md

@@ -0,0 +1,9 @@
+# NATS Execution Engine
+Turn your NATS infrastructure into a distributed workload deployment and execution engine.
+
+* [nex-agent](./nex-agent) - Agent that runs inside a Firecracker VM, responsible for running untrusted workloads. Not something end users need to interact with.
+* [nex-node](./nex-node) - Service running on a NEX node. Exposes a control API, starts/tops firecracker processes, communicates within the agent inside each process.
+* [control-api](./control-api/) - The API for communicating with and remotely controlling NEX nodes
+* [nex-cli](./nex-cli) - CLI for communicating with NEX nodes
+* [fc-image](./fc-image/) - Tools for building the rootfs (ext4) file system for use in firecracker VMs
+* [agent-api](./agent-api/) - Protobuf API specification for protocol used between `nex-node` and `nex-agent` across the firecracker boundary. Also contains a client for communicating with an agent. This is an internal API unlikely to be of interest to users.

Taskfile.yml

@@ -0,0 +1,22 @@
+# https://taskfile.dev
+# to install `go install github.com/go-task/task/v3/cmd/task@latest`
+
+version: "3"
+
+interval: 200ms
+
+vars:
+  NAME: "nex"
+
+tasks:
+  agent-api:
+    dir: agent-api
+    sources:
+      - "*.proto"
+    generates:
+      - "*.pb.go"
+    cmds:
+      - protoc --proto_path=./ --go_out=./ --go_opt=paths=source_relative --go-grpc_out=./ --go-grpc_opt=paths=source_relative ./*.proto
+
+  gen:
+    deps: [agent-api]

agent-api/README.md

@@ -0,0 +1,4 @@
+# Agent API
+This is the API used for communication between the agent (process running inside the firecracker VM) and the host (`nex-node`). This API contains operations to subscribe to logs and events, as well as health query and, of course, a function to start and run a workload.
+
+Most of this package is generated from protobufs, but there is also a client that can be used to communicate with `nex-agent`s.