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 kubectl commands 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-cli plugin 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-cli publishes no configuration form, so these values cannot be changed after installation; moving to different values requires a different plugin version through the Upgrade workflow.