Skip to content

Runtime Cloud Profiles

This page documents the runtime-cloud portion of runtime.toml and the shipped example profile files under examples/runtime_cloud/.

Core Section

[runtime.cloud]
profile = "dev"

[runtime.cloud]

Key Type Required Notes
profile string yes dev, plant, or wan.

Accepted profiles:

Profile Meaning
dev local development / flexible local trust assumptions
plant secure plant-floor or site deployment
wan cross-site / federation mode with explicit write allowlists

WAN Allowlist Rules

Cross-site writes in wan mode are default-deny and must be allowlisted:

[runtime.cloud.wan]
allow_write = [
  { action = "cfg_apply", target = "site-b/*" }
]

[[runtime.cloud.wan.allow_write]]

Key Type Required Notes
action string yes e.g. cfg_apply
target string yes runtime or site selector

You can express preferred transports between runtimes:

[runtime.cloud.links]
transports = [
  { source = "runtime-a", target = "runtime-b", transport = "zenoh" }
]

[[runtime.cloud.links.transports]]

Key Type Required Notes
source string yes source runtime/resource id
target string yes destination runtime/resource id
transport string yes preferred transport for this pair

Allowed transport values:

Value Meaning
realtime low-latency shared-memory / realtime link
zenoh zenoh-based mesh
mesh generic mesh transport
mqtt MQTT broker path
modbus-tcp Modbus TCP path
opcua OPC UA path
discovery discovery/control path
web web/control proxy path

Shipped Example Profiles

The repository includes ready-to-read examples:

  • 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

Use the example pack when you want complete runnable files instead of overlay snippets.