安装 Operator

术语表

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

先决条件

  1. 准备一台可以访问平台的操作机器,操作系统为 Windows、Linux 或 macOS。推荐使用 Linux,以下说明将以 Linux 为例。
  2. 确保操作机器可以访问 platform
  3. 下载 operator package,并将其保存到操作机器的工作目录。

获取上传工具

平台管理 -> 市场 -> 上传包,下载上传工具。下载后,为可执行文件设置适当的权限。

上传 Operator

无论是导入新操作符还是为现有操作符添加新版本,您都可以使用 upload tool 完成任务,命令相同。

在工作目录中执行以下命令:

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

主要参数如下:

参数定义示例
<operator-package>operator package 的名称operator.v3.18.0-beta.93.g691b79c3.tgz
<platform-address>平台的访问地址https://platform.example.com
<platform-username>平台用户名,需要具有 平台管理员 权限admin
<platform-password>平台密码********
<clusters>需要上传操作符的集群列表,如果多个集群用逗号分隔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

前往平台的 平台管理 -> 市场 -> 上传包 页面,搜索操作符关键字,然后点击操作符名称进入操作符详情页面。

详情页面将显示操作符的新版本。如果状态为 Uploaded,则表示上传成功。

下一步

上传 Operator 后,您可以前往 平台管理 -> 市场 -> 操作符中心 页面,切换到目标集群,然后部署相应的 Operator。

常见问题

在上传过程中将镜像推送到指定镜像仓库

如果您需要在上传过程中将镜像上传到指定的镜像仓库,可以使用以下三个参数:

参数定义示例
--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

如何查看 Violet 支持的所有参数

使用以下命令查看 violet push 命令的所有参数:

./violet push --help