配置 Alauda AI Platform 入口和品牌标识

从 Alauda AI 2.6 开始,Alauda AI Platform 以单集群原生应用的形式部署。全局资源(OIDC 客户端和产品入口)不再作为集群插件交付,而是通过 global-install.sh 脚本进行配置。

WARNING

如果在先前版本中安装了 Alauda AI Essentials 集群插件,则升级到 Alauda AI 2.6 或更高版本后必须将其卸载。在 Administrator 视图中,依次进入 Marketplace / Cluster Plugin,选择 global 集群,找到 Alauda AI Essentials,然后点击 Uninstall。

该脚本会在 global 集群上创建以下资源:

  • OAuth2Client:通过平台 Dex 身份提供商为 Alauda AI Platform 启用 SSO 身份验证。
  • Secret:存储 OIDC 客户端凭据。
  • ProductEntry:在平台控制台中将 Alauda AI Platform 注册为产品入口,使其显示在左侧导航菜单中。

前提条件

  • 已安装 kubectl,并配置为可访问 global 集群。
  • global 集群上存在 productbase.product.alauda.io/base 资源(脚本会从中读取平台 URL 和版本)。

操作步骤

下载脚本

下载 global-install.sh 脚本。

运行脚本

运行脚本,并将目标集群名称作为参数传入:

bash global-install.sh \
    <cluster-name>
  1. <cluster-name> 是安装(或将要安装)Alauda AI Platform 的集群名称。

脚本会从 global 集群上的 productbase.product.alauda.io/base 读取平台 URL 和版本,然后创建所需的 OIDC 和产品入口资源。如果已存在同名的 OAuth2Client,则会安全地跳过。

重要说明

OIDC 配置:global 集群上的 OAuth2Client 资源与目标集群中的 AmlCluster 必须使用相同的 OIDC 客户端凭据。OAuth2Client 在 cpaas-system 命名空间下的名称为 aml。其 secret(或 secretRef)必须与 kubeflow 命名空间下、由 AmlCluster spec.oidc.clientSecretName 引用的 Secret 中的 data.client-secret 保持一致。如果需要自定义,请同时更新两端。OAuth2Client 创建后,脚本会跳过该资源;后续更改应直接修改该资源。

多个 Alauda AI Platform 安装实例:ProductEntry 资源的名称为 aml-<cluster-name>。如果在不同集群中部署了多个 Alauda AI Platform 实例,每个实例都会有一个显示名称相同(“Alauda AI Platform”)的独立 ProductEntry。若要在平台控制台导航菜单中区分它们,请编辑相应 ProductEntry 的 spec.displayName 字段。例如:

kubectl patch productentry aml-<cluster-name> --type=merge -p '{"spec":{"displayName":{"en":"Alauda AI (Prod)","zh":"Alauda AI (Prod)"}}}'

产品内品牌标识:此设置应用于安装 Alauda AI Platform 的集群,而不是上述资源所在的 global 集群。运行命令前,请将 kubectl 上下文切换到安装 Alauda AI Platform 的集群。若要自定义 Alauda AI Platform 内显示的产品名称、徽标和浏览器 favicon,请更新 kubeflow 命名空间中的 ui-config ConfigMap。将 data.override 设置为 "true",然后配置 data.productName、data.logo 和 data.favicon。logo 和 favicon 的值必须是完整的数据 URI 值,例如 data:image/svg+xml;base64,<base64-encoded-svg> 或 data:image/png;base64,<base64-encoded-png>。

kubectl patch configmap ui-config -n kubeflow --type=merge -p '{
  "data": {
    "override": "true",
    "productName": "My AI Platform",
    "logo": "data:image/svg+xml;base64,<base64-encoded-logo>",
    "favicon": "data:image/svg+xml;base64,<base64-encoded-favicon>"
  }
}'

验证

运行脚本后,确认资源已创建:

# Check the OAuth2Client
kubectl get oauth2client -n cpaas-system

# Check the ProductEntry
kubectl get productentry

稍等片刻后,平台控制台左侧导航菜单中应会显示 Alauda AI Platform 入口。