Skip to content

Runtime Cloud

Example Pack

Runtime Cloud Examples

Docs category: docs/public/examples/runtime-cloud.md

This example pack supports the runtime cloud guides in docs/guides/.

Included Files

Runtime profile configs: - examples/runtime_cloud/runtime-a-dev.toml - examples/runtime_cloud/runtime-b-dev.toml - examples/runtime_cloud/runtime-plant.toml - examples/runtime_cloud/runtime-wan.toml - examples/runtime_cloud/multi_host_topology_demo/ (5-runtime topology demo pack)

Dispatch/preflight payloads: - examples/runtime_cloud/dispatch-status-read.json - examples/runtime_cloud/dispatch-cmd-invoke-restart.json - examples/runtime_cloud/dispatch-ha-cmd-seq.json - examples/runtime_cloud/preflight-cross-site-deny.json - examples/runtime_cloud/preflight-cross-site-allow.json - examples/runtime_cloud/rollout-create.json

Typical Usage

Use these files with: - docs/guides/RUNTIME_CLOUD_QUICKSTART.md - docs/guides/RUNTIME_CLOUD_PROFILE_COOKBOOK.md - docs/guides/RUNTIME_CLOUD_FEDERATION_GUIDE.md - docs/guides/RUNTIME_CLOUD_UI_WALKTHROUGH.md - docs/guides/RUNTIME_CLOUD_TROUBLESHOOTING.md

For a richer local topology visual demo (5 runtimes + explicit mesh links + mixed protocols + preloaded hosts/devices/transport preferences):

cd examples/runtime_cloud/multi_host_topology_demo
./start-5.sh ~/trust-cloud-topology-demo

start-5.sh auto-bootstraps missing projects. Use TRUST_TOPOLOGY_DEMO_REFRESH=1 to force a full refresh of demo files.

Example preflight command:

curl -s http://127.0.0.1:18081/api/runtime-cloud/actions/preflight \
  -H 'content-type: application/json' \
  -d @examples/runtime_cloud/dispatch-status-read.json | jq

Example rollout command:

curl -s http://127.0.0.1:18081/api/runtime-cloud/rollouts \
  -H 'content-type: application/json' \
  -d @examples/runtime_cloud/rollout-create.json | jq

Notes

  • Replace placeholder tokens/cert paths in runtime-plant.toml and runtime-wan.toml before production use.
  • runtime-wan.toml ships with sample allowlist rules; tighten these per site and action.
  • Mesh examples pin runtime.mesh.zenohd_version = "1.7.2" and include explicit runtime.mesh.role/connect/plugin_versions keys to match the runtime-cloud baseline policy.