Kubespray 中节点管理操作指南

概述

Kubespray 作为 Kubernetes 集群部署工具，提供了完整的节点管理功能。本文将详细介绍如何使用 Kubespray 进行集群节点的添加和移除操作，帮助管理员更好地维护 Kubernetes 集群。

节点添加流程

1. 准备阶段

在添加新节点前，需要确保已经完成以下准备工作：

• 新节点已正确配置操作系统和基础环境
• 节点间网络互通性已验证
• 必要的 SSH 访问权限已配置

2. 修改库存清单

编辑 inventory 文件，在适当的分组中添加新节点的连接信息。例如：

[all]
node1 ansible_host=192.168.1.101 ip=192.168.1.101
node2 ansible_host=192.168.1.102 ip=192.168.1.102
new_node ansible_host=192.168.1.103 ip=192.168.1.103

[kube_control_plane]
node1

[etcd]
node1

[kube_node]
node2
new_node

3. 执行节点添加

使用 scale.yml 剧本添加新节点：

ansible-playbook -i inventory/hosts.yml scale.yml --limit=new_node

关键参数说明：

• --limit 参数确保操作仅针对新节点执行
• 建议首次执行时不加 limit 参数，确保全局配置正确

节点移除流程

1. 正常移除节点

对于在线节点，使用 remove-node.yml 剧本：

ansible-playbook -i inventory/hosts.yml remove-node.yml -e node=old_node

2. 异常节点处理

对于不可用节点的强制移除：

ansible-playbook -i inventory/hosts.yml remove-node.yml \
  -e node=old_node \
  -e reset_nodes=false \
  -e allow_ungraceful_removal=true

最佳实践建议

1. 变更前备份：执行节点操作前备份集群关键配置
2. 分批次操作：大规模节点变更建议分批进行
3. 验证环节：每次变更后验证集群健康状态
4. 文档记录：维护详细的变更记录

常见问题处理

1. facts 缓存问题：

   • 执行 facts.yml 刷新节点信息缓存
   • 确保所有节点信息是最新的

2. 控制平面节点操作：

   • 确保 etcd 集群保持奇数节点
   • 控制平面节点变更需格外谨慎

3. 网络插件兼容性：

   • 不同网络插件对节点变更可能有特殊要求
   • 变更后验证网络连通性

通过遵循上述流程和注意事项，管理员可以安全高效地管理 Kubespray 部署的 Kubernetes 集群节点。