0
0
# A local market on one machine
One kcp with its own PLC, relay, PDSes and a bidder, on one Linux machine; nothing touches prod. You need the binary
([README](../README.md#install)), `/dev/kvm`, a subordinate id range and a normal account (not root).
## Check the host
```sh
socialweb-computer check-host -role bidder -state-dir ~/.swc/demo
```
Every line `OK` (an `INFO` line is a note); a `FAIL` line names its fix. A home of mode `0701` passes but its VMs do
not boot; `0700` works.
## Start it
```sh
S=~/.swc/demo
socialweb-computer dev up --instance demo --profile market-network --host-backend proc --state-dir $S
socialweb-computer dev status --instance demo --state-dir $S | jq -r '.network.status.phase'
```
`Ready` after about 35 s. `--bidders N` adds bidders, `--with-gateway` a Kubernetes gateway, `--compute-kinds vm,deno`
Deno sandboxes.
## Request a VM in it
```sh
socialweb-computer run request --network demo --state-dir $S --name vm1 --exec -- id
```
You see `uid=0(root) gid=0(root) groups=0(root)`; the VM is released when the command ends.
## Hold, ssh, release
```sh
socialweb-computer run request --network demo --state-dir $S --name vm2 --hold --exec -- uname -m
```
```sh
socialweb-computer run request ssh vm2 --state-dir $S
```
```sh
socialweb-computer run request list --state-dir $S
socialweb-computer run request release vm2 --state-dir $S
```
`list` shows `vm2 ... Held`, then `release` ends it (`"phase": "Released"`).
## kubectl: a requester that stays up
From a clone of this repo (`examples/infra/`). In one terminal:
```sh
socialweb-computer run requester --name qs --network demo --state-dir $S
```
In another (`S=~/.swc/demo` again):
```sh
eval "$(socialweb-computer run requester env qs --state-dir $S)"
sed "s|ssh-ed25519 AAAAREPLACE-WITH-YOUR-PUBLIC-KEY you@laptop|$(cat "$(jq -r .sshPublicKey $S/requesters/qs/ready.json)")|" \
examples/infra/vm.yaml | kubectl apply -f -
kubectl wait infras.socialweb.computer/quickstart-vm --for=jsonpath='{.status.phase}'=Deployed --timeout=5m
socialweb-computer run requester ssh qs --state-dir $S --contract infra-quickstart-vm-vm1 --exec -- cat /root/quickstart
```
You see `quickstart-vm-ok`. Release it, then Ctrl-C the requester (it keeps its state):
```sh
kubectl delete infras.socialweb.computer quickstart-vm
```
## Stop it
```sh
socialweb-computer dev down --instance demo --state-dir $S
```
It releases every VM and removes `$S/dev/demo`.
## Tenant clusters, Deno, agents
A tenant Kubernetes cluster (`--with-gateway`), a Deno sandbox (`--compute-kinds vm,deno`), `EphemeralInfra` and an
agent VM: [acceptance/0012](acceptance/0012-infra-quickstart.md) and [../examples/infra/](../examples/infra/). The
network itself: [../deploy/market-network/README.md](../deploy/market-network/README.md).