kedge/docs/underlay-mode.md
Tyler King 6058e62348 Initial commit: Kedge network automation platform
Go-based network automation with YANG models, gRPC, Ansible,
Terraform, and Kubernetes integration.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-26 12:09:30 -05:00

623 B

Underlay Mode

Programs the actual physical network fabric via vendor SDK dispatch through Bascule. Used for sites where you own the infrastructure.

Components

  • VLAN interface manager (internal/vlan/)
  • YANG watcher and compilation trigger (internal/underlay/)
  • YANG compiler (yang/compiler/)
  • NetworkMutationArtifact notarization (internal/quartermaster/)

YANG Pipeline

  1. YANG instance data changes (ConfigMap/CRD)
  2. Watcher triggers compilation
  3. Compiler produces vendor-specific payloads (FortiOS, VyOS, UniFi)
  4. Payloads dispatched via Bascule SDK
  5. Each mutation notarized via Quartermaster