#安装并访问新的 Web Console

#简介

本页面说明如何安装新 web console 所需的框架插件，以及之后如何访问新 web console。完成此流程后，现有 web console 中会出现一个名为 Preview Next-Gen Console 的入口，并会在单独的浏览器选项卡中打开新的 web console。

本次发布中，新 web console 处于 Preview 状态。到目前为止，仅迁移了少量功能插件；有关任何特定功能，请参考该插件自身的文档。

#框架插件

新的 web console 框架由两个集群插件组成。两者都必须通过 Marketplace 手动安装；它们都不会自动安装。

要让现有 web console 中出现 Preview Next-Gen Console 入口，还必须在 global 集群上安装 Web Console Base 插件。

#先决条件

开始安装之前，请确保满足以下要求：

• global 集群运行的 版本包含新的 web console Preview。
• 你可以访问 Customer Portal 以下载集群插件包，或者已通过技术支持获取插件包。
• violet 命令行工具可用。有关安装和使用说明，请参见 Violet。
• 你具有通过 Marketplace 安装集群插件的管理员权限。
• 对于每个你希望在新 web console 中暴露其插件 UI 的业务集群，该业务集群已经由 global 集群管理。

#安装概览

安装流程包含四个步骤：

1. 下载 Web Console Base 和 Web Console Collector 插件包。
2. 将两个插件包上传到平台。
3. 在 global 集群上安装 Web Console Base。
4. 在 global 集群以及每个其插件 UI 应显示在新 web console 中的业务集群上安装 Web Console Collector。

#步骤 1：下载插件包

1. 访问 Customer Portal。
2. 找到以下显示名称对应的集群插件包并下载：
   • Alauda Container Platform Web Console Base
   • Alauda Container Platform Web Console Collector
3. 如果你无法访问 Customer Portal，请联系技术支持获取这两个插件包。

有关下载插件包的一般说明，请参见 Downloading a Plugin Package。

#步骤 2：将插件包上传到平台

使用 violet 工具将下载的两个插件包发布到平台。有关上传插件包的一般说明，请参见 Uploading a Plugin Package。

上传完成后，确认这两个插件均可用：

1. 登录现有 web console，并切换到 Administrator 视图。
2. 导航到 Marketplace > Cluster Plugins。
3. 确认列表中同时存在 Alauda Container Platform Web Console Base 和 Alauda Container Platform Web Console Collector。

#步骤 3：在 global 集群上安装 Web Console Base

1. 在 Administrator 视图中，导航到 Marketplace > Cluster Plugins。
2. 找到 Alauda Container Platform Web Console Base。
3. 单击 Install，并选择 global 集群作为目标集群。
4. 等待插件进入就绪状态。

有关通用的集群插件安装流程，请参见 Cluster Plugin。

#步骤 4：安装 Web Console Collector

在每个其插件 UI 需要在新 web console 中可见的集群上安装 Web Console Collector。至少应将其安装在 global 集群上。

对于每个目标集群：

1. 在 Administrator 视图中，导航到 Marketplace > Cluster Plugins。
2. 找到 Alauda Container Platform Web Console Collector。
3. 单击 Install，并选择目标集群。
4. 等待插件进入就绪状态。
5. 对每个需要暴露其插件 UI 的其他业务集群重复上述步骤。

#访问新的 web console

在 global 集群上安装并使 Web Console Base 插件处于就绪状态后：

1. 登录现有 web console。
2. 切换到 Container Platform 视图或 Administrator 视图。
3. 在顶部导航栏中，单击 Preview Next-Gen Console。
4. 新的 web console 会在单独的浏览器选项卡中打开。

新的 web console 通过平台 URL 提供，路径为 /console-acp-new/。

#安装已迁移的功能插件

上面的框架插件只提供新的 web console 所需的导航、聚合和运行时环境。每个已迁移的功能都作为独立插件交付，必须单独安装。

要安装已迁移的功能插件：

1. 确定你要使用的功能插件，并参考该插件自身的产品文档。
2. 按照插件特定的安装说明进行操作，这些说明通常遵循 Cluster Plugin 中描述的标准集群插件安装流程。
3. 根据该插件自身文档的要求，在目标集群上安装该插件。
4. 确认在安装该功能插件的每个集群上都已安装 Web Console Collector，以便将该功能插件的 UI 聚合到新的 web console 中。

可在新 web console 中使用的已迁移功能插件集合会在各个版本中不断增加。有关当前可用性，请参阅各插件自身的文档。

#卸载新的 web console

可随时通过 Marketplace 卸载框架插件来移除新的 web console。无需额外清理。

1. 若要完全移除新的 web console：
   • 从 global 集群卸载 Web Console Base。
   • 从安装了 Web Console Collector 的每个集群中卸载该插件。
2. 若要仅从某个特定业务集群中移除新的 web console：
   • 从该业务集群卸载 Web Console Collector。该集群中的插件 UI 将不再聚合到新的 web console 中。

在从 global 集群卸载 Web Console Base 后，现有 web console 中的 Preview Next-Gen Console 入口会自动消失，无需进一步操作。

已迁移的功能插件与框架插件相互独立。请根据各自的文档分别卸载每个功能插件。