Alauda Container Platform
  • 简体中文

    • 安装和访问新的 Web Console

    目录

    简介框架插件前提条件安装概览步骤 1：下载插件包步骤 2：将插件包上传到平台步骤 3：在 global 集群上安装 Web Console Base步骤 4：安装 Web Console Collector访问新的 Web Console安装已迁移的功能插件卸载新的 Web Console

    简介

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

    在本版本中，新 Web Console 处于 Preview 阶段。到目前为止，只有一小部分功能插件已迁移；对于任何具体功能，请参阅该插件各自的文档。

    框架插件

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

    插件（Marketplace 显示名称）安装位置角色
    Alauda Container Platform Web Console Base仅 global 集群承载新的 Web Console 前端和跨集群聚合后端。集群亲和性将此插件限制在 global 集群中。
    Alauda Container Platform Web Console Collectorglobal 集群，以及其插件 UI 需要显示在新 Web Console 中的每个业务集群向 Web Console Base 公开集群本地插件资源以供聚合。其插件 UI 需要在新 Web Console 中可见的集群，必须运行此插件。

    为了让现有 Web Console 中出现 Preview Next-Gen Console 入口，也必须在 global 集群上安装 Web Console Base 插件。

    为什么要在 global 集群上安装 Collector

    global 集群也托管用户安装的插件。若要将这些插件公开到新的 Web Console，除了安装 Web Console Base 之外，还必须在 global 上安装 Web Console Collector。

    前提条件

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

    • 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，并切换到 管理员 视图。
    2. 导航到 Marketplace > Cluster Plugins。
    3. 确认列表中包含 Alauda Container Platform Web Console Base 和 Alauda Container Platform Web Console Collector。

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

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

    Web Console Base 只能安装在 global 集群上。该插件声明了集群亲和性，将其限制为带有 is-global: "true" 标签的集群。

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

    步骤 4：安装 Web Console Collector

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

    对于每个目标集群：

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

    在每个其插件 UI 需要在新 Web Console 中可见的集群上安装 Web Console Collector。未安装 Web Console Collector 的业务集群，其插件 UI 将不会聚合到新的 Web Console 中。

    访问新的 Web Console

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

    1. 登录现有 Web Console。
    2. 切换到 Container Platform 视图或 管理员 视图。
    3. 在顶部导航栏中，单击 Preview Next-Gen Console。
    4. 新的 Web Console 会在单独的浏览器标签页中打开。

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

    哪些视图会显示该入口

    Preview Next-Gen Console 入口会显示在 Container Platform 视图和 管理员 视图中。任何有权访问这些视图的已登录用户都可以看到该入口。该入口不会显示在其他视图中。

    入口不显示时

    如果顶部导航栏中缺少 Preview Next-Gen Console 入口：

    • 确认 Web Console Base 已安装在 global 集群上并处于就绪状态。
    • 在插件安装完成后刷新现有 Web Console 页面。
    • 确认你当前位于 Container Platform 视图或 管理员 视图。该入口不会显示在其他视图中。

    安装已迁移的功能插件

    上面的框架插件仅提供新的 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 入口会自动消失。无需执行其他操作。

    已迁移的功能插件独立于框架插件。请按照各自文档分别卸载每个功能插件。