Margo Overview

logiccloud orchestrate is built around Margo, an open specification for managing workloads on fleets of edge devices in industrial automation. Margo defines how a device onboards, reports what it can run, learns what it should be running, and reports back how that’s going.

Who this is for: OT engineers and integrators connecting devices to logiccloud orchestrate.

How a device talks to logiccloud orchestrate

Devices communicate with the SBI Gateway (the Southbound Interface) using the Margo Workload Management API. logiccloud orchestrate implements that API to the letter so that any Margo-compliant device interoperates without custom glue.

logiccloud orchestrate implements Margo version 1.0.0-rc2 (Workload Management API 1.0.0). Devices must use that version of the specification. Later Margo releases change parts of the device API; this guide describes rc2 only.

The device-side lifecycle has four stages:

1. Onboarding — the device registers and receives its client identity.
2. Capability reporting — the device tells the platform what hardware and interfaces it has.
3. Desired state — the platform tells the device which applications it should run.
4. Deployment status — the device reports the progress of each deployment back to the platform.

See Constraints & Interoperability for the rules the platform enforces to stay Margo-compliant.

Key facts

• Authentication uses RFC 9421 HTTP Message Signatures — there is no mutual TLS (mTLS) requirement.
• Manifests are JSON, identified by content-addressable sha256: digests.
• Only two deployment profiles are supported: helm and compose.
• Application deployment YAML uses the API group application.margo.org/v1alpha1.