Introduction
Web Terminal is the web-cli Cluster Plugin for accessing Kubernetes terminal sessions from the platform web interface. It provides a cluster terminal for running kubectl commands and a node terminal with the selected node mounted at /host. Run chroot /host before running commands that must operate on the node.
Use Cases
Use Web Terminal when you need to inspect or operate a cluster without configuring a local Kubernetes client. Use a node terminal when a platform administrator needs shell access to a specific node for node-level diagnosis.
Capabilities
- Run
kubectlcommands in a cluster terminal. - Run shell commands in a node terminal with the node root filesystem mounted at
/host. - Create terminal Pods on demand and remove idle sessions automatically.
- Limit the number of active cluster terminal Pods.
- Record terminal requests through the platform audit middleware.
Scope and Limitations
- The
web-cliplugin is installed on the global cluster. - Terminal access is subject to the identity and permissions supplied by the platform.
- Terminal sessions run in Kubernetes Pods. A session cannot start when the required Pod cannot be created or does not become ready.
- Sessions are closed after 15 minutes without activity.
- Session and capacity behavior is fixed in each plugin version.
web-clipublishes no configuration form, so these values cannot be changed after installation; moving to different values requires a different plugin version through the Upgrade workflow.