通过后台（命令行）扩容业务集群 ​

集群扩容是指在已有业务集群的基础上，向集群中新增工作节点（Worker Node），以提升集群的计算资源和调度能力。通过命令行操作Kubernetes自定义资源（CR），用户可以在后台完成业务集群的扩容操作。

前提条件 ​

• 待扩容的业务集群状态为“健康”。
• 需在创建该集群时使用的引导节点或管理集群上进行扩容操作。
• 已准备好待加入集群的新节点，且节点满足以下要求：
  • 节点可以连通管理集群网络。
  • 节点可以使用root用户通过SSH登录。
  • 节点为裸机操作系统，未安装任何docker与Kubernetes组件。
  • 节点的IP地址未被任何已有集群使用。
  • 节点的时间与管理集群时间差不超过10秒。

须知：

• 集群处于非健康状态时进行扩容操作可能会出现错误。请在集群状态为“健康”时进行操作。
• 集群扩容操作必须在创建该集群时使用的引导节点或管理集群上进行，否则无法管理目标集群。

使用限制 ​

• 扩容时仅支持添加工作节点（Worker Node）。通过Webhook校验，已有集群中不允许新增Master节点（创建BKENode资源时role包含master会被拒绝）。
• 待加入节点的IP地址必须在所有集群中唯一，否则BKENode创建时会被Webhook校验拦截。
• 节点的role创建后不可更改，不支持将工作节点变更为Master节点。
• 当前仅支持IPv4地址的节点。

操作步骤 ​

1. 查看集群信息 ​

确认待扩容集群的名称和命名空间，并查看当前集群的节点信息。

# 查看所有BKECluster资源，确认集群名称和命名空间（namespace与集群名称通常一致）
kubectl get bkecluster -A

# 查看集群当前的BKENode资源
# 将<bke-cluster>替换为实际的集群命名空间
kubectl get bn -n bke-cluster

2. 编写节点配置文件 ​

创建新节点的BKENode资源配置文件（如newNode.yaml）。

apiVersion: bke.bocloud.com/v1beta1
kind: BKENode
metadata:
  name: bke-cluster-n1          # 节点名称，需在集群内唯一
  namespace: bke-cluster         # 集群命名空间，与BKECluster的namespace一致
  labels:
    cluster.x-k8s.io/cluster-name: bke-cluster   # 关联集群名称，与BKECluster的name一致
spec:
  hostname: n1                   # 节点hostname
  ip: 192.168.200.101            # 修改为实际节点IP
  password: '<密码>'          # 修改为实际节点密码，Webhook会自动AES加密
  port: "22"                     # SSH端口，默认为22
  role:
  - node                         # 扩容时role必须为node（工作节点）
  username: root                 # SSH用户名，默认为root

表 1 BKENode配置参数说明

说明：

• 如果需要一次扩容多个节点，可以在同一个YAML文件中使用---分隔多个BKENode资源定义，或者分别创建多个配置文件。
• metadata.labels中的cluster.x-k8s.io/cluster-name值必须与BKECluster的metadata.name一致，且metadata.namespace必须与BKECluster的metadata.namespace一致，否则节点无法被正确关联到目标集群。

3. 创建BKENode资源 ​

执行以下命令创建BKENode资源，触发扩容流程。

kubectl apply -f newNode.yaml

如果一次扩容多个节点，可将多个节点配置写入同一文件：

kubectl apply -f newNodes.yaml

4. 查看扩容进度 ​

创建BKENode资源后，cluster-api-provider-bke控制器会自动开始扩容流程。可通过以下命令查看扩容进度。

# 查看BKENode资源状态，State字段显示节点状态
kubectl get bn -n bke-cluster

# 查看BKECluster状态，ClusterStatus字段显示集群状态
kubectl get bkecluster -n bke-cluster

# 查看节点详情，关注State和Message字段
kubectl describe bn bke-cluster-n1 -n bke-cluster

扩容过程中，节点状态（State）变化如下：

集群状态（ClusterStatus）变化如下：

说明：

• 扩容过程是异步的，创建BKENode资源后命令会立即返回，扩容操作在后台异步执行。
• 扩容过程中，集群状态会在Initializing（安装中）和ScalingWorkerNodesUp（扩容中）之间切换，属于正常现象。
• 扩容过程中可以通过kubectl describe bkecluster <集群名称> -n <命名空间>查看事件（Events）了解详细进度。
• 扩容时间视节点网络情况和环境配置而定，通常每个节点需要3~10分钟。

5. 验证扩容结果 ​

扩容完成后，在目标业务集群中验证新节点是否已成功加入。

# 查看管理集群（引导节点）中BKENode资源，确认节点已在列表中
kubectl get bn -n bke-cluster

# 查看业务集群节点列表
kubectl get nodes

新增节点的状态应为Ready，表示扩容成功。

须知： 如果节点状态长时间停留在Initializing或BootStrapping，或集群状态显示为WorkerScalingUpFailed，请参考集群部署问题定位指导排查原因。常见问题包括节点网络不通、SSH密码错误、时间不同步等。

后续操作 ​

完成集群扩容后，如需对集群进行缩容操作，请参见通过后台（命令行）缩容业务集群。