Generate and visualize OVN-Kubernetes network topology diagram
Generates Mermaid diagrams of OVN-Kubernetes network topology from live cluster data.
/plugin marketplace add openshift-eng/ai-helpers/plugin install openshift@ai-helpersopenshift:visualize-ovn-topology
/openshift:visualize-ovn-topology
The openshift:visualize-ovn-topology command generates a comprehensive Mermaid diagram of the OVN-Kubernetes network topology for a running cluster. The diagram shows:
The command automatically detects the cluster architecture (interconnect vs default mode) and creates an accurate topology diagram based on real data from the OVN databases.
This command invokes the generating-ovn-topology skill which implements a data-driven architecture discovery approach:
ovn-topology-diagram.md (or timestamped/custom path if file exists)Key Features:
Skill Reference:
plugins/openshift/skills/generating-ovn-topology/SKILL.mdplugins/openshift/skills/generating-ovn-topology/scripts/./ovn-topology-diagram.md (current directory) or custom path if specifiedBasic usage (generates topology for detected cluster):
/openshift:visualize-ovn-topology
Output:
✓ Successfully generated OVN-Kubernetes topology diagram
📄 Diagram saved to: ovn-topology-diagram.md
Summary:
- 3 nodes (ovn-control-plane, ovn-worker, ovn-worker2)
- 10 logical switches, 4 logical routers
- 27 logical switch ports, 13 logical router ports
- 9 running pods
- Mode: Interconnect (distributed control plane)
💡 Open the file in your IDE to view the full rendered Mermaid diagram!
With existing file (prompts for action):
/openshift:visualize-ovn-topology
You'll be asked:
File ovn-topology-diagram.md already exists. Would you like to:
(1) Overwrite it
(2) Save to a different location
(3) Append timestamp to filename
(4) Cancel
ovn-kubernetes or openshift-ovn-kubernetes)This command performs ONLY read-only operations:
kubectl get - Query pods and nodeskubectl exec - Run read-only ovn-nbctl list commandsOperations NEVER performed:
kubectl create/delete/patch/applyovn-nbctl modificationsPermission Check: If you have cluster admin permissions, you'll receive a warning message before the command proceeds. This is for transparency - you'll be informed about your access level and asked to confirm. The command will still only perform read-only operations.
/openshift:create-cluster, the kubeconfig is automatically detected