openFuyao v25.09 部署实践

# 安装须知
详见连接：https://docs.openfuyao.cn/docs/Cluster_API_Installation/Before_You_Start

# 安装包完整性校验
https://docs.openfuyao.cn/docs/Cluster_API_Installation/Installation_Package_Integrity_Verification

# 环境准备
本次实践使用虚拟机作为节点进行部署配置
## 引导节点
创建一个 4c8g 512GiB 的虚拟机 vm-1318 deployment
并安装系统
DHCPv4 10.17.36.49/22

## 业务集群节点
创建一个 8c16g 512GiB 的虚拟机 vm-1319 master
并安装系统
DCHPv4 10.17.36.50/22

# 安装准备
## 在引导节点上，下载并自动化安装 BKE 工具
```bash
curl -sfL https://openfuyao.obs.cn-north-4.myhuaweicloud.com/openFuyao/bkeadm/releases/download/v25.09/download.sh | bash
```

可能会没有操作权限，使用 `sudo` 命令可以解决
```bash
curl -sfL https://openfuyao.obs.cn-north-4.myhuaweicloud.com/openFuyao/bkeadm/releases/download/v25.09/download.sh | sudo bash
```

![image](https://cdn-imagehost.xyzttt.xyz/image/2025/11/18/qhfm9i.webp)

## 初始化引导集群
该步骤会在引导节点上部署一个轻量级的 K3s 集群，集群会部署 cluster-api、provider-bke 以及 openFuyao 安装部署相关的 Pod

```bash
bke init --otherRepo cr.openfuyao.cn/openfuyao/bke-online-installed:v25.09
```

![image](https://cdn-imagehost.xyzttt.xyz/image/2025/11/18/qigwav.webp)

老问题，还是要 `sudo`
```bash
sudo bke init --otherRepo cr.openfuyao.cn/openfuyao/bke-online-installed:v25.09
```

## 查看引导集群上部署的 Pod
```bash
sudo kubectl get pod -A
```

![image](https://cdn-imagehost.xyzttt.xyz/image/2025/11/18/qkwi40.webp)

所有 Pod 状态正常后，则引导集群安装完毕，可以继续登录openFuyao引导节点的管理面进行[业务集群的安装](https://docs.openfuyao.cn/docs/Cluster_API_Installation/Service_Cluster_Installation_on_the_Management_Plane)。

# 登录引导节点的 openFuyao 管理面
## 引导节点登录
https:// 引导节点 IP 地址: 30010

**说明：**
> - 首次登录时，用户名为 admin，密码为 test@1234。首次登录后需要修改用户名和密码。
> - 引导节点的 openFuyao 管理面使用 https 协议，web 服务端口默认为 30010

![image](https://cdn-imagehost.xyzttt.xyz/image/2025/11/18/qn994b.webp)

## 新增集群
### 集群基本信息配置
![image](https://cdn-imagehost.xyzttt.xyz/image/2025/11/18/qs35n3.webp)

![image](https://cdn-imagehost.xyzttt.xyz/image/2025/11/18/qs65k7.webp)

- 单击右下角的【一键校验】
- 校验成功后，单击下方的【创建】，单击【创建】即可下发业务集群的创建任务。

![image](https://cdn-imagehost.xyzttt.xyz/image/2025/11/18/qsqi9a.webp)

日志滚动完成，集群部署失败
![image](https://cdn-imagehost.xyzttt.xyz/image/2025/11/18/qukh7u.webp)

### 无法删除集群
准备删除该集群，重新进行部署：
![image](https://cdn-imagehost.xyzttt.xyz/image/2025/11/18/r1najr.webp)

但是这里犯了一个错误，在我更仔细研读使用手册时发现：
> 目前仅支持已创建成功集群的删除，创建失败的集群需要排查后，到登录集群所在的各个节点上进行手动删除

按照手册指引继续进行以下操作：

#### 在集群的每个节点上下载并自动安装 bkeadm
因为我在业务节点已经切换成 `root` 用户了，所以直接执行以下命令即可
```bash
curl -sfL https://openfuyao.obs.cn-north-4.myhuaweicloud.com/openFuyao/bkeadm/releases/download/v25.09/download.sh | bash
```

![image](https://cdn-imagehost.xyzttt.xyz/image/2025/11/18/r69ucg.webp)

#### 执行配置初始化
```bash
bke reset --all --mount
```

#### 删除 BKE 文件
```bash
rm -rf /bke
which bke | xargs rm -rf
```

目前 `bke reset` 操作可能会有容器挂载路径残留，可以执行 `df -h` 命令查看是否存在 overlay 项。若存在，可以尝试再次执行 `bke reset` 操作，或者执行 `reboot` 命令重启机器，删除 overlay项。

执行后发现没有 overlay 项：
![image](https://cdn-imagehost.xyzttt.xyz/image/2025/11/18/r7iapb.webp)

# 第一次部署总结
后来发现，如果没有部署成功，那么上面的操作其实都没有办法正确恢复。
接着又踩了一个坑，我重启了引导节点，结果整体服务起不来，所以决定推掉之前的部署，重新开始。

操作方法：在引导节点执行以下命令：
```bash
bke reset --all --mount
```

![image](https://cdn-imagehost.xyzttt.xyz/image/2025/11/19/dues9x.webp)

# 重新开始部署
重复上面的安装步骤发现：
![image](https://cdn-imagehost.xyzttt.xyz/image/2025/11/19/f965sj.webp)

依然没起来。发现还是 `sudo` 的问题

## 进入 root 用户环境再次进行以上操作
```bash
sudo su -
```

## 引导节点安装成功

## 尝试在引导节点连接业务节点，成功

## 打开管理面继续配置集群

# 新增集群
重复上面新增集群的操作，等待
![image](https://cdn-imagehost.xyzttt.xyz/image/2025/11/19/idls49.webp)

## 新增集群成功
![image](https://cdn-imagehost.xyzttt.xyz/image/2025/11/19/ipemtl.webp)

可以登录业务集群的openFuyao管理面进行集群管理相关的操作。

浏览器中输入“https://业务集群IP地址:31616”。

**说明：**
> - 首次登录时，用户名为 admin，密码为 test@1234。首次登录后需要修改用户名和密码。
> - 业务集群的 openFuyao 管理面使用 https 协议，web 服务端口默认为 31616。

![image](https://cdn-imagehost.xyzttt.xyz/image/2025/11/19/iq4r43.webp)

# References
- claude sonnet 4.5
- [openFuyao Cluster-API 安装指导：在线安装引导集群](https://docs.openfuyao.cn/docs/Cluster_API_Installation/Online_Bootstrap_Cluster_Installation)
- [openFuyao Cluster-API 安装指导：管理面安装业务集群](https://docs.openfuyao.cn/docs/Cluster_API_Installation/Service_Cluster_Installation_on_the_Management_Plane)