cluster-api-provider-bke配置参数 ​

常见配置场景速查 ​

表1 常见配置场景速查表

cluster-api-provider-bke ​

BKEControllerManager运行参数 ​

表2 BKEControllerManager command配置项表

表3 BKEControllerManager env配置项表

BKECluster CRD配置 ​

通过bke init --file/-f <BKECluster YAML>使用这些配置时，请同时参考bkeadm配置参数中bke init的flag说明。

说明：

• BKECluster（kubectl 短名 bc）描述待创建集群的版本、仓库、网络、addon、kubelet/containerd 引用等。常用命令：kubectl get bc -A、kubectl edit bc -n <命名空间> <名称>、kubectl describe bc -n <命名空间> <名称>。
• 下表「缺省值」列为 openFuyao 平台官方推荐配置（CRD 为空时由控制器/安装器填入的默认值）。自定义部署时，建议在确认业务约束后，优先沿用推荐值，仅按需覆盖仓库地址、节点网络、addon 参数等环境相关项。
• 关联资源：KubeletConfig（kct）、ContainerdConfig（cct）的字段与引用方式见本文后续章节及二进制组件自定义配置。

表4 BKECluster CRD配置项表

addons[].param ​

bkeadm默认生成的addon：

表5 bkeadm默认addon参数表

常用的addon名称和参数：

表6 常用addon参数表

spec.clusterConfig.customExtra{} ​

表7 customExtra配置项表

端口关系与冲突检查：customExtra.imageRepoPort、customExtra.chartRepoPort、customExtra.yumRepoPort通常由bke init的--imageRepoPort、--chartRepoPort、--yumRepoPort派生，分别对应本地镜像仓库、chart repo、yum/http repo三个独立服务。自定义时需要配置为不同端口，并避开Kubernetes API、console端口和宿主机已占用端口。bke init预检会检查端口是否已被宿主机占用，并过滤已存在的BKE管理容器端口；但不会显式检查这些参数之间是否重复。如果端口重复，可能在服务启动或端口发布阶段失败，需要根据日志中的端口占用信息调整后重试。

BKENode CRD ​

表8 BKENode CRD配置项表

ContainerdConfig CRD ​

表9 ContainerdConfig CRD配置项表

KubeletConfig CRD ​

表10 KubeletConfig CRD配置项表

KCT与CCT配置与引用 ​

KCT（KubeletConfig）和CCT（ContainerdConfig）是管理集群上的自定义资源，用于在节点引导阶段下发kubelet与containerd配置，无需登录节点手工编辑文件。

表11 KCT与CCT对照表

使用流程

1. 在管理集群（与BKECluster同集群）创建KCT/CCT资源，填写spec配置。
2. 在BKECluster YAML中通过引用字段指向对应资源；bke init生成的默认集群YAML已包含示例引用。
3. 执行bke create cluster后，bkeagent在节点引导阶段读取并应用配置：
   • KCT：当KubeletConfigRef非空时，bkeagent从管理集群拉取KubeletConfig，依次处理spec.files[]、spec.kubeletConfig（写入/var/lib/kubelet/config.yaml）、spec.kubeletService（生成kubelet.service）和spec.commands[]；同时自动启用变量替换（${EXPR|command|END}）。
   • CCT：当containerdConfigRef非空时，bkeagent以namespace:name形式传入InstallContainerd插件，按spec.script → spec.service → spec.main → spec.registry顺序渲染containerd配置并重启服务。

KCT/CCT配置示例（BKECluster片段）

spec:
  KubeletConfigRef:
    name: bke-kubelet
    namespace: bke-kubelet
  clusterConfig:
    cluster:
      containerdConfigRef:
        name: bke-containerd
        namespace: bke-containerd

完整字段说明、变量替换示例和YAML样例见二进制组件自定义配置。

注解 ​

可配置的注解 ​

这些注解作用于BKECluster行为

表12 可配置注解表

关于retry注解使用的场景示例：

1、在EnsureBKEAgent阶段推送Agent失败。

2、在EnsureBKEAgent阶段推送Agent成功，但是对应节点上的bkeagent启动失败。

3、对应节点上安装kubelet失败。

4、对应节点上的域名解析服务失败导致镜像拉取失败。

遇到上述场景，用户可以在手动修复后执行如下命令添加retry注解，使失败节点重新执行后续阶段。

# 注意：当retry注解的值为空值时，会重试所有节点。
kubectl annotate bc -n <集群命名空间> <集群名称>  bke.bocloud.com/retry="<失败节点ip>"

不支持配置的注解 ​

BKE内部状态、流程和运维注解（13个） ​

表13 BKE内部状态、流程和运维注解表

ClusterVersion、升级路径和ReleaseImage注解（6个） ​

这些key是升级控制器之间的协议。参数说明与协作关系见后端声明式升级指导#控制器参数与升级注解。

表14 ClusterVersion、升级路径和ReleaseImage注解表

升级完成、取消或清理时，控制器会一起移除upgrade-ready、cluster-version和upgrade-path。

Cluster API标准注解（8个） ​

这些key的语义主要由上游Cluster API定义。本仓库负责设置、删除或消费它们，因此也属于实际注解面。

表15 Cluster API标准注解表

kubeadm、Kubernetes和静态Pod注解（7个） ​

表16 kubeadm、Kubernetes和静态Pod注解表

部署清单和生成工具注解（5个） ​

表17 部署清单和生成工具注解表