安装

目录

前提条件

  • ACP 版本:>= v4.2
  • AC CLI 版本:>= v1.1
  • 必须在 global 集群故障发生之前安装此集群插件。

下载与导入

  1. 登录 AlaudaCloud 并下载最新的 Alauda Container Platform Cluster Authentication 插件包。

  2. 使用 violet 将 Alauda Container Platform Cluster Authentication 插件推送到 ACP:

     violet push local-auth.amd64.v1.0.0.tgz \
     --platform-address https://<platform-address>/ \
     --platform-username <username> \
     --platform-password '<password>'

通过 Web 控制台安装

  1. 验证上传:

    • 进入 管理员 > Marketplace > 上架软件包
    • 切换到 集群插件 标签页
    • 找到已上传的插件名称
    • 插件详情将显示已上传包的版本信息
  2. 安装插件:

    • 如果插件状态显示为“ready”,点击安装

通过 CLI 安装

1. 检查可用版本

确认插件已发布,通过检查 global 集群中的 ModulePlugin 和 ModuleConfig 资源:

# kubectl get moduleplugins |grep local-auth
NAME      AGE
local-auth           5d17h

# kubectl get moduleconfigs -l cpaas.io/module-name=local-auth 
NAME                                                   AGE
local-auth    3d22h

这表明 ModulePlugin local-auth 已存在于集群中,可以安装。

2. 创建 ModuleInfo

创建 ModuleInfo 资源以安装插件。以下示例包含常用配置参数:

apiVersion: cluster.alauda.io/v1alpha1
kind: ModuleInfo
metadata:
  annotations:
    cpaas.io/display-name: local-auth
    cpaas.io/module-name: '{"en": "Alauda Container Platform Cluster Authentication", "zh": "Alauda Container Platform Cluster Authentication"}'
  labels:
    cpaas.io/cluster-name: <cluster-name>   # 目标集群名称
    cpaas.io/module-name: local-auth
    cpaas.io/module-type: plugin
    cpaas.io/product: Platform-Center
  name: local-auth-<cluster-name>           # 资源名称
spec:
  version: v1.0.0                           # 插件版本

字段说明

Metadata 字段:

  • name:集群插件的临时名称,平台会根据内容在创建后重命名,格式为 <cluster-name>-<内容哈希>,例如 global-ee98c9991ea1464aaa8054bdacbab313
  • label cpaas.io/cluster-name:指定插件安装的集群。
  • label cpaas.io/module-name:插件名称,必须与 ModulePlugin 资源匹配。
  • label cpaas.io/module-type:固定字段,必须为 plugin;缺失此字段将导致安装失败。

Spec 字段:

  • .spec.version:指定要安装的插件版本,必须与 ModuleConfig 中的 .spec.version 匹配。