Edgelet node management
Prerequisite: ECN with Edgelet nodes
You need a working Edge Compute Network (ECN) with provisioned Edgelet nodes. If you have not deployed nodes yet, start with Platform Deployment and Setup Edgelet Nodes.
Once Edgelet nodes are registered with the Controller, you run day-to-day operations from the orchestrator with potctl. In YAML the resource kind is still Agent; in prose we say Edgelet node.
This section covers fleet operations. For how the Edgelet daemon works on the device, see Edgelet.
What you can manage
| Topic | Page | Typical command |
|---|---|---|
| Runtime settings pushed from Controller | Configuration updates | potctl deploy -f agent-config.yaml |
| Move nodes between ECNs or namespaces | Attach and detach | potctl detach agent, potctl attach agent, potctl move agent |
| Push host directories to nodes | Volume distribution | potctl deploy -f volume.yaml |
| Reclaim disk on nodes | Image and disk pruning | potctl prune agent |
| Fleet Edgelet version changes | Upgrade and rollback | potctl upgrade agent, potctl rollback agent |
| Router/NATS platform on a node | Reconcile platform | potctl reconcile agent |
Orchestrator vs on-device changes
| Layer | Tool | Use when |
|---|---|---|
| Controller push | potctl + AgentConfig | Fleet-wide config from the control plane |
| On-device | edgelet config, edgelet provision | Break-glass or air-gapped node admin |
See Edgelet configuration and Configuration reference for on-device keys.
See also
- YAML Reference: Agent —
Agent,AgentConfig, andspec.configfields - potctl Getting Familiar — namespaces,
get,describe,logs - Edgelet installation — manual install and OTA on the host
See anything wrong with the document? Help us improve it!