Menu
edgion-cli CLI tool architecture — three target modes, subcommands, output formats, HTTP client.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Conventions shared by the in-repo binaries (edgion-controller, edgion-gateway, edgion-cli) — project overview, command line / directory / config-path conventions, Core layering conventions, resource system.
KubernetesCenter implementation — K8s Reflector watching, leader election, HA mode, ResourceController lifecycle, status writeback.
ConfigCenter subsystem — ConfCenter trait abstraction, FileSystemCenter and KubernetesCenter implementations, unified Workqueue + ResourceProcessor pipeline.
edgion-controller control plane architecture — overall design, startup/shutdown, Admin API, ConfigCenter, Workqueue, ResourceProcessor, Requeue, CacheServer, ACME service.
Route matching overview — multi-stage pipeline (Listener→Domain→Path→DeepMatch), per-listener isolation, registration flow, atomic swap.
TLS subsystem overview — TLS Store, SNI matching, certificate management, BoringSSL/OpenSSL backend selection.
| name | ctl-architecture |
| description | edgion-cli CLI tool architecture — three target modes, subcommands, output formats, HTTP client. |
edgion-cli is Edgion's command-line management tool, interacting with Controller/Gateway via HTTP API. Supports three target modes; can compare the three-tier center/server/client cache for sync troubleshooting.
| File | Topic | Recommended reading scenario |
|---|---|---|
| 00-overview.md | Overview + target modes + API routes | Understanding ctl design and debugging methods |
| 01-commands.md | Subcommand details | Using/extending ctl commands |
# View all HTTPRoutes in center (ConfCenter API)
edgion-cli get httproute
# View HTTPRoutes in server (Controller cache)
edgion-cli -t server get httproute
# View HTTPRoutes in client (Gateway cache)
edgion-cli -t client get httproute
# Compare center and client to troubleshoot sync issues
edgion-cli get httproute -o json > center.json
edgion-cli -t client get httproute -o json > client.json
diff center.json client.json
# Apply configuration
edgion-cli apply -f config.yaml
edgion-cli apply -f config-dir/
# Reload all resources
edgion-cli reload
# Generate conf_sync gRPC mTLS certificates
edgion-cli gen-certs --output file --output-dir certs/grpc/