跳到主要内容

ONES 安装

操作步骤​

  1. 环境检测与修复
  2. 下载安装包
  3. 执行安装脚本
  4. 证书激活
  5. 初始化配置
  6. 常见问题

1 环境检测与修复​

（1）针对当前安装环境进行环境检测，并修改内核参数、修改域名解析、关闭图形化界面、配置时间同步等。

（2）联系客户确保服务器的 IP 地址 与 主机名 (hostname) 已经固定。 运行过程中修改ip或hostname将会引起K3S服务异常；如需修改、单机版请先停服并参考Linux单机单独重装k3s操作，集群版请联系ONES工程师。

2 下载安装包​

先用root账号登录并进入指定目录

sudo su -
mkdir /data/pkg
cd /data/pkg

2.1 直接获取安装包​

采用如下命令直接获取已打好的安装包，<ones-version>格式类似为v6.18.0：

curl -O https://res.ones.pro/script/k3s_offinstall/`<ones-version>`/offline_pkg_`<ones-version>`.tar
curl -O https://res.ones.pro/script/k3s_offinstall/`<ones-version>`/install_linux_amd64.sh

2.2 在线生成安装包​

或者手工打出最新版本的安装包；如果想要下载指定版本安装包，参考下方 FAQ，然后把latest 替换为具体的<ones-version>

curl https://packages.ones.cn/release/latest/build_offline_pkg_linux_amd64.sh | export TMP_PORT=5001 bash -

# 如果服务器的CPU是鲲鹏、飞腾等ARM架构， 请用如下命令获取离线安装包及安装脚本
# curl https://packages.ones.cn/release/latest/build_offline_pkg_linux_arm64.sh |  export TMP_PORT=5001 bash -

打包完成后，会在当前目录下，生成 install_linux_amd64.sh 和 offline_pkg_<ones-version>.tar

3 执行安装脚本​

3.1 默认目录修改​

默认ONES系统数据存储目录为/data/ones，如需调整、可执行以下命令；否则可忽略该步骤

export ONES_DATA_DIR=/data/ones

3.2 部署安装器​

（1） 执行安装命令

OFFLINE_PKG=offline_pkg_<ones-version>.tar bash install_linux_amd64.sh

（2）安装过程中的环境监测

安装过程会再次进行环境检测，如果安装命令终止并弹出类似如下输出、代表环境检测失败

********adjust command tips********
+------------------------------+--------------------------------------------------------------------------------+
|          check item          |                                  fix command                                   |
+------------------------------+--------------------------------------------------------------------------------+
| Transparent-Hugepage Enabled | echo 'madvise' | sudo tee /sys/kernel/mm/transparent_hugepage/enabled |
+------------------------------+--------------------------------------------------------------------------------+

此时需要先进行修复，上述输出中有 fix command 命令可以参考，或者联系ONES工程师。修复完成后重新执安装命令。

（3）安装器部署成功提示

看到如下输出，表示安装器已部署成功

根据提示可知，目前支持两种安装方式"1.web page"和"2.Command line"，本文3.3节以第1种方式为例、3.4节以第2种方式为例，任选其一即可。

3.3 页面化安装 ONES​

将控制台输出的 http://<external_ip>:30011 中 external_ip 替换为你服务器的 IP 就能进入安装器页面

（1） 打开控制台中的链接进入 web 安装界面

（2） 创建团队并设置团队名称

（3） 配置时区、语言；ONES 支持时区与语言切换，请设置初始团队时区与语言。

（注意：当前页面化安装只支持时区为东八区，如果非东八区、请使用命令行安装。）

（4）创建「团队负责人」；「团队负责人」是系统第一个用户，具有最高的权限。为保证你的帐号安全，请确保填写的邮箱地址能正常接收邮件。

（5）启动 ONES；完成最后一步设置后，将启动 ONES，首次启动过程将耗时 30 分钟不等（视实际硬件而定）。

3.4 命令行安装ONES​

（1）进入安装器，执行安装命令

ones-ai-k8s.sh
make init-config

（2）配置时区、语言；ONES 支持时区与语言切换，请设置初始团队时区与语言。如果是CN区域的东八区、简体中文，直接回车即可；否则请填写具体的时区编号和相关的语言，比如下图：

（3）创建团队并设置团队名称

（4）创建「团队负责人」；「团队负责人」是系统第一个用户，具有最高的权限。为保证你的帐号安全，请确保填写的邮箱地址能正常接收邮件。

（5）上述配置完成后，如果配置的时区、语言不是默认CN区域的东八区、简体中文，需再次手工修改环境变量

vi config/env.yaml

# 新增如下2个配置
# 第1个配置请填写所在的时区，与上述第2步配置保持一致
universalDefaultTimezone: "Asia/Tokyo"     
# 第2个配置请填写语言，当前支持的languageList: "zh:简体中文,en:English,ja:日本语,zh-Hant-HK:繁体中文"，与上述第2步配置保持一致   
universalDefaultLanguage: "ja" 

# 非CN区域配置，调整如下两个配置
sed -i '/^LicenseRoot:/ s/cn/com/'  config/env.yaml
sed -i  '/^operatingRegionValue:/ s/cn/com/'   config/env.yaml

（6）启动 ONES；完成最后一步设置后，将启动 ONES，首次启动过程将耗时 30 分钟不等（视实际硬件而定）。

ones-ai-k8s.sh
bash script/ones/deploy-ones.sh

3.5 登录 ONES​

按照提示的访问方式，打开登录页面；输入初始化过程设置的「团队负责人」账号密码登录进系统。

4 证书激活​

登录进ONES系统后，请参考 离线授权 加载证书。

5 初始化配置​

在正式上线前，请参考 ONES初始化配置按需操作。

6 常见问题​

6.1 下载失败

  • 原因：在终端执行脚本时，有可能因为网络原因导致安装包下载失败。
  • 解决方案：检查服务器网络连通性，确保网络正常连接后重新进行安装。

6.2 设置了防火墙/接口限制导致集群通信异常

  • 原因：安装了防火墙程序或者设置接口限制，会影响k3s集群通信异常。
  • 解决方案：检查服务器网络连通性，确保网络正常连接后重新进行安装。

6.3 磁盘剩余空间不足

  • 原因：由于服务器磁盘存储空间不足，无法存放安装、解压所需下载内容导致安装失败。
  • 示例：[环境检测过程的报错]、[安装过程磁盘空间不足报错]
  • 解决方案：扩大磁盘空间

6.4 程序由于各种非bug问题异常退出

  • 原因：程序运行过程可能由于各种非bug问题导致异常退出
  • 示例：[golang堆栈][python堆栈]
  • 解决方案：重试当前命令或联系ONES工程师

FAQ：获取 ONES 版本信息​

# 1. 列出所有可用版本
curl https://packages.ones.cn/release/ones-versions.yaml
# 2. 下载指定ONES版本，比如: v6.18.0， 把下面的 <ones-version> 替换为指定的版本，然后执行下面的命令
curl https://packages.ones.cn/release/<ones-version>/build_offline_pkg_linux_amd64.sh | bash -