配置 Alauda AI Platform 入口和品牌标识
从 Alauda AI 2.6 开始,Alauda AI Platform 以单集群原生应用的形式部署。全局资源(OIDC 客户端和产品入口)不再作为集群插件交付,而是通过 global-install.sh 脚本进行配置。
如果在先前版本中安装了 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 脚本。
运行脚本
运行脚本,并将目标集群名称作为参数传入:
<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 字段。例如:
产品内品牌标识:此设置应用于安装 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>。
验证
运行脚本后,确认资源已创建:
稍等片刻后,平台控制台左侧导航菜单中应会显示 Alauda AI Platform 入口。