安装

web-cli 集群插件会在 global 集群中安装一次；它不会在每个业务集群上单独安装。安装后，平台页面右上角会显示 Web CLI 入口，提供集群终端和节点终端。

该插件作为平台包分发。安装流程遵循标准的集群插件工作流：将包发布到 Marketplace，选择版本，然后开始安装。有关平台级工作流和生命周期定义，请参见 Cluster Plugin。

请使用以下任一方法。Web 控制台路径更短；YAML 方法在资源级别应用相同的工作流。

前提条件

目标 web-cli 包版本已发布到平台 Marketplace。
你可以在 global 集群中查询资源并创建 ModuleInfo。
选定的 ModuleConfig 在 global 集群中可用。

通过 Web 控制台安装

按照平台标准的 Cluster Plugin installation workflow 上传并安装 web-cli。选择已发布的插件版本，然后开始安装。安装完成后，Cluster Plugins 列表会将该插件显示为运行中。

使用 YAML 安装

第 1 步：检查可用版本

在 global 集群中，确认插件及目标版本可用：

kubectl get moduleplugins web-cli
kubectl get moduleconfigs -l cpaas.io/module-name=web-cli

检查目标 ModuleConfig，确认其集群亲和性为 global 且其 spec.config 为空。空配置表示 web-cli 可以在没有动态表单参数的情况下安装。

第 2 步：创建 ModuleInfo

在 global 集群中创建 ModuleInfo 资源。cpaas.io/cluster-name 标签用于指定 global 集群，但不会改变 YAML 的实际应用位置。

apiVersion: cluster.alauda.io/v1alpha1
kind: ModuleInfo
metadata:
  labels:
    cpaas.io/cluster-name: global
    cpaas.io/module-name: web-cli
    cpaas.io/module-type: plugin
  name: global-web-cli
spec:
  config: {}
  version: v4.2.12

选择一个在 global 集群中稳定且唯一的 metadata.name；名称在创建后无法更改，并且不会阻止同一插件以不同名称创建第二个 ModuleInfo。通过 Web 控制台安装时会生成自己的名称，因此对于给定集群应始终使用同一种方法。将 spec.version 设置为所选 ModuleConfig 中的精确版本。

验证安装

通过标签查询 ModuleInfo 资源：

kubectl get moduleinfo -l cpaas.io/module-name=web-cli

仅当状态为 Running 且目标版本与当前版本都与所选版本一致时，才继续后续操作。

安装后

Web CLI 入口将对平台用户开放。终端访问仍受各账户在所选集群或节点上的权限限制。参见快速开始。
Terminal Pod 会按需在平台系统命名空间中创建，默认是 cpaas-system，并在会话结束或超时后删除。参见 Terminal Pod。
会话和容量限制在插件包中是固定的，安装后无法更改。若要改为其他值，需要通过升级工作流使用不同的插件版本。
web-cli 是否可以卸载由所选的 ModuleConfig 控制。在计划移除之前，请检查其 spec.deleteable 字段：当其为 false 时，删除 ModuleInfo 会被拒绝，除非该对象带有 cpaas.io/force-delete: "true" 注解。

#安装

#目录

#前提条件

#通过 Web 控制台安装

#使用 YAML 安装

#第 1 步：检查可用版本

#第 2 步：创建 ModuleInfo

#验证安装

#安装后

安装

目录