kube32-sim

kube32-sim [options]kube32-sim -h | --help

kube32-sim is the Linux/macOS host build of Kube32, a Kubernetes-compatible control plane and WebAssembly pod runtime aimed at ESP32-S3 boards. The same sources flash to hardware; this binary runs nodes as ordinary host processes so kubectl and k9s can drive a cluster without a board.With no flags, one process is a standalone cluster: the API server on port 6443, a kubelet named esp32-node-01, and one in-process worker named esp32-node-02. Pods are wasm3 modules. Request-handler pods export k32 handle; entry-point pods export start, app main, or main. Pods whose k32 tick export returns greater than zero are ticked every 10 ms; others at 1 Hz, matching the boards.--role control-plane and --role worker split that into several processes (or a process plus a physical board). Workers join with --join or mDNS. Optional --tls serves HTTPS beside HTTP. --ingress-port turns on the Ingress controller.CMake builds the binary as `build/kube32-sim` from the host main source. OpenSSL 3 enables simulator TLS; without it --tls is unavailable.

--role standalone|control-plane|worker

Process role. Default standalone: one process runs the API server, its kubelet, and one in-process worker.

API server port. Default 6443.

Worker: API URL to register with. auto (and an omitted URL) uses mDNS.

API bearer token. Also read from the KUBE32-API-TOKEN environment variable.

Serve HTTPS on --port next to plain HTTP. Key and certificate are stored under `<data-dir>/kube32/tls/`.

Extra PEM roots that pods' `https://` calls trust, besides the host store. Control-plane and standalone roles.

Object store and node-storage root. Default `/tmp/kube32<node>data`. Firmware slots are files under this directory.

Persist the object-store journal as `<data-dir>/kube32/store/journal.img`.

Control-plane or standalone node name. Default esp32-master.

Kubelet name in standalone mode. Default esp32-node-01.

In-process worker names in standalone mode. Default esp32-node-02. Pass an empty string for none.

`kube32.io/board` label of this process's kubelet. Default generic.

Board label of in-process workers. Default cardputer.

Pod IP advertised to other nodes. Default 127.0.0.1. Use a LAN address so physical boards can reach simulator pods.

PSRAM pool to model (`8Mi`, `1284Ki`, …). 0 models a board without PSRAM. Default 1284Ki for control-plane/standalone, none for workers.

General heap for pods and the system when --psram 0. Default 51Ki.

Ingress HTTP port. Default off (`0`).

Pod HTTP server port on every node. Default 7000.

Node id for UDP IPC. Default 0.

UDP port for IPC. Default 7400 plus --node-id.

Static UDP IPC peer. Repeatable.

Node heartbeat interval. Default 5000.

Mark a node NotReady after this many milliseconds without a heartbeat. Default 15000.

Taint the node `unreachable:NoExecute` after this many milliseconds without a heartbeat. Default 30000.

Controller and scheduler loop interval. Default 1000.

Print options with defaults and exit 0.

KUBE32-API-TOKEN

Bearer token used when --token is omitted.

When set, the simulated microSD (node storage) is this directory. Otherwise --data-dir stands in for internal flash and card storage.

Unknown flags, or a flag missing its value, print usage on stderr and exit 2.The simulator is a 64-bit host build. wasm3 runtime structures are about 2.3 times larger than on the 32-bit ESP32-S3. A pod set that fits with --psram 0 fits on the board; the reverse is not guaranteed.This is not an instruction-level ESP32 emulator. Firmware still has to be built and flashed with PlatformIO / esptool. Use esp32sim for that kind of board model, and kube32-cli to compile, check, and ship Wasm pods.

kube32-cli(1), kubectl(1), k9s(1), cmake(1), pio(1), esptool(1), esp32sim(1)

Source code · Documentation