版本：v25.09

命令参考

本文档是Cluster-API安装部署的命令参考内容。

构建安装部署包

命令
```
bke build 
```
命令功能

构建安装部署包，收集二进制文件、rpm包、chart包等进行部署包的构建。

命令格式

根据yaml构建部署包。

bke build -f <yaml file path, eg: offline-artifacts.yaml> -t <target file path, eg: bke.tar.gz>

查看命令帮助。
```
bke build -h
```

参数说明

参数名称	描述
`-f`, `--file`	指定配置文件路径。
`-h`, `--help`	显示命令帮助信息。
`-s`, `--strategy`	设置镜像同步策略（registry/docker，默认registry）。
`-t`, `--target`	指定打包BKE文件输出路径。

执行用户

该命令是由root用户执行。
使用前提

已安装好bkeadm。
注意事项

无

初始化引导节点

命令
```
bke init
```
命令功能

初始化引导节点，包括节点检查、仓库启动、集群安装等操作。

命令格式

初始化引导节点。
```
bke init
```

初始化引导节点并部署管理集群。

bke init --file <cluster configuration file path, eg: /root/openfuyao/bkecluster.yaml>

指定镜像源安装。

bke init --otherRepo <other repo, eg: cr.openfuyao.cn/openfuyao/bke-online-installed:v25.09>

自定义镜像源和软件源。

bke init --otherRepo <other repo, eg: cr.openfuyao.cn/openfuyao/bke-online-installed:v25.09> --otherSource <other source, eg: https://192.168.1.120:40080>

查看命令帮助。
```
bke init -h
```

参数说明

参数名称	描述
`-f`, `--file`	指定`bkecluster.yaml`配置文件路径（必填）。
`-h`, `--help`	显示命令帮助信息。
`--chartRepoPort`	设置Helm Chart仓库端口（默认：`38080`）。
`--clusterAPI`	指定`cluster-api-bke`版本（默认：`v25.03`）。
`--confirm`	跳过确认提示，直接执行。
`--hostIP`	指定本地Kubernetes API Server的IP地址（必填）。
`--kubernetesPort`	设置本地Kubernetes API端口（默认：`36443`）。
`--ntpServer`	配置NTP服务器（默认：`cn.pool.ntp.org:123`，`local`表示使用本地服务）。
`--otherRepo`	指定镜像仓库地址（如Helm Chart、容器镜像等）。
`--otherSource`	自定义系统软件包安装的私有源地址。
`--runtime`	选择容器运行时（`docker`或`containerd`，默认：`containerd`）。
`-s`, `--runtimeStorage`	设置容器运行时存储目录（默认：`/var/lib/docker`或`/var/lib/containerd`）。
`--yumRepoPort`	设置YUM仓库端口（默认:`40080`）。

执行用户

该命令是由root用户执行。
使用前提
1. 已安装bkeadm。
2. 已准备好集群配置文件。
注意事项

无。

集群安装

命令
```
bke cluster
```
命令功能

集群的生命周期管理。

命令格式

集群的安装部署。

bke cluster create -f <cluster configuration file path, eg: /root/openfuyao/master.yaml>

查看命令帮助。
```
bke cluster -h
```

参数说明

参数名称描述
-h，--help 命令帮助。
执行用户

该命令是由root用户执行。
使用前提
1. 已安装bkeadm。
2. 已准备好集群配置文件。
注意事项

无。

参数名称	描述
`-h`，`--help`	命令帮助。

集群卸载

命令
```
bke reset
```
命令功能

清理引导节点服务并将节点恢复至裸机状态。
命令格式
1. 删除本地kubernetes服务。
```
bke reset
```
2. 清除引导节点及挂载目录。
```
bke reset --mount
```
3. 清空节点容器及运行时环境。
```
bke reset --all
```
4. 清除节点服务并跳过删除确认。
```
bke reset --all --confirm
```
5. 查看命令帮助。
```
bke reset -h
```
参数说明

参数名称描述
--all 恢复节点。
--confirm 跳过所有删除确认。
-h, --help 显示重置命令帮助信息。
--mount 移除解压目录和相关服务。
执行用户

该命令是由root用户执行。
使用前提
1. 已安装bkeadm。
2. 已准备好集群。
注意事项

无。

参数名称	描述
`--all`	恢复节点。
`--confirm`	跳过所有删除确认。
`-h`, `--help`	显示重置命令帮助信息。
`--mount`	移除解压目录和相关服务。

构建安装部署包​

初始化引导节点​

集群安装​

集群卸载​

构建安装部署包

初始化引导节点

集群安装

集群卸载