ONES 在线初装
操作步骤
注意！！！
为了 ONES 能够稳定运行，开始安装之前请一定要确保您修改了内核参数。 修改内核参数
环境检测
安装之前建议先针对当前安装环境进行环境检测
以 root 用户操作
请在 root 用户且有写入权限的目录下执行操作
sudo su -
安装 ONES 系统
以下命令须在已配置可访问外部网络的Linux主机上执行。
变量修改
在执行安装脚本之前，我们可以通过设置环境变量的方式来调整部署参数。如果没有特别需求可以跳过这一步，使用默认值即可。
可以调整的环境变量如下：
| 环境变量 | 默认值 | 说明 |
|---|---|---|
| NODE_PORT_RANGE | "30000-32767" | 指定k3s的service-node-port-range |
| ONES_PORT | "30011" | 指定ONES系统访问端口， 注意：该端口需要在 NODE_PORT_RANGE 指定的端口范围内 |
| ONES_DATA_DIR | "/data/ones" | 指定ONES系统数据存储目录 |
如果希望调整这些变量的值，比如 ONES_DATA_DIR 想调整到 /home/ones, 可以执行以下命令。
export ONES_DATA_DIR=/home/ones
# 其他环境变量也可以使用相似的方式进行修改
安装最新版本(如果想要安装指定版本，参考下方 FAQ)
curl https://packages.ones.cn/release/latest/install.sh | bash -
环境check
安装的过程中会进行环境检测，如果看到类似如下输出，代表环境检测失败。需要先进行修复然后安装
********check result********
+------------------------------+---------------------------------------+------------------+--------------------------------------------------------------------------+
| check item | situation | result | description |
+------------------------------+---------------------------------------+------------------+--------------------------------------------------------------------------+
| Swap | off | pass | |
| Port | | pass | |
| OSVersion | 7.9.2009 | pass | |
| SELinuxStatus | Disabled | pass | |
| CPU-Cores | 8 | pass | |
| TimeZone | Asia/Shanghai | pass | |
| IO | IO write=295MB/s, IO read=6.1GB/s | pass | |
| Umask | 0022 | pass | |
| Memory | 15G | pass | |
| kernel | 3.10.0-1127.19.1.el7.x86_64 | pass | |
| DataMount | mount path is / | pass | |
| DataAvailable | data disk( / ) available size is 139G | pass | |
| User-Group | Users and groups are OK | pass | |
| Transparent-Hugepage Enabled | [always] | no pass | transparent_hugepage enabled needs to be madvise, but it is [always] now |
+------------------------------+---------------------------------------+------------------+--------------------------------------------------------------------------+
****************************
********adjust command tips********
+------------------------------+--------------------------------------------------------------------------------+
| check item | fix command |
+------------------------------+--------------------------------------------------------------------------------+
| Transparent-Hugepage Enabled | echo 'madvise' | sudo tee /sys/kernel/mm/transparent_hugepage/enabled |
+------------------------------+--------------------------------------------------------------------------------+
命令行的输出中有 fix command 命令可以参考。 修复完成后再次执行上一个安装命令。
运行完成后，看到控制台如下输出代表成功:
[root@ones-cn-server-node03 ~]# sudo bash ./install_linux_amd64.sh
INFO: 2023-07-12 12:28:10| check dependencies: curl gzip pv
INFO: 2023-07-12 12:28:10| complete system dependencies
...省略
INFO: 2023-07-12 14:03:23| Please choose one of the methods to continue installing ONES.
INFO: 2023-07-12 14:03:23| 1.web page: Bootstrap information for deploying ONES:
If the server is in a private cloud, please use this internal address to access http://10.0.0.202:30011
If access fails, you can choose the internal network ip by yourself, (such as ip -br a | grep -w UP)
If the server is in the public cloud, please use this external address to access http://120.79.215.28:30011
If access fails, you can choose the external network ip by yourself, (such as curl ip.gs)
If access still fails, please contact the server administrator to troubleshoot. (For example, enable security group rules.)
INFO: 2023-07-12 14:03:23| 2.Command line: Bootstrap information for deploying ONES:
1. Initial configuration: ones-ai-k8s.sh make init-config
2. Deploy ONES: ones-ai-k8s.sh bash script/ones/deploy-ones.sh
If the deployment of ONES fails, you can use 'kubectl get po -n ones' and other commands to troubleshoot the problem and try again.
INFO: 2023-07-12 14:03:23| run complete!
INFO: 2023-07-12 14:03:23| took 108 seconds to complete.
WARN: 2023-07-12 14:03:23| You can view the boot information again by: ones-boot-info.sh
WARN: 2023-07-12 14:03:23| deployment-tool usage:
*) enter ones-ai-k8s by: ones-ai-k8s.sh
*) execute ones-ai-k8s commands directly by: ones-ai-k8s.sh <command>. For example: ones-ai-k8s.sh make config-ones
WARN: 2023-07-12 14:03:23| you can delete k3s only by: k3s-uninstall.sh
WARN: 2023-07-12 14:03:23| you can delete all by: all-uninstall.sh
打开输出中的链接可以进入web安装界面 http://xx.xx.xx.xx:30011
配置 ONES
打开命令行中的访问链接进入 web 安装界面
创建团队并设置团队名称
配置时区、语言
ONES 支持时区与语言切换，请设置初始团队区域与语言。
创建「团队负责人」
「团队负责人」是系统第一个用户，具有最高的权限。为保证你的帐号安全，请确保填写的邮箱地址能正常接收邮件。
失败警告！！！
如果当前ONES版本小于【LTS v3.14.129】，或者小于【Feature v6.0.55】
请在config/private.yaml中新增以下配置：
fluentOverlay: "only-ones-logging"
启动 ONES
完成最后一步设置后，将启动 ONES。启动过程请保持服务器与外网正常链接，启动过程将耗时 30 分钟到若干小时不等（视实际硬件与网络环境而定）。
登录 ONES
系统初始化完成后，会自动跳转到登录页面；输入初始化过程设置的「团队负责人」账号密码登录进系统。
证书激活
ONES 证书激活请参考 在线授权。
重启服务器
为了保证安装服务的稳定性，建议安装完成之后重启一下服务器。
开启数据配置
开箱默认配置未开启数据备份，数据备份请参考 k3s单机版数据备份。
邮箱配置
配置邮箱请参考 产品手册
常见问题
常见安装失败原因：
- 镜像拉取失败
- 原因：在启动 ONES 过程中会出现，有可能因为网络原因导致镜像拉取失败。
- 解决方案：检查服务器网络连通性，确保网络正常连接后重新进行安装。
- 下载失败
- 原因：在终端执行脚本时，有可能因为网络原因导致安装包下载失败。
- 解决方案：检查服务器网络连通性，确保网络正常连接后重新进行安装。
- 设置了防火墙/接口限制导致集群通信异常
- 原因：安装了防火墙程序或者设置接口限制，会影响k3s集群通信异常。
- 解决方案：检查服务器网络连通性，确保网络正常连接后重新进行安装。
- 磁盘剩余空间不足
- 原因：由于服务器磁盘存储空间不足，无法存放安装、解压所需下载内容导致安装失败。
- 示例：[环境检测过程的报错]、[安装过程磁盘空间不足报错]
- 解决方案：扩大磁盘空间
- 程序由于各种非bug问题异常退出
- 原因：程序运行过程可能由于各种非bug问题导致异常退出
- 示例：[golang堆栈][python堆栈]
- 解决方案：重试当前命令
FAQ
下载指定 ONES 版本的安装器
# 1. 列出所有可用版本
curl https://packages.ones.cn/release/ones-versions.yaml
# 2. 指定ONES版本，比如: v3.14.0， 把下面的 <ones-version> 替换为指定的版本，然后执行下面的命令进行安装
curl https://packages.ones.cn/release/<ones-version>/install.sh | bash -