上架软件包

Alauda AI Platform 组件以平台软件包的形式交付。在安装 operator 或 Cluster Plugin 之前,请从 Customer Portal 下载软件包,然后使用 violet 打包工具将其上传到目标集群。

本页面介绍通用的软件包工作流。有关特定组件的先决条件、安装设置和自定义资源,请在上传软件包后继续查看该组件的安装页面。

下载软件包

从 Customer Portal 的 Marketplace 下载所需组件和版本的软件包:

  • 下载与 Alauda AI Platform 版本和目标架构匹配的软件包。
  • 对于从 OperatorHub 安装的组件,请使用 OLM operator bundle。
  • 对于从 Cluster Plugins 安装的组件,请使用 Cluster Plugin 软件包。
  • 将下载的软件包保存在运行 violet 的计算机上。

确切的软件包文件名和版本随相应的产品版本提供。请勿使用其他 Alauda AI Platform 版本的软件包替代。

下载 violet 工具

如果用于上传软件包的计算机上尚未提供 violet,请将其下载。

在 Web Console 中切换到 Administrator 视图:

  1. 点击 Marketplace > Upload Packages。

  2. 点击 Download Packaging and Listing Tool。

  3. 在 Execution Environment 下找到正确的操作系统和 CPU 架构。

  4. 点击 Download。

  5. 将下载的文件设置为可执行文件:

    chmod +x <path-to-violet>

上传软件包

使用以下命令将 operator 或 Cluster Plugin 软件包上传到目标集群:

violet push \
  <package> \
  --platform-address=<platform-access-address> \
  --platform-username=<platform-admin> \
  --platform-password=<platform-admin-password> \
  --clusters=<target-cluster>

将占位符替换为平台地址、平台管理员凭据、目标集群名称和本地软件包路径。软件包会上传到平台存储库,并可用于在选定集群上安装。

INFO

对于基于平台构建的 registry,无需其他 registry 参数。violet 会将软件包中包含的镜像重新定位到平台 registry,使 operator 或 Cluster Plugin 无需从其原始 registry 拉取这些镜像即可安装。

上传到外部 registry

如果目标集群使用外部私有或公共 registry,而不是基于平台构建的 registry,请提供目标 registry 及其凭据:

violet push \
  <package> \
  --platform-address=<platform-access-address> \
  --platform-username=<platform-admin> \
  --platform-password=<platform-admin-password> \
  --clusters=<target-cluster> \
  --dst-repo=<external-registry-address> \
  --username=<registry-username> \
  --password=<registry-password>

请使用目标集群能够访问并从中拉取镜像的 registry 地址。在安装组件之前,确认软件包所需的所有镜像都已在目标 registry 中可用。

上传多个软件包

你可以使用 shell 脚本上传多个软件包。设置平台变量,并将每个下载的软件包添加到 PACKAGES 数组中:

uploading-packages.sh
#!/usr/bin/env bash
set -euo pipefail

PLATFORM_ADDRESS=https://<platform-access-address>
PLATFORM_ADMIN_USER=<platform-admin>
PLATFORM_ADMIN_PASSWORD=<platform-admin-password>
CLUSTER=<target-cluster>

PACKAGES=(
  <path-to-package-1>
  <path-to-package-2>
)

VIOLET_EXTRA_ARGS=()
# Uncomment and set these values when the target cluster uses an external registry.
# VIOLET_EXTRA_ARGS+=(
#   --dst-repo=<external-registry-address>
#   --username=<registry-username>
#   --password=<registry-password>
# )

for PACKAGE in "${PACKAGES[@]}"; do
  violet push \
    "$PACKAGE" \
    --platform-address="${PLATFORM_ADDRESS}" \
    --platform-username="${PLATFORM_ADMIN_USER}" \
    --platform-password="${PLATFORM_ADMIN_PASSWORD}" \
    --clusters="${CLUSTER}" \
    "${VIOLET_EXTRA_ARGS[@]}"
done

使用以下命令运行脚本:

bash ./uploading-packages.sh
WARNING

请保护平台和 registry 密码。请勿将包含真实凭据的脚本提交到源代码管理系统,也不要将其分享给授权安装团队以外的人员。

安装已上传的组件

上传完成后,在 Web Console 中打开目标集群:

  • 对于 OLM operator,请转到 管理员 > Marketplace > OperatorHub,选择已上传的组件并安装。然后根据需要,按照组件文档创建其自定义资源。
  • 对于集群插件,请转到 管理员 > Marketplace > 集群插件,并按照平台文档安装已上传的组件。

如果未显示该组件或版本,请确认软件包已成功上传、所选集群正确,并且软件包与目标平台的架构和发行版本匹配。