bkeadm配置参数 ​

常见配置场景速查 ​

表1 常见配置场景速查表

bkeadm ​

bkeadm命令总览 ​

表2 bkeadm命令总览配置表

bke init配置项 ​

表3 bke init配置项表

说明： --yumRepoPort对应的本地系统包源服务在不同配置位置名称不同，实际为同一个服务（默认端口40080）：

配置位置	名称
bke init CLI	--yumRepoPort
Cluster CRD	spec.clusterConfig.cluster.httpRepo.port
文档表述	“HTTP 仓”/“http repo”/“系统包源”

其中“yum”指消费侧（该服务同时作为节点的yum/apt系统包源），“http”指传输侧（当前以http协议提供文件分发）；离线部署时--otherSource指向的正是该服务。

端口关系与冲突检查：--imageRepoPort、--chartRepoPort、--yumRepoPort分别用于本地镜像仓库、chart repo、yum/http repo，是三个独立服务端口。自定义任一端口时，需要避开另外两个端口，以及--kubernetesPort、--consolePort和宿主机上已被其他进程占用的端口。当前初始化预检会检查端口是否已被宿主机占用，并会过滤已存在的BKE管理容器端口；但不会显式检查这几个参数之间是否填写成相同端口。如果配置重复，预检可能通过，后续服务启动或端口发布时会失败，需要根据启动日志中的端口占用信息调整为不同端口后重试。

bke cluster配置项 ​

表4 bke cluster配置项表

bke build与构建YAML配置 ​

表5 bke build与构建YAML配置项表

bke registry配置项 ​

表6 bke registry配置项表

举例:

同步单个镜像 ​

   bke registry sync --source docker.io/library/busybox:1.35 --target 192.168.200.240:40443/library/busybox:1.35 --multi-arch

成功判断：回显中出现Sync image docker.io/library/busybox:1.35 to 192.168.200.240:40443/library/busybox:1.35 success，表示源镜像已经复制到目标仓库；如果源镜像是多架构镜像，也可能先看到按架构镜像同步、再创建manifest的过程日志。

异常处理：回显中出现Sync image ... failed、by registry failed或证书、网络、认证相关错误时，优先检查源/目标仓库地址是否可访问、镜像tag是否存在、仓库凭据是否正确；生产环境还应确认是否需要显式增加--src-tls-verify=true、--dest-tls-verify=true，以及目标仓库证书链是否可信。

同步多个镜像 ​

   cat > image-list.txt <<'EOF'
   busybox:1.28
   alpine:3.14
   EOF

   bke registry sync --source docker.io/library -f image-list.txt --target 192.168.200.240:40443/library

成功判断：回显中会按镜像输出同步日志，并在最后输出Image list sync completed: total=2, success=2, failed=0。其中total表示文件中的镜像数量，success表示成功同步数量，failed=0表示没有失败项。

异常处理：如果failed大于0，说明列表中至少有镜像同步失败；回显中会同时出现对应镜像的Sync image ... failed。需要根据失败镜像逐项检查image-list.txt中的name:tag是否正确、源仓库是否存在该tag、目标仓库是否有写入权限，以及网络、TLS、认证配置是否满足要求。

查看当前镜像仓库的镜像列表 ​

   bke registry view 192.168.200.240:40443 --prefix kubernetes --tags 3

成功判断：回显会以表格展示镜像信息，表头包含IMAGE、TAGS、ARCHITECTURE、CREATE TIME、SIZE。能看到符合--prefix kubernetes的镜像名称、tag、架构、创建时间和大小，表示仓库访问和manifest解析成功。

异常处理：如果回显为no repositories found，表示仓库可访问但没有可展示的镜像；如果出现View repositories ... failed、get tags failed、unmarshal tags failed或view failed，需要检查仓库地址是否可访问、仓库是否支持Docker Registry V2 API、--prefix是否过滤掉了目标镜像，以及认证、网络配置是否正确。

说明：
查看本地自签镜像仓时不要手写 https://（如 https://127.0.0.1:40443），否则会走系统证书校验并可能报证书未认证。推荐不写协议，直接使用 127.0.0.1:40443：工具会自动补 https:// 并跳过证书校验。--export 会按架构导出为 {架构}_image-list.txt，不能指定自定义文件名。更多命令说明见命令参考。

仓库级同步 ​

   bke registry sync  --source 192.168.200.240:40443  --target 192.168.200.245:40443  --sync-repo

成功判断：回显中会先输出逐个镜像的同步过程，最后输出Repo sync completed: total=<数量>, success=<数量>, failed=0和Sync repo 192.168.200.240:40443 to 192.168.200.245:40443 success。其中failed=0表示本次仓库级同步没有失败镜像。

异常处理：如果仓库目录读取失败，会出现Failed to get repo catalog、Failed to unmarshal repo catalog或No repositories found；如果部分镜像同步失败，会出现Failed to sync image ...，并在汇总中体现失败数量。此时先确认源仓库/v2/_catalog可访问，再按失败镜像检查tag、架构镜像后缀、目标仓库写权限、仓库容量、网络连通性和TLS/认证配置。

bke start配置项 ​

表7 bke start配置项表

bke reset配置项 ​

表8 bke reset配置项表