单节点模式安装和升级
介绍如何在单节点模式下安装、升级、卸载 KSV 以及如何在集群中添加节点。
本节介绍如何在单节点模式下安装、升级、卸载 KubeSphere 虚拟化(KSV)以及如何在集群中添加节点。
KSV 目前支持以下安装模式:
- 单节点模式:安装在单个服务器节点上,适用于测试环境。
- 多节点模式:安装在多个服务器节点上,适用于生产环境。有关多节点模式,请参阅多节点模式安装和升级。
前提条件
服务器节点操作系统版本需要为 Ubuntu 18.04、Ubuntu 20.04、CentOS 7.9、CentOS 8.5 或银河麒麟 V10。其他操作系统尚未充分测试,可能存在未知问题。未来将支持更多操作系统。
检查操作系统版本:
cat /etc/issue
服务器节点的硬件配置必须满足以下条件:
硬件 最低配置 推荐配置 CPU 4 核 8 核 内存 8 GB 16 GB 系统磁盘 100 GB 100 GB 检查 CPU 核心数(两行命令回显结果相乘为服务器节点 CPU 核心总数):
cat /proc/cpuinfo | grep "physical id" | sort | uniq | wc -l
cat /proc/cpuinfo | grep "cpu cores" | uniq
检查内存大小:
cat /proc/meminfo | grep MemTotal
检查可用磁盘大小:
df -hl
服务器节点必须至少具有 1 个未格式化且未分区的磁盘,或 1 个未格式化的分区。该磁盘或分区的最低配置为 100 GB,推荐配置为 200 GB。
检查服务器节点磁盘分区:
lsblk -f
例如,以下回显表明 vdb 磁盘为满足条件的设备:
NAME FSTYPE LABEL UUID MOUNTPOINT vda └─vda1 LVM2_member >eSO50t-GkUV-YKTH-WsGq-hNJY-eKNf-3i07IB ├─ubuntu--vg-root ext4 c2366f76-6e21-4f10-a8f3-6776212e2fe4 / └─ubuntu--vg-swap_1 swap 9492a3dc-ad75-47cd-9596-678e8cf17ff9 [SWAP] vdb
服务器节点需要支持虚拟化。如果服务器节点不支持虚拟化,KSV 将以模拟模式运行。该模式将占用更多资源,且可能影响性能。
检查服务器节点是否支持虚拟化(若无回显则不支持虚拟化):
grep -E '(svm|vmx)' /proc/cpuinfo
安装 KSV
以
root
用户登录服务器节点。执行以下命令检查节点服务器的架构:
uname -m
根据节点服务器的架构类型下载安装包。
x86 架构
执行以下命令下载安装包(安装包大小约 3.7 GB):
common:Cover Text
执行以下命令解压安装包:
tar -zxvf kubesphere-virtualization-amd64-v1.4.0.tar.gz
执行以下命令进入安装包解压后生成的目录:
cd kubesphere-virtualization-amd64
ARM64 架构
执行以下命令下载安装包(安装包大小约 3.7 GB):
common:Cover Text
执行以下命令解压安装包:
tar -zxvf kubesphere-virtualization-arm64-v1.4.0.tar.gz
执行以下命令进入安装包解压后生成的目录:
cd kubesphere-virtualization-arm64
执行以下命令开始安装:
./install.sh -a --ratio <超卖比>
common:NOTE
--ratio
参数为可选参数,用于指定 KSV 集群的超卖比,取值为 1 至 4 的整数。如果未设置--ratio
参数,超卖比默认值为2
。- 超卖比将决定 KSV 可创建虚拟机的总数。可创建虚拟机的总数 = 集群 CPU 核心总数 x 超卖比。
- 只有新安装 KSV 时可以设置超卖比,升级 KSV 时不支持修改超卖比。
- 安装可能需要较长时间,请等待安装完成。
如果显示如下信息则安装成功:
##################################################### ### Welcome to KubeSphere Virtualization! ### ##################################################### Console: http://172.16.0.59:30880 Username: admin Password: P@88w0rd NOTE: Please change the default password of the admin user after login. ##################################################### https://kubesphere.cloud/ksv/ 2021-04-29 14:03:45 #####################################################
从安装成功回显中的
Console
、Username
和Password
参数分别获取 KSV Web 控制台的地址、系统管理员用户名和系统管理员密码。common:NOTE
KSV Web 控制台提供以下默认用户:
- 系统管理员:用户名
admin
,密码P@88w0rd
。 default
项目管理员:用户名project-default-admin
,密码123456
。default
项目操作员:用户名project-default-operator
,密码123456
。
- 系统管理员:用户名
(可选)安装结束后,执行以下命令查看安装日志:
ksv logs
添加节点
使用 KSV Web 控制台添加节点
以系统
admin
用户登录 KSV Web 控制台。在页面顶部的菜单栏中点击节点以打开节点列表页。
在节点列表页面点击添加。在添加节点页面,为即将添加的节点设置以下参数:
参数 描述 名称 用户自定义的节点名称。名称只能包含小写字母、数字和连字符(-),必须以小写字母或数字开头和结尾,最长 16 个字符。如果同时添加多个节点,系统将自动在不同节点的名称后增加序列号。 内部 IP 地址 集群内各节点可访问的内部 IP 地址。您需要手动输入每个节点的 IP 地址。在内部 IP 地址右侧点击 /
可增加/减少待添加的节点的数量。
数量 需要添加的节点的数量。目前支持同时添加最多 50 个节点。 SSH 认证方式 节点的 SSH 认证方式。 - 用户名和密码:使用用户名和密码登录服务器节点。
- SSH 密钥:使用 SSH 密钥登录服务器节点。
端口 用于 SSH 登录节点的端口号。 common:NOTE
添加多个节点并选择使用 SSH 密钥登录时,您需要预先为所有待添加的节点设置相同的 SSH 密钥。
点击确定。节点添加完成后将显示在节点列表中。
common:NOTE
在页面右下角的 KSV 助手中,点击操作进度并选择节点可查看待添加的节点的进度。
如需在环境满足要求后开启高可用,您需要以
root
用户登录服务器节点,进入安装包解压后生成的目录,并执行以下命令:ksv set-ceph-ha
如果显示如下信息则高可用开启成功:
set pool 2 size to 3
common:NOTE
- 目前,KSV 只支持添加节点,不支持删除节点。
- 单节点模式下,KSV 支持使用控制台添加最多 2 个节点。如需使用控制台添加更多节点,则需要购买商业版许可证。有关更多信息,请参阅软件许可证。
使用终端添加节点
以
root
用户登录服务器节点。进入安装包解压后生成的目录。
执行以下命令编辑
config-sample.yaml
文件并在hosts
和roleGroups
参数下配置新增的节点信息:vi config-sample.yaml
common:NOTE
有关参数配置,请参阅多节点模式安装 KSV。
执行以下命令开始添加节点:
./add-nodes.sh
如果显示如下信息则节点添加成功:
Congratulations! Scaling cluster is successful.
如需在环境满足要求后开启高可用,您需要执行以下命令:
ksv set-ceph-ha
如果显示如下信息则高可用开启成功:
set pool 2 size to 3
升级 KSV
如果系统中已安装旧版本的 KSV,可执行以下步骤升级 KSV 版本。
执行安装 KSV 步骤 1 至步骤 4。
执行以下命令升级 KSV:
./upgrade.sh
执行以下命令开启 KSV Web 控制台添加节点功能:
ksv upload-config {old package dir}
common:NOTE
在 KSV Web 控制台添加节点是 KSV v1.1.0 版本的新增功能。如需从 KSV v1.1.0 之前的版本升级,则需要执行以上命令才能在 Web 控制台开启该功能。
升级完成后执行以下命令查看日志:
ksv logs
如果显示如下信息则升级成功:
##################################################### ### Welcome to KubeSphere Virtualization! ### ##################################################### Console: http://172.16.0.59:30880 Username: admin Password: P@88w0rd NOTE: Please change the default password of the admin user after login. ##################################################### https://kubesphere.cloud/ksv/ 2021-04-29 14:03:45 #####################################################
卸载 KSV
以
root
用户登录服务器节点。进入安装包解压后生成的目录。
执行以下命令开始卸载:
./uninstall.sh -a
如果显示如下信息则卸载成功:
INFO[14:25:16 CST] Successful.
common:NOTE
如卸载持续时间超过 15 分钟,您可以尝试重启机器再卸载 KSV。