下载

在安装之前,请从 customer portal 分别下载 Core Package 和所需的 Aligned Extension packages。

关于 customer portal

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

customer portal 提供以下资源:

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

请使用已授权账户下载适用于你的环境的包。如果你没有注册账户,请联系技术支持。

对于客户交付和生产环境,请使用 customer portal 上发布的包版本和文档作为官方部署和维护基线。

下载安装包

  1. 下载与目标架构匹配的 4.4 Core Package
  2. 下载与相同 版本和架构匹配的 Common ACP Extensions。推荐使用 Violet CLI,因为它可以直接定位并下载场景包。

使用 Violet CLI 下载(推荐)

安装 Violet v4.2.13 或更高版本,运行 violet version 验证版本,并使用 violet ac login 登录 customer portal。有关安装和登录说明,请参见 下载包

<target-platform-version> 设置为 Core Package 的确切 ACP Distribution Version,例如 v4.4.0。将 <arch> 设置为 amd64arm64hybrid,以匹配 Core Package。先列出场景,然后下载 Common ACP Extensions

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

在下载之前,请确认 Common ACP Extensions 已出现在场景列表中。

从 customer portal 下载

作为 Violet 的替代方案,在 customer portal 中,进入 Marketplace > Batch Download > 安装。在页面上,从 Your ACP Version 中选择 Core Package 版本,选择匹配的 Architecture,从 Scenarios 中选择 Common ACP Extensions,然后下载这些包。

独立包

Core Package 只包含 Core 制品,不包含通过 Common ACP Extensions 下载的任何 Extension packages。解压 Core Package 后,在启动安装器之前,必须手动将所需的 Extension packages 复制到其 plugins/ 目录中。

必需的 Aligned Extensions

将以下应用的包复制到已解压 Core Package 的 plugins/ 目录中:

  • Alauda Container Platform Web Console
  • Alauda Container Platform Web Console Central
  • Alauda Container Platform Marketplace Web Console
  • Alauda Container Platform Helm 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/ 目录中。请按照 扩展 在平台安装完成后安装这些 Extensions。

选择包架构

包支持 x86ARMhybrid 架构。hybrid 包同时包含 x86 和 ARM 的镜像,因此包体积更大。请选择最适合你环境的包,并使用与 Core Package 架构匹配的 Extension packages。

从单架构迁移到 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