Alauda Container Platform
  • 简体中文

    • 下载

    安装之前，请从 Customer Portal 中分别下载 核心软件包 和所需的 Aligned Extension 软件包。

    目录

    关于 Customer Portal下载安装软件包使用 Violet CLI 下载（推荐）从 Customer Portal 下载所需的匹配扩展选择软件包架构从单架构迁移到 hybrid

    关于 Customer Portal

    Customer Portal 是 产品资源的官方服务与交付门户。您可以使用它获取经过验证的软件包以及用于安装、升级和维护活动的官方技术指导。

    Customer Portal 提供以下资源：

    • 产品下载内容，包括安装、升级和扩展软件包。
    • 产品文档和技术指导。
    • 用于提交、跟踪和管理支持请求的支持资源。
    • 用于扩展平台功能的 Marketplace 软件包。
    • 用于部署和维护规划的许可证相关资源。

    使用授权账户下载环境所需的软件包。如果您没有注册账户，请联系技术支持。

    对于客户交付环境和生产环境，请将 Customer Portal 上发布的软件包版本和文档作为官方部署和维护基线。

    下载安装软件包

    1. 下载与目标架构匹配的 4.5 核心软件包。
    2. 下载与相同 版本和架构对应的 通用 ACP 扩展。推荐使用 Violet CLI，因为它可以直接定位并下载场景软件包。
    3. 如果在 Alauda OS 上安装 global 集群，还需下载与节点架构和提供商匹配的 Alauda OS 镜像。请参阅下载 Alauda OS。

    使用 Violet CLI 下载（推荐）

    安装 Violet v4.2.13 或更高版本，运行 violet version 验证版本，并使用 violet ac login 登录 Customer Portal。有关安装和登录说明，请参阅下载软件包。

    将 <target-platform-version> 设置为核心软件包的确切 ACP Distribution Version，例如 v4.5.0。将 <arch> 设置为 amd64、arm64 或 hybrid，使其与核心软件包匹配。先列出场景，然后下载 通用 ACP 扩展：

    violet ac scenarios --arch=<arch> --platformVersion=<target-platform-version>
violet ac download-app --arch=<arch> --platformVersion=<target-platform-version> --scenario="Common ACP Extensions"

    下载前，请确认场景列表中显示 通用 ACP 扩展。

    从 Customer Portal 下载

    您也可以不使用 Violet，而是在 Customer Portal 中转到 Marketplace > Batch Download > Install。在该页面上，从 Your ACP Version 中选择核心软件包版本，选择匹配的 Architecture，从 Scenarios 中选择 通用 ACP 扩展，然后下载软件包。

    Separate Packages

    核心软件包仅包含 Core 构件，不包含通过 通用 ACP 扩展下载的任何扩展软件包。提取核心软件包后，必须先将所需的扩展软件包手动复制到其 plugins/ 目录中，然后再启动安装程序。

    所需的匹配扩展

    将以下应用的软件包复制到已提取 Core Package 的 plugins/ 目录中：

    • Alauda Container Platform Web Console
    • Alauda Container Platform Web Console Central
    • Alauda Container Platform Marketplace Web Console
    • Alauda Container Platform Application Catalog
    • Alauda Container Platform Observability Essentials
    • Alauda Container Platform Essentials
    • Alauda Container Platform Cluster Essentials
    • Alauda Container Platform GatewayAPI Plugin

    不要将 Common ACP Extensions 中的其他软件包复制到已提取 Core Package 的 plugins/ 目录中。请按照 扩展 中的说明，在平台安装完成后安装这些扩展。在 Alauda OS 上，安装还会使用 Common ACP Extensions 下列出的 Cluster Bootstrap Provider 和基础设施 provider 软件包；安装 global 集群 会将这些软件包上传到 bootstrap 集群，而不是上传到 plugins/。

    选择软件包架构

    软件包适用于 x86、ARM 和 hybrid 架构。hybrid 软件包包含 x86 和 ARM 两种架构的镜像，因此软件包更大。请选择与您的环境最匹配的软件包，并使用与 Core Package 架构匹配的扩展软件包。

    从单架构迁移到 hybrid

    如果最初使用 x86 或 ARM Core Package 安装，但之后需要支持另一种架构，则必须重新下载 hybrid Core Package 并执行以下步骤：

    1. 将新下载的 hybrid Core Package 上传到 global 集群的任意控制平面节点。

    2. 提取软件包，并使用其中包含的 upgrade.sh 脚本将多架构镜像同步到镜像仓库：

      bash upgrade.sh --only-sync-image=true

    3. 脚本完成后，检查 cluster.platform.tkestack.io 资源，确认是否存在标签 cpaas.io/node-arch-constraint。如果存在，则必须将其删除：

      kubectl get cluster.platform.tkestack.io global -oyaml | grep cpaas.io/node-arch-constraint
# If there is output, edit the resource to remove the label; otherwise, you can skip this step.
kubectl edit cluster.platform.tkestack.io global   ### Edit the labels field and delete cpaas.io/node-arch-constraint