Ocboot 快速安装

使用 ocboot 部署工具以 All in One 的方式部署 Cloudpods CMP 多云管理版本。

前提

注意

本章内容是通过部署工具快速搭建 Cloudpods 服务，如果想在生产环境部署高可用集群请参考: 高可用安装 。

环境准备

机器配置要求

操作系统:

根据 CPU 架构不同，支持的发行版也不一样，目前支持的发行版情况如下：

注：3.11、3.10等，表示发行版 Release/3.11、Release/3.10。其余同理。

	3.11	3.10	3.9	3.8	3.7	3.6
CentOS 7 2009 x86_64+aarch64	✅	✅	✅	✅	✅	✅
OpenEuler 22.03 LTS Sp3 x86_64+aarch64	✅	✅
Debian 10 x86_64+aarch64	✅	✅
Debian 11 x86_64+aarch64	✅	✅
Ubuntu 22.04 x86_64+aarch64	✅	✅
CentOS Stream8 x86_64	✅	✅
Rocky Linux 8.9 x86_64	✅	✅
OpencloudOS 8.8 x86_64	✅	✅
AlmaLinux 8.9 x86_64	✅	✅
AnolisOS 8.8 x86_64	✅	✅

注意事项：

• 操作系统需要是干净的版本，因为部署工具会重头搭建指定版本的 kubernetes 集群，所以确保系统没有安装 kubernetes, docker 等容器管理工具，否则会出现冲突导致安装异常。
• 最低配置要求: CPU 8核, 内存 8GiB, 存储 200GiB。
• 虚拟机和服务使用的存储路径都在 /opt 目录下，所以理想环境下建议单独给 /opt 目录设置挂载点。
  • 比如把 /dev/sdb1 单独分区做 ext4 然后通过 /etc/fstab 挂载到 /opt 目录。
• 在Debian家族的操作系统上（例如 Debian 和 Ubuntu）首次部署 ocboot 的过程中，会检测并更新 GRUB 启动选项，以便 k8s 能够正常运行，因此部署过程操作系统会重启。重启之后，请重新执行ocboot的部署即可。

安装 ansible 和 git

首先需要安装ansible和git，ansible版本要求：2.11.12 ~ 9.0.0。

CentOS 7

# 本地安装 ansible 和 git
$ yum install -y epel-release git python3-pip
$ python3 -m pip install --upgrade pip setuptools wheel
# 注意：请保留下面命令里的引号
$ python3 -m pip install 'ansible<=9.0.0'

Debian 10/11

如果提示locale相关的报错，请先执行：

if ! grep -q '^en_US.UTF-8' /etc/locale.gen; then
    echo 'en_US.UTF-8 UTF-8' >> /etc/locale.gen
    locale-gen
    echo 'LANG="en_US.UTF-8"' >> /etc/default/locale
    source /etc/default/locale
fi

# 本地安装 ansible 和 git
$ apt install -y git python3-pip
$ python3 -m pip install --upgrade pip setuptools wheel
# 注意：请保留下面命令里的引号
$ python3 -m pip install 'ansible<=9.0.0'

备注：已知在debian 11环境，如果/proc/cmdline里找不到启动选项 systemd.unified_cgroup_hierarchy=0，ocboot会自动配置相关的GRUB选项，重建启动参数，并重启操作系统，以便 k8s 能够正常启动。

Kylin V10

# 本地安装 ansible 和 git
$ yum install -y git python3-pip
$ python3 -m pip install --upgrade pip setuptools wheel
# 注意：请保留下面命令里的引号
$ python3 -m pip install 'ansible<=9.0.0'

其它操作系统

# 本地安装 ansible
$ python3 -m pip install --upgrade pip setuptools wheel
# 注意：请保留下面命令里的引号
$ python3 -m pip install 'ansible<=9.0.0'

安装 Cloudpods

部署的工具在 https://github.com/yunionio/ocboot，需要把该工具使用 git clone 下来，然后运行 run.py 脚本部署服务。操作步骤如下:

# 下载 ocboot 工具到本地
$ git clone -b release/3.11 https://github.com/yunionio/ocboot && cd ./ocboot

接下来执行 run.py 部署服务。其中 host_ip 为部署节点的 IP 地址，该参数为可选项。如果不指定则选择默认路由出去的那张网卡部署服务。如果你的节点有多张网卡，可以通过指定 host_ip 选择对应网卡监听服务。

中国大陆

# 直接部署，会从 registry.cn-beijing.aliyuncs.com 拉取容器镜像
$ ./run.py cmp <host_ip>

# 如果遇到 pip 安装包下载过慢的问题，可以用 -m 参数指定 pip 源
# 比如下面使用: https://mirrors.aliyun.com/pypi/simple/ 源
$ ./run.py -m https://mirrors.aliyun.com/pypi/simple/ cmp <host_ip>

其他地区

对于某些网络环境，如果出现 registry.cn-beijing.aliyuncs.com 访问缓慢或不可达，可指定镜像源: docker.io/yunion 来安装，命令如下：

IMAGE_REPOSITORY=docker.io/yunion ./run.py cmp <host_ip>

./run.py 脚本会调用 ansible 部署服务，如果部署过程中遇到问题导致脚本退出，可以重复执行该脚本进行重试。

注意

如果是基于 CentOS 7 发行版部署，会因为安装内核导致一次重启。./run.py 脚本会中断，请等待操作系统重启后，重新执行一次 ./run.py 脚本，进行后续步骤的安装。

部署完成

....
# 部署完成后会有如下输出，表示运行成功
# 浏览器打开 https://10.168.26.216 ，该 ip 为之前设置 <host_ip>
# 使用 admin/admin@123 用户密码登录就能访问前端界面
Initialized successfully!
Web page: https://10.168.26.216
User: admin
Password: admin@123

然后用浏览器访问 https://10.168.26.216 ，用户名输入 admin，密码输入 admin@123 就会进入 Cloudpods 的界面。

修改 api_server 接入端

api_server 配置是整个平台的接入端地址，会影响前端 CloudShell、 虚拟机 VNC 或者 Web SSH 的连接。一般无法打开 CloudShell 或者通过前端 SSH 进入虚拟机，是因为没有正确设置 api_server 配置。

需要参考文档：修改服务 api_server 入口配置，根据自己环境的网络情况手动修改。

开始使用 Cloudpods

导入公有云或者其它私有云平台资源

Cloudpods 可以统一纳管其他云平台的资源。

在 多云管理 菜单，选择 云账号 并新建，根据自己的需求填写对应云平台的认证信息，配置完云账号后 Cloudpods 服务就会同步相应云平台的资源，同步完成后即可在前端查看。

FAQ

1. 如何重装?

执行下面的步骤进行重装:

1. 执行 kubeadm reset -f 删除 kubernetes 集群

2. 重新运行 ocboot 的 run.py 脚本

2. 创建云账号的时候没有想要管理的云平台?

请参考 隐藏功能配置 打开需要管理的云平台。

3. 其它问题？

其它问题欢迎在 Cloudpods github issues 界面提交: https://github.com/yunionio/cloudpods/issues , 我们会尽快回复。