Install Operator

术语表

术语	定义
operator package	包含镜像文件和配置文件的 tgz 压缩包
upload tool	用于解析 operator package 并导入/上传到平台的可执行文件
operation machine	用于执行安装操作的机器
working directory	存放 operator package 和 upload tool 的目录

前提条件

准备一台可以访问平台的 Windows、Linux 或 macOS 操作机器。推荐使用 Linux，以下说明以 Linux 为例。
确保操作机器可以访问 platform。
下载 operator package 并保存到操作机器的工作目录。
安装 operator 需要管理员权限。

获取 Upload Tool

在 Platform Management -> Marketplace -> Upload Packages 中下载 upload tool（violet）。下载后，为该可执行文件设置合适的权限。

上传 Operator

无论是导入新的 operator 还是为已有 operator 添加新版本，都可以使用 violet 工具完成，命令相同。

在工作目录执行以下命令：

./violet push \
    <operator-package> \
    --platform-address <platform-address> \
    --platform-username <platform-username> \
    --platform-password <platform-password> \
    --clusters <clusters>

运行 violet 工具将 operator package 上传到平台。
<operator-package>：operator package 的名称（示例：operator.4.0.1.ALL.tgz）。
<platform-address>：平台的 URL 地址（示例：https://platform.example.com）。
<platform-username>：平台用户名，需具备 Platform Administrator 权限。
<platform-password>：平台密码。
<clusters>：需要上传 operator 的集群列表，逗号分隔（示例：global,business）。

执行成功后，会输出如下信息：

INFO[0024] artifactversion <operator-name>.<operator-version> not found, create it  cluster=business type=bundle
INFO[0024] artifactversion <operator-name>.<operator-version> has been created successfully  cluster=business type=bundle

然后进入平台的 Platform Management -> Marketplace -> Upload Packages 页面，搜索 operator 关键字，点击 operator 名称进入 operator 详情页。

详情页会显示 operator 的新版本，状态为 Uploaded 表示上传成功。

后续步骤

Operator 上传完成后，可以前往 Platform Management -> Marketplace -> Operator Hub 页面，切换到目标集群，部署对应的 Operator。

故障排查

推送软件包到外部镜像仓库

如果需要将 operator package 推送到外部镜像仓库，可以使用以下参数：

参数	定义	示例
`--dst-repo`	目标镜像仓库地址	`--dst-repo registry.example.com`
`--username`	目标镜像仓库用户名	`--username admin`
`--password`	目标镜像仓库密码	`--password *******`

例如：

./violet push \
    <operator-package> \
    --platform-address <platform-address> \
    --platform-username <platform-username> \
    --platform-password <platform-password> \
    --clusters <clusters> \
    --dst-repo <dst-repo> \
    --username <username> \
    --password <password>

如果目标镜像仓库使用明文（http）协议，需要额外指定 --plain 参数，如下：

./violet push \
    ... \
    --dst-repo <dst-repo> \
    --username <username> \
    --password <password> \
    --plain

#Install Operator

#目录

#术语表

#前提条件

#获取 Upload Tool

#上传 Operator

#后续步骤

#故障排查

#推送软件包到外部镜像仓库