命令参考 ​

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

构建安装部署包 ​

• 命令

  shell

  bke build

• 命令功能

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

• 命令格式

  1. 根据yaml构建部署包。

     shell

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

  2. 查看命令帮助。

     shell

     bke build -h

• 参数说明

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

• 执行用户

  该命令是由root用户执行。

• 使用前提

  已安装好bkeadm。

• 注意事项

  无

初始化引导节点 ​

• 命令

  shell

  bke init

• 命令功能

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

• 命令格式

  1. 初始化引导节点。

     shell

     bke init

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

     shell

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

  3. 指定镜像源安装。

     shell

     bke init --otherRepo <other repo, eg: harbor.openfuyao.com/openfuyao/bke-online-installed:latest>

  4. 自定义镜像源和软件源。

     shell

     bke init --otherRepo <other repo, eg: harbor.openfuyao.com/openfuyao/bke-online-installed:latest> --otherSource <other source, eg: https://192.168.1.120:40080>

  5. 查看命令帮助。

     shell

     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. 已准备好集群配置文件。

• 注意事项

  无。

集群安装 ​

• 命令

  shell

  bke cluster

• 命令功能

  集群的生命周期管理。

• 命令格式

  1. 集群的安装部署。

     shell

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

  2. 查看命令帮助。

     shell

     bke cluster -h

• 参数说明

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

• 执行用户

  该命令是由root用户执行。

• 使用前提

  1. 已安装bkeadm。
  2. 已准备好集群配置文件。

• 注意事项

  无。

集群卸载 ​

• 命令

  shell

  bke reset

• 命令功能

  清理引导节点服务并将节点恢复至裸机状态。

• 命令格式

  1. 删除本地kubernetes服务。

     shell

     bke reset

  2. 清除引导节点及挂载目录。

     shell

     bke reset --mount

  3. 清空节点容器及运行时环境。

     shell

     bke reset --all

  4. 清除节点服务并跳过删除确认。

     shell

     bke reset --all --confirm

  5. 查看命令帮助。

     shell

     bke reset -h

• 参数说明

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

• 执行用户

  该命令是由root用户执行。

• 使用前提

  1. 已安装bkeadm。
  2. 已准备好集群。

• 注意事项

  无。